Einstein Platform Users Manual
Contents
1. ther free programs whose distribut to ask for permission Software Foundation wri make exceptions for this of preserving the free s ion conditions are For software which different is copyright te to the Free Soft tatus of all write to the author ted by the Free tware Foundat tion we sometimes Our decision will be guided by the two goals derivatives of our free software and of promoting the sharing and reuse of software generally NO WARRANTY Einstein Platform User s Manual 24 11 BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE THERE IS NO WARRANTY FOR THE PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES ROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF ERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS THE QUALITY AND PERFORMANCE OF THE PROGRAM 15 WITH YOU SHOULD THE ROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVICING EPAIR OR CORRECTION T Hd Y O DoH e Of 12 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR A2. EGLIG E ENCE OUT OF T LITY OF S OR TOR USE CH DAMA E U OF THIS SOFTWAR GE T EV iE terials provided with the ures or use of AND ANY IMPLIED WA URPOSE ARE RIBUTORS BE LIABLE FOR ANY OR CONSI distribution this software Brini he author may be used to this software without specific EXPRESS OR IMPLIED RRANTIES OF DISCLAIMED DIRECT DAMAGES EQUENTIAL MENT OF SUI BSTITUTE GOODS OR OR BUSINI ESS INT ETHER I ERRUPTION O R OTHERWISE EN IF ADVISED OF THE N CONTRACT ARISING IN
3. irect ly through you third parties to judgment or allegation of patent to patent issues agreement or they do not If you cannot under this then as a consequence you if a patent t permit royalty free redistribution of the Program by then Einstein Platform User s Manual the only way you could s refrain entirely from di If any port any partic apply and circumstances tion of this section ular circumstance at st is held 23 tisfy both it and this License would be to tribution of the Program invalid or unenforceable under the balance of the section is intended to the section as a whole is intended to apply in other It is not the purpose of this section to induce you to infringe any patents or ot such claims integrity of the free so implemen ge through system to distribute soft impose that choice nerous contribut it is up This section is inte be a consequence of 8 If the distribut certain countries eit may add an explicit geog her property right this section has ted by public license praci tions to ftware dist tware through any other syst tribution syst tices the wide range of sofi that system in reliance on consistent to the aut tem which is Many peopl claims or to contest validity of any the sole purpose of protecting the have made distrib applicat ware tion of tem and a lice
4. kallisys com newton einstein and on the OpenEinstein page on Google Code http code google com p einstein Einstein Platform User s Manual 4 2 Requirements Einstein Platform currently runs on the following machines e Arm linux PDAs with X11 e Nokia Internet tablets 770 and 880 e Mac G4 G5 computers with 10 3 9 or higher e Mac Intel computers with 10 4 6 or higher e Windows computers with Cygwin and X11 Einstein Platform requires about 40 MB of storage e Einstein Platform requires an MP2x00 US an MP2x00 D or an eMate 300 ROM image Instructions about how to extract the ROM are available in the next section PLEASE DO NOT ASK ME FOR A ROM FILE I will not provide you with any NewtonOS ROM is copy right by Apple Computer Inc and licensors Einstein Platform User s Manual 5 3 Extraction of the ROM from your Newton Two methods are available via a serial line or via TCP IP i e via an Ethernet access 3 1 Hammer Newtsbug serial line Using a low level debugger such as Hammer or Newtsbug you can make a dump of the memory This is slow and works over the serial line Requirements e A computer running in Classic or MacOS lt X e Hammer or Newtsbug they can be found on UNNA http www unna org e A serial connection between your Newton and the Mac a built in serial port for computers booting in MacOS lt X ora USB to Serial port adapter compatible with Classic Steps e Ins
5. to take away your the GNU General Public to share and change free software to make sure the software is free for all its users General Public License applies to most of the Free Software This Foundation s software and to any other program whose authors commit to using it Some o the GNU Lesser Gen your programs too When we speak of price Our Genera have the freedom t this service if yo if you want it th in new free progra To protect your anyone to deny you These restrictions For example 1f gratis or for a fe You mus And you have source code rights ther Fr eral Soft Public License instead free software Licenses are designed ute copies of free software that you receive source code or Can get n Change the software or use pieces of it hat you know you can do these things 1 Public o distrib u wish at you ca ms and t rights we ar referring to freedom to make sure that You can apply i these rights or translate to cert distribute copies of the software te copies of such a program you distribu e you must give th t make sure that they too you must We protect your rights with two steps 2 distribute and or modify the sof for each a that everyone und software If the its recipient Also want that uthor s pro tware tec rstands tha software is s to
6. know t nat 1 tion and ours here is no warranty for this free modified by someone else and passed on what they have is not the original recipients all the rights receive or Can get copyright the software offer you this license which gives you legal permission to copy not and charge tware Foundation software is covered by E to you for it we need to make restrictions that forbid to ask you to surrender the rights tain responsibilities for you if you or if you modify it whether that the show them these terms so they know their and we want to make certain any problems introduced by others will we so not reflect on the original Einstein Platform User s Manual threate authors reputations Finally any free program is patents We wish to avoid the danger program will The precis modification follow T Q a notice placed by unde mean GN U GENERAL individually obtai program proprietary patent must be licensed for To prevent n paten this that redistribui in effect making the licenses we have made it 20 ned constantly by software tors of a free free use or not veryone s terms and conditions for copying This License applies r the al terms of that either verbatim or with modificat lang the Activities other than copyi
7. s is uage term Hereinafter modification t PUBLIC LICENSE ERMS AND CONDITIONS FO ranslation i License S ng covered by this License running the Program is no is covered only if its contents cons independent of having been made by running Prog ram Whether that is true depends on what 1 You may copy and distribute ve they ar outs restricted ide its scope clear that any 1 icensed at all distribution and R COPYING DISTRIBUTION AND MODIFICATION to any program or other work which contains the copyright hol this General Public refers to any such program or work ther th to say lder saying it may be distributed The Program and a work based on the Program below Program or any derivative work under copyright law a work containing the Program or a portion of it tions and or translated into another included without Each licensee is addressed as limitation in you distribution and modification are not The act of and the outpu ti t rba source code as you receive cons copy picuo right noti and alon You you may at ER of I abov ces give at refer to thi g wi may c You may modify your copy or copies of t thus forming a work based on the Program distribute such modifications or work under provided that you also meet all of t
8. the s option to dump the list of symbols Then you can process all the lines with research and replace or sed or awk at your convenience The symbols can be unmangled with Unmangle tool coming with MPW Einstein Platform User s Manual 13 6 4 Logging Quite a large amount of log lines are generated by Einstein These are used during the development of Einstein emulator It also helps to understand what s going on Starting with UP2 release you can generate log lines from NewtonScript calling the Einstein Log global function E g Einstein Log Hello World will display Hello World in the log If log is disabled the string will be output on stdout Please note that your string is converted to ISO 8859 1 before being printed so non latin characters will not be printed properly in the log Einstein Platform User s Manual 14 7 Relativity Developer Guide 7 1 Introduction Relativity is a new technology embedded into Einstein to allow packages for Einstein to take advantage of host APIs Relativity can only be used through NewtonScript for the moment To use relativity you need to call OpenNat iveLibrary NewtonScript function to open a library from the host system OpenNativeLibrary libraryName libraryName is a string representing the name of the library to open Valid names include libc or libGL This function returns a library object and throws an exception if an error occurs for example if
9. the library cannot be found libraryObject Get Funct ion functionSpecs functionSpecs is a frame describing the function to import This frame has three required slots e name the name of the function e args anarray with the types of the arguments from left to right The types are symbols see below e result the type of the result see below This function returns a NewtonScript function you can call The types can be the following e sin e sint t8 unsigned integer 8 bits 8 signed integer 8 bits t16 unsigned integer 16 bits 16 signed integer 16 bits t32 unsigned integer 32 bits t32 signed integer 32 bits t 64 unsigned integer 64 bits unimplemented yet 64 signed integer 64 bits unimplemented yet e float single precision float number unimplemented yet e double double precision float number unimplemented yet e longdouble long double precision float number unimplemented yet Einstein Platform User s Manual 15 e stringstring const charx e iostring string for output or input output charx e binary data const voids e iobinary data for output or input output voidx e pointer any pointer on data Some types are illegal for return or argument types for example you cannot use iostring for the return type use string instead Then you can call the function naturally by providing Newton data The result is returned in the form of Newton d
10. Einstein Platform User s Manual For Open Einstein 2007 7 July 9 2007 Contents 1 Introduction 2 Requirements 3 Extraction of the ROM from your Newton 3 1 Hammer Newitsbug serial line Gye ia Pde e Aca Oe eG aw ee 3 2 ROM Dumper TCP IP lt A Blase A DAA OS dea Ra u 4 Einstein on MacOS X 4 1 Using the CLI flavor on MacOS X ia e ee es SS RH HRMS Oh we 4 23 A ae Shae ae By ee Whe Bae Nae le Oe AE ets Se 5 Einstein on arm linux PDAs 5 1 Quickstart onthe Zaurus e 303 Re BOR AA RE ae ar eS 5 2 More details for other PDAs 00 00 000 ee ee De COPOS e ee ahh Gui eee E hate AAA gee TO aN cn By Be hae ES 6 Developer notes 6 1 Compiling and porting Einstein le 4222 A Ee SOE ARE ROR AA 6 2 CEDCEOMMANAS w eo Bee Bye eee a BR A eh Ba VARA Roe ee ela 6 3 Monitor mode ses feck rs A A tee Ae Gy bee Ge Sot a ae ta eT aN ete A E perder Sate Set DIR SI SEHE ate a aan 7 Relativity Developer Guide 7 1 Introducton a a ESA TA A hed A E DE Fads Sample code skera 0 8 A Bia tee Ba RAE Ree She Bd 8 Known problems 9 Changes History 10 License 10 10 10 11 12 12 12 12 13 14 14 15 17 18 19 Einstein Platform User s Manual 3 1 Introduction Einstein Platform is a way to transform a computer in a next generation Newton N2 MP2x00 eMate 300 Einstein is a project to unchain NewtonOS from existing hardware More information can be found on the Einstein Project home page http
11. NY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAMAGES INCLUDING ANY GENERAL SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Lt END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program and you want it to be of the greatest possible use to the public the best way to achieve this is to make it free software which everyone can redistribute and change under these terns To do so attach the following notices to the program It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty and each file should have at least the copyright line and a pointer to where the full notice is found lt one line to give the program s name and a brief idea of what it does gt Copyright C lt year gt lt name of author gt This program is free software you can redistribute it and or modify it
12. all if theResult 0 then Success return theBuffer else Failure return gethostname failed end 16 Einstein Platform User s Manual 17 8 Known problems Serial ports are not emulated PCMCIA cards are not emulated The sockets aren t entirely emulated yet e The sound volume is reported to be settable by software but the changes are ignored except when the sound is off on the Newton Sound input isn t emulated e Anerror occurs when trying to install system patches Keys are not translated properly except on the Mac the keyboard is useless Rotation doesn t always work well It is awfully slow on ARM PDAs Please report any problem you experienced that is not on this list on the Google Code page http code google com p einstein Einstein Platform User s Manual 18 9 Changes History 9 07 07 Einstein Platform 2007 7 e New version of the emulator module which uses less RAM and is PC agnostic e Fixed the emulation of several instructions and wrote regression tests e Compilation for Nokia OS 2006 e Experimental direct ARM to ARM translation e Now open source e Ported to Cygwin matthiasm 5 31 06 Einstein Platform 2006 6 e Features Initial release of Relativity for Einstein Accelerated some transfers between Einstein and Host Included several keyboard mappings Update of PortAudio from CVS Included a new set of icons by Michael Vac k T
13. and this permission notice shall be x included in all copies or substantial portions of the Software x Any person wishing to distribute modifications to the Software is requested to send the modifications to the original developer so that x they can be incorporated into the canonical version x THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND Einstein Platform User s Manual EXPRESS O ERCHANTA MI IN NO R IMPLI BILITY EVENT SHALL ED INCL FITNESS THE G UDING B FOR A UT NOT LIMIT PARTICULAR P AUTHORS OR COPYRIGHT ANY CLAIM DAMAGES OR OTHER LIABILITY WHET CONTRACT WITH THE SOFTWARE OR THE TORT O R OTH ERWISE ARISING F G G USE OR ROM DEALI OTH E iR Einstein Platform also includes NetBSD arm disassembler 74 El ja Ld Ed ff NetBSD Copyright Copyright 26 ED TO THE WARRANTIES OF URPOSE AND NONINFRINGEMENT HOLDERS BE LIABLE FOR HER OUT NGS IN OF IN AN ACTION OF OR IN CONNECTION THE SOFTWARE Pie disassem c v 1 14 2003 03 27 16 58 36 mycroft Exp c 19 c 96 Mark All rights reserved Redistributio modification are met de no Redistrib tice Redistrib n a utio this
14. ata Once you are done you can close the library with the Close method libraryObject Close Close the library The library object should no longer be used afterwards 7 2 Sample code In this section we will describe how to call a simple function gethostname that returns the network name of the host The manual page of gethostname provides the necessary information to call the routine GETHOSTNAME 3 BSD Library Functions Manual GETHOSTNAME 3 NAME gethostname sethostname get set name of current host LIBRARY Standard C Library libc 1c SYNOPSIS include lt unistd h gt int gethostname char name size_t namelen This page shows that gethostname is in the 1ibc library It also provides the type of the arguments and of the result The following code calls the function and returns the result begin Open the native library local libc OpenNativeLibrary libc Define the function Einstein Platform User s Manual local gethostnameFn libc GetFunction name gethostname args iostring sint32 result sint32 Allocate a buffer to store the hostname This buffer is a string of 127 unicode characters null ocal theBuffer MakeBinary string 256 Call the function local theResult call gethostnameFn with theBuffer 127 Close the library libc Close Determine the outcome of the c
15. he toolbar icons reflect the state of Einstein Fixed an endianess problem with the Cocoa screen manager on Intel machines The state is now shown on the screen instead of just screen is off Improved the Cocoa preferences panel Included AppleScript support to evaluate newton script code and to install packages e Bug fixes Fixed a bad bug in the memory emulation that caused crashes especially with the JIT page cache Fixed a bug yielding to an abort when the platform was quitted Fixed a bug with CoreAudio sound on Intel machine PortAudio sound driver now reverts samples an little endian targets The tablet region was incorrectly limited to 1023x1023 It s now set to NewtonOS size 2047x2047 1 14 06 Einstein Platform Beta e Initial release Einstein Platform User s 10 License Manual 19 Einstein Platform is copyright 2003 2007 by Paul Guyot It is available under the GNU General Public License v2 GNU GENERAL PU BLIC LICENSE Version 2 Copyright C 198 51 Franklin Stree Everyone of this license d Preamble The licenses for most software are designed June 1991 9 t ocument 1991 Free Sof Fifth Floor is permitted to copy and distribute verbatim copies but changing it is not allowed Boston tware Foundation ING MA 02110 1301 USA freedom to share and change it License is intended to guarantee your freedom By contrast
16. hese conditions t e a Yo stati b Yo whole part thereof the Program S any other recipient u must cause the modified ng that you changed the files and db u must cause any work that you dist or in part contains or is derived from the Prog to be licensed as a whole at no charge in any medium sly and appropriately publis notice and disclaimer of warranty License and to the absence of any warranty ts of the Program a copy of he Program does from tute a work based on arge a fee for the physical act of transferring a copy your option offer warranty protect the Program the the Program tim copies of the Program s provided h on each copy an keep intact that you appropriate all the this License and tion in exchange for a fee he Program or any portion and copy and the terms of Section 1 files to carry prominent notices the date of any change tribute or publish that in ram or any to all third Einstein Platform User s Manual parties under the terms of this License c If the modified program normally reads commands when run you must cause it when started running interactive use in the most ordinary way to print 21 interactively for such or display an announcement including an appropriate copyright notice and a notice that there is no warranty or else saying a warrant
17. ium does not bring the other work under the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one o f the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution a complete machine readable copy of the corresponding source code to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or c Accompany it with the information you received as to the offer to distribute corresponding source code This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer in accord with Subsection b above Einstein Platform User s Manual The source code for a work means the preferred form of the work for making modifica tions to it For an executable work complete source code means all the source code for all modules it c
18. ks based on it the Progra Gr Program Each origi this Licen He TES se exercise of ense ks Program Any attempt te the Program is and will automatically terminate your rights under this License from you under as such since you have not nothing else grants you permission to modify or These actions are Therefore or any work based on the you indicate your acceptance of this License to do so by and time you redistribute the Program the recipient automat nal licensor to copy these terms and conditions restrictions on the recipients You are not responsible for enforcing compliance by as a Consequence Of ca Cour infringement or for any other rea conditions otherwise excuse you distribute are imposed on that contradict from t so as you wh the co he conditions of tinen te the Program at to satisfy simulta License and any other per may not distribut license would not not li ether by co nditions of son this Licen neously y t obligations all For all those who receive copies directly or ind or any work based on tically receives a license from the distribute or modify the Program subject You may not impose any further distributing or modifying the to the rights granted herein ted order mi urt this se O License ur obligations example
19. libstdc 6_3 4 3 r10_arm ipk e 1ibts 0 0 0_0 0cvs20050403 r18_arm ipk e 1ibx11 6_6 2 1 r2_arm ipk e libxau0_0 1 1 r1_arm ipk e libxcalibrate0_0 0cvs20050403 r0_arm ipk e libxdmcp0_0 1 3 r1_arm ipk e libxext6_0 0cvs20050222 r1_arm ipk e libxfont1_1 4 2 12_arm ipk e libxft2_2 1 6 rl_arm ipk e libxrandr2_1 0 2 rl_arm ipk e libxrenderl_0 8 4 rl_arm ipk e tslib conf_0 0cvs20050403 r18_collie ipk e ttf bitstream vera_l 10 r2_all ipk e xserver kdrive fbdev_20050207 r0_arm ipk e xtscal_0 6 3 r0_arm ipk Any more recent version of OpenZaurus and these packages should doit I first installed the Bootstrap Image with the zImage 64 0 to have enough RAM for Einstein Platform Then I copied all these packages to a CF card and I installed them all at once with the ipkg command line tool on the Zaurus with something like ipkg install mnt c x ipk Then I copied the three elements from the release archive as well as the 710006 ROM image to the root of the CF card And I launched the script with mnt cf start einstein sh 5 2 More details for other PDAs Please note that Einstein Platform requires quite a large amount of RAM Most old PDAs do not provide enough RAM for third party application unless you enter some developer mode or install a bootstrap image e Name the ROM dump either 717006 MP2x00 US 737041 MP2100 D 747129 eMate 300 Einstein Platform User s Manual 11 e Put the file on the compact fla
20. ns ted interf limit raphical those countries countries the limitat 9 not thus excluded tion as if written in the body of this tation exc this License inc License Such new v address new problems or concerns Each version is given a distinguishing version number but may differ LE E License which applies to of following the terms a specifies a version number of this later version you have the option either of that version or of any la Software Foundation If the this License you may choose Foundation LO ter version published by Program does not specify a vers any version ever published by t If you wish to incorpora te parts of the Program into o uted that thor donor to decide if he or she is willing ee Cannot nded to make thoroughly clear what is believed to the rest of this License tion and or use of the Program is restricted in ther by patents or by copyrighi original copyright holder who places the Program under this License distribution so that distribution is permitted only in or among In such case aces the luding orporates The Free Software Foundation may publish revised and or new versions of the General Public License from time to time be similar in spirit to the present version ersions will in detail to he Program it and any nd conditions the Free ion number of he Free Software
21. ontains plus any associated interface definition files plus the scripts used to control compilation and installation of the executable However as a special exception the source code distributed need not include anything that is normally distributed in either source or binary form with the major components compiler kernel and so on of the operating system on which the executable run itself accompanies the executable If distribution of executable or object code access to copy from a designated place then Sr is made by offe access to copy the source code from the same distribution of the source code compelled to copy the source along with the object 4 otherwise to copy void However You may not copy except as expressly provided under this License sublicense or distribu modify modify parties who have received copies sublicense even though O O offering equiva place counts as unless that component ring lent third parties are not code r distribute the r rights this License will not have their licenses terminated so long parties remain in full compliance Dis Signed it However You are not required to accept this Lic distribute the Program or its derivative wor prohibited by law if you do not accept this License modifying or distributing the Program Program all its terms and conditions for copying m or wor
22. ou will be provided with a prompt Typing help will provide a small help about the available commands 6 3 Monitor mode The monitor mode uses a disassembler from the NetBSD project the kernel disassembler for the arm32 port You start in monitor mode by specifying the monitor option to the command line program The monitor mode can be considered as an enhanced low level debugger The help command displays a short help for the available commands One of the main advantage of the monitor is that you can set breakpoints You can also halt the emulator by calling the Einstein BreakInMonitor global function it doesn t take any parameter The following breakpoints are enabled by default e NewtonOS UND instructions to pass strings to the debugger typically followed by a reboot They are executed i e the Newton will reboot but the Newton is halted and the string is printed to the monitor e Some violations that shouldn t happen You cannot use log option with monitor because in monitor mode the log is always enabled You can save the log to a file it scrolls on the monitor screen The monitor mode uses a file with symbols This file should be named after the ROM file e g 717006 sym bols The syntax is address lt tab gt symbol lt tab gt comment Addresses should be sorted This file is very easy to generate from the debugger images that are used with Hammer and Newtsbug Use Newton C Tools DumpAlF program with
23. p ROM Services b Hide Einstein 36H Hide Others TH Quit Einstein Q Dump ROM Menu Item e Type the IP address of your Newton 000 Dump ROM Please start ROM Dumper on your Newton See the User s Manual for details Newton IP 10 0 p 15 Cran Dump ROM Panel Help Einstein Platform User s Manual 7 e Click start e Mention where to save the Newton ROM Be careful not to erase previously dumped ROM file if you are dumping the ROM of several different Newton models e Wait a little bit The platform will be configured to use the newly dumped ROM Alternatively you can use nc 1 command line tool Einstein Platform User s Manual 8 4 Einstein on MacOSX Just copy the GUI application to your hard drive and double click it The first time it will ask you to tell it where the ROM image is You can run Einstein Platform full screen To exit Einstein go to the Extras Drawer tap the i button and then choose Quit Einstein On MacOS X Einstein application is scriptable You can install packages or evaluate NewtonScript code within Einstein Platform using AppleScript 4 1 Using the CLI flavor on MacOS X On desktop computers the CLI flavor should mainly be used to access the log and or the monitor mode It is therefore intended for developers e Name the ROM dump either 717006 MP2x00 US 737041 MP2100 D 747129 eMate 300 e Put the file in the data directory next to Einstein rex file Einstein
24. rex is the ROM Extension for Ein stein Platform it includes Einstein drivers and Frank Gruendel s NewtTest program e Then in the Einstein directory launch Einstein with einstein machine XXXX data where XXXX should be either 717006 for a MP2x00 US 737041 for a MP2100 D 747129 for an eMate 300 4 2 Options einstein help will print some help about the options The options are summarized below audioor l al Select the audio driver null portaudio or coreaudio audio null will disable sound audio portaudio will choose portaudio sound driver Default is coreaudio width Set the width of the screen in portrait mode Default is 320 height Set the height of the screen in portrait mode Default is 480 logor 1 Set the log file Default is to not log This option is incompatible with monitor machine or m Set the machine Choose 717006 for a MP2x00 US 737041 for a MP2100D or 747129 for an eMate 300 machine option can be omitted with a 717006 ROM file Einstein Platform User s Manual 9 monitor Run in monitor mode ram Set the RAM size in 64 KB increment 1 will mean 64 KB of RAM 64 is the default setting 4 MB The maximum is 255 nearly 16 MB Einstein Platform User s Manual 10 5 Einstein on arm linux PDAs 5 1 Quickstart on the Zaurus I used a Zaurus SL 5500 thanks Sylvain with OpenZaurus http www openzaurus org 3 5 4 rc ROM and the following packages e
25. sh next to Einstein rex file e Run the X server Xfbdev on the Zaurus needs to be run at 270 degrees Xfbdev screen 320x240 270 dpi 100 e Run Einstein Platform with mnt cf einstein machine XXXX width YYYY height 2222 mnt cf where XXXX should be either 717006 for a MP2x00 US 737041 for a MP2100 D 747129 for an eMate 300 and YYYY and ZZZZ should be set properly 5 3 Options einstein help will print some help about the options The options are summarized below width Set the width of the screen in portrait mode Default is 320 height Set the height of the screen in portrait mode Default is 480 logor 1 Set the log file Default is to not log This option is incompatible with monitor machine or m Set the machine Choose 717006 for a MP2x00 US 737041 for a MP2100D or 747129 for an eMate 300 machine option can be omitted with a 717006 ROM file monitor Run in monitor mode ram Set the RAM size in 64 KB increment 1 will mean 64 KB of RAM 64 is the default setting 4 MB The maximum is 255 nearly 16 MB Einstein Platform User s Manual 12 6 Developer notes 6 1 Compiling and porting Einstein The documentation for obtaining the source code of Einstein compiling it and porting it is available on Google Code web page http code google com p einstein 6 2 CLI commands The command line interface is intended for developers and hackers Using the cli flavor y
26. tall Debugger Connection or Newtsbug Connection package on your Newton e Plug the Newton with the Mac using the serial line e Run Hammer or Newtsbug on the Mac A standard get file dialog appears choose the debugging image corresponding to your Newton Senior CirrusNoDebug image Senior DCirrusNoDebug image or Newt KNoDebug image for the MP2x00 US MP2100 or eMate 300 respectively e Tap the Debugger Connection or Newtsbug Connection package on your Newton and choose con nect e On the Mac once the connection is established choose Save Memory from the File menu e Save memory between 0 and 00800000 8 MB Wait 3 2 ROM Dumper TCP IP ROM Dumper is a faster approach but requires an internet connection between your Mac or any Unix computer and your Newton Requirements Einstein Platform User s Manual e A working TCP IP or Internet connection between your Newton and your Mac Steps e Install provided ROM Dumper package on your Newton e Tap the ROM Dumper icon in the Extras Drawer e Tap start e If your Newton isn t connected to the Internet yet choose a connection method It s also the time to insert your Ethernet WiFi card e Note the IP of the Newton ROM Dumper mentions it IP 10 0 1 5 Listening on port 10080 i EJ ROM Dumper listening e Launch Einstein Platform the GUI version e Choose Dump ROM from the Einstein menu r EEES File Edit Window Emulator About Einstein Dum
27. under the terms of the GNU General Public License as published by the Free Software Foundation either version 2 of the License or at your option any later version This program is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE See the GNU General Public License for more details E You should have received a copy of the GNU General Public License along with this program if not write to the Free Software Foundation Inc 51 Franklin Street Fifth Floor Boston MA 02110 1301 USA Also add information on how to contact you by electronic and paper mail If the program is interactive make it output a short notice like this Einstein Platform User s Manual 25 when it starts in an interactive mode Gnomovision version 69 Copyright C year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY for details type show w This is free software and you are welcome to redistribute it under certain conditions type show c for details The hypothetical commands show w and show c should show the appropriate parts of the General Public License Of course the commands you use may be called something other than show w and show c they could even be mouse clicks or menu items whatever suits your program You should also get
28. utio nd use i are permiti ns of so list of ns in bi no tie documentation and or other All advertising materials must display the following ac this list of nary condi urce code must conditio form must tio ma men Brinicombe 1996 Brini ns and the ns and the tioning fea knowledgeme This product includes software developed by 4 The name of the company nor the name of endorse or promote products derived from prior E NO DIRE INCLU T WA M ET ST HIS SOFTWARE RRANTIES RCHANTA EVENT S NG wri IS INCL PROVIDE UDING B BILITY HAL IDE INC AND FITN L BRINI NTAL SP tten permission D BY BRINI SAS IS UT NOT LIMITED TO ESS FOR OR CONTI ECTAL EXEMPLARY A PARTICULA B E SERVICES LOSS O HOWEVE STRICT R CA LIA 2 USE BILITY ANY WAY POSSIBI D AN En G Ly F US D ON AN UT NOT LIMITED TO DATA OR PROFITS Y TH T INCLUDING N PROCURE T fol 7 n source and binary forms ted provided that the following conditions ow with or without retain the above copyright ing disclaimer Fol I reproduce the above copyright ow ing disclaimer in the n r TH R P En LS as EORY OF LIABILITY WH
29. y and that users may redistribute the pr these conditions and telling the user how to view does not normally print such an announcement your These requirements apply to the modified work as a who License Exception if the Program itself is interactive but that you provide ogram under a copy of this work based on the Program is not required to print an announcement le TE identifiable sections of that work are not derived from the Program and can be reasonably considered independent and separate works in themselves then this License and its terms do not apply to those sections when you distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program the distribution of the whole must be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardle ss of who wrote it Thus it is not the intent of this section to claim rights or contest your rights to work written entirely by you rather the intent is to exercise the right to control the distribution of derivative or collective works based on the Program In addition mere aggregation of another work not based on the Program with the Program or with a work based on the Program on a volume of a storage or distribution med
30. your employer if you work as a programmer or your school if any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker lt signature of Ty Coon gt 1 April 1989 Ty Coon President of Vice This General Public License does not permit incorporating your program into proprietary programs If your program is a subroutine library you may consider it more useful to permit linking proprietary applications with the library If this is what you want to do use the GNU Lesser General Public License instead of this License Einstein Platform includes portaudio v19 from CVS x PortAudio Portable Real Time Audio Library x Latest Version at http www portaudio com Copyright c 1999 2000 Phil Burk and Ross Bencina x Permission is hereby granted free of charge to any person obtaining x a copy of this software and associated documentation files the Software to deal in the Software without restriction including without limitation the rights to use copy modify merge x publish distribute sublicense and or sell copies of the Software x and to permit persons to whom the Software is furnished to do so subject to the following conditions x The above copyright notice
Download Pdf Manuals
Related Search