Tattletale Model 8 (C Language) Addendum
Contents
1. x CodeWarrior for Palm OS Platform Yersion 8 0 Setup Select Components Choose the components Setup will install metrowerks Select the components you want to install and clear the comments nan de not mant ta install CodeWarrior for Palm OS Platform Yersion 8 0 Setup 3 x Select Components v CodeWarrior Examples Choose the components Setup will install wj Metrowerks Examples metrowerks Y Palm OS Release 4 0 SDK Example Projet id A Metrowerks IDE scripting examples Select the components you want to install and clear the components neu da nat want tn 3 19 CodeWarrior for Palm Support install CodeWarrior for Palm 05 Platform Version 8 0 Setup x E 9 CodeWarrior MSL v p Des Select Components y Runtime Support Sources 9 CodeWarrior Examples na Choose the components Setup will install CodeWarrior Manuals 9 Code Warrior for Palm Support En metrowerks gt y CodeWarrior Manuals sup M Space Required on C 196068 K Palm OS 4 0 Documentation n Mery the components you want to install and clear the components you do not want to Space Available on C 20293714 K 4 Palm Tools OS Description InstallShield Other SDKs p Thrill Seeker2. CrossCut Tools for Windows development environment Return to Page 1 9 in the Main TT8 Manual for information on e What to do if something is Missing or Broken upon Arrival e Tools Required to Connect and Test the Tattletale e Safety Precautions D 6902 A CrossCut Windows Development Tools and CodeWarrior Installation Guide Code Warrior for Palm OS Version 8 0 8 2 or later Introducing CrossCut Tools and CodeWarrior NOTE CrossCut is both the name of the complete suite of Onset s TTS development support tools as well as the name of the terminal emulator program included in this package Onset s CrossCut tools support Tattletale Model 8 8v2 68K cross development using the Palm OS version of the Metrowerks CodeWarrior compiler suite This document describes the three installation steps required to prepare your Windows PC for building Model 8 8v2 programs 1 Install CodeWarrior for Palm OS Version 8 0 8 2 or later Check the website or call Onset for compatibility of later versions 2 Install CrossCut Tools for Tattletale Model 8 3 Specify Source Trees for your TT8 Development Install CodeWarrior Your first step toward TT8 and TT8v2 hereafter referred to as TT8 development with the Windows based libraries and support tools requires installing Metrowerks CodeWarrior for Palm OS Version 8 0 8 2 or later If you follow the installation instructions on these four pages to the letter you should be running your fi
3. Remove B RAD Tools Factory Settings Revert Import Panel Export Panel DK Cancel Apply Ad1 D 6902 A Installed Files Metrowerks CodeWarrior The screen snapshots below show the files and directories that were installed into the CodeWarrior directory 10 x Ex C Program ER SO File Edit View Favorites Tools Help Folders x i Plugins 68KLinker dl C com CrossCutPostLinker dll au Compiler s MacBinarizePostLinker dll 2 Debugger gt MacMerge dll 03 Editor PalmRezPostLinker dll amm a Preference Panel O support a version control E gt 4 gt 5 object s Disk free space 11 1 GB 701 KB e My Computer A EN C Program Files Metrowerks CodeWarrior Stationery TEO m xi File Edit View Favorites Tools Help Ea Folders x Ay Stationery e Palm OS Application c MEI RS IS 3 TT8 C TT8 PicoDOS y 4 gt 2 object s Disk free space 11 1 GB 0 bytes TT8 TT84 PicoDOS gt ej My Computer A Onset CrossCut The screen snapshot at right gives a high level overview of the installation into the Onset directory Use this to familiarize yourself with the general layout and structure of the CrossCut development tools and as a map for quickly locating the files and directories referenced in the Getting Started Guide Your Files Don t put your fil
4. Ad6 o x LOGGER ay g b Files Segments Targets v Eg TT8 Support 183K 14K El B TT8Documentationin n a n a fl CrossCut exe n a n a E Source 4K 471 BB TTSConfig plk 96 0 B TT8StdC c 1858 388 M userio c 2650 83 HE Libraries 179K 14K C_TT8_Runtime lib 4530 4 C 2i TT8 Onsetlib 21096 1716 C 2i CPU32 Mat 90608 1503 C 2 CPU32 StdC 67378 11379 Headers B cxtt8 h B cxcpu32 h B dio332 h B gsm332 h B sim332 h B tat332 h B tpu332 h 000000000000 Aoooooooooooo ha hh ha hh ha hh ha le a 1 amp 3 Application Files mun O0 La a NK e Al 21 files 185K D 6902 A Setup CrossCut and run the logger example Start CrossCut From the Windows Start menu choose Warning ES Programs Onset TT8 CrossCut CrossCut for TT8 Please choose a Comm Port from the next dialog Don t be too surprised if you see the warning dialog at right the first time you run CrossCut It just needs you to tell it just once what serial port it should use to talk to your TT8 To change port settings choose Setup from CrossCut s CommPort menu to Part Baud rate get the next dialog shown at right Select the number of COM port that you want to use and 9600 Baud then click OK com sm y Data bits Parity Stop bits If you don t like the default text style choose Font from E Hone CrossCut s Terminal menu CrossCut has several similar customization options and yo
5. command from the Terminal menu to send over your PC s current time Do that then give the rest of the logger program a quick spin Reply N to the Offload the data query and N to the Another run query We ve got more learning to do A47 D 6902 A Burn the logger example into flash You should have now concluded the RAM run of the logger open 2 program and be back at the TOM8 monitor prompt We want to Lookin eatin o EE Resource frk repeat the same Load the logger program steps but with one important exception You should choose LOGGER AHX this time because our target is now the flash memory B LOGGER RHX You ll see the progress dialog but on completion this time the NE File name Lo GGER AHX Open TOMS monitor will ask your permission to write the flash Type EA i Files of type Hex Files 519 HEX RHx 4HX v Cancel Y enter and your CrossCut terminal screen should look like TH Help Z TOM8 gt load successful Target Flash strt addr 00002000 end addr 00011F95 Ok to write flash between above addresses Y N Y lt enter gt FLASH ID ATMEL 29C010 burning x k k x xk k kk k k k k k kk k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k kkxkkxkxkxk xk xk xk xkk xkk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkxkxkxkxkxk xk xk xk xkxkxkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkxkxkkkkkkkkkkkkkkkkkkk
6. install to a diferent folder cick Browse and select so introductory and license information dialogs Begin to pay careful attention when you get to the Choose Destination Location dialog For a painless introduction to CrossCut development en you really do want to accept the default location Ele a Bez offered by the installer iocus i ancel C Program Files Metrowerks CodeWarrior A 9 D 6902 A Setup Type At the Setup Type screen select the Custom Install CodeWarrior for Palm OS Platform Yersion 8 0 Setup 3 x option unless you plan to also use CodeWarrior for Palm ae PA Choose the setup type that best suits pour needs OS development If you choose Full Installation all of the O components needed by CrossCut will be installed and you podi ei TER tallat can skip the Select Components steps 2 EPA Selecting this installation type will allow you to choose which components will be selected and installed Select Components Use the screen snapshots and instructions below to select the proper components for CrossCut development then click your way through the remaining installer screens InstallShield 1 Setup Type lt Back Cancel a Click select CodeWarrior Custom Install b Click Next gt 2 Select Components a Collapse all of the boxes to fit everything in the small window b Uncheck everything except i CodeWarrior IDE i CodeWarrior for Palm Support
7. the CPU MAN TPU Motorola manual for the Time Processor Unit CD TT8 C DSW CrossCut Tools for Windows development environment Miscellaneous GOODY BAG Thermistor 10K resistor and FET for experimenting D 6902 A C Compiler Kit for Windows migration from Aztec Part Numbers for Kit Description TT8 CW MIG Finished Goods CW Metrowerks CodeWarrior for Palm OS package Manuals MAN ADD XCTW Addendum to Tattletale Model 8 C Version describing Windows based Development CD TT8 C DSW CrossCut Tools for Windows development environment Deluxe Development Kit for Windows TT8 version TT8 DLX DKW Finished Goods IO 8 2 x 3 inch prototyping board for the Tattletale Model 8 PR 8 5 x 7 inch prototyping board for the Tattletale Model 8 PC 3 5 Cable Communications cable to connect the Tattletale to a PC CW Metrowerks CodeWarrior for Palm OS package Manuals MAN TTSC Manual for the Tattletale Model 8 C Version 3 ring binder for the manual Tab set for dividing the sections of the manual MAN MC68332 Motorola manual for the 68332 processor MAN CPU 32 Motorola manual for the CPU MAN TPU Motorola manual for the Time Processor Unit MAN TTSTXB Manual sections for using the Model 8 with TxBASIC 3 ring binder for the manual Tab set for dividing the sections of the manual CDs TT8 C DSW CrossCut Tools for Windows development environment TT8 TXB DSW TxBASIC TxTools and CrossCut Terminal Emulator for Windows Miscellaneous G
8. with a single build command For this example we re going to ignore whatever you chose iii as the default memory model during the IDE Source Trees section of the installation guide Our first step will be to force the project you created in the last section to build code for a stock 256KB TTS8 Once again type Alt F7 with the seu project window in focus to bring up the projects Target MN IU Settings Panel Click the Source Trees item and notice that j Lo E nothing is currently defined Source Trees 4 r f Language Settings C C Language Global Optimizations E Linker B8K Linker Import Panel Export Panel Click the Import Panel button and navigate to E u C Program Files Onset CrossCut TT8 Lookin reed e Ae E 2 Source Trees PD8 256K CwPalm8 Project xml Source Trees TT8 1M4 CwPalm8 Project xrnl XMLSettingsPanels Project and select Source Trees_TT8_256K CWPalm8_Project xml Click Open in the open dialog then OK in the Settings dialog Whenever you make a change like this it s a Source Trees TTG 256K 4 CwWPalma Project xml E Target Settings xml b ood idea to force Code Warrior to perform a complete 8 p p File name Source Trees_TT8_256K CWPalm8_Project xr re search and re build by invoking the three R s from i E Files of type Importabie XML Files xml Cancel the project menu Remove Object Co
9. OODY BAG Thermistor 10K resistor and FET for experimenting 85 NUT DRIVER Nut driver for fastening the Squishy bus to the PR 8 D 6902 A Deluxe Development Kit for Windows TT8v2 version Description Part Numbers for Kit TT8v2 DLX DKW Finished Goods IO 8 PR 8v2 PC 3 5 Cable CW Manuals MAN TT8C MAN MC68332 MAN CPU 32 MAN TPU MAN TTSTXB CDs TT8 C DSW TT8 TXB DSW Miscellaneous GOODY BAG Thermistor 10K resistor and FET for experimenting TT8 CW QI Meer Cok Wario fr Pm OS package 0 CW Metrowerks CodeWarrior for Palm OS package Manuals MAN TTSC CD TT8 C DSW 2 x 3 nch prototyping board for the Tattletale Model 8 5 x 7 nch prototyping board for the Tattletale Model 8v2 Communications cable to connect the Tattletale to a PC Metrowerks CodeWarrior for Palm OS package Manual for the Tattletale Model 8 C Version 3 ring binder for the manual Tab set for dividing the sections of the manual Motorola manual for the 68332 processor Motorola manual for the CPU Motorola manual for the Time Processor Unit Manual sections for using the Model 8 with TxBASIC 3 ring binder for the manual Tab set for dividing the sections of the manual CrossCut Tools for Windows development environment TxBASIC TxTools and CrossCut Terminal Emulator for Windows C Compiler Kit for Windows Manual for the Tattletale Model 8 C Version 3 ring binder for the manual Tab set for dividing the sections of the manual
10. Open the Logger example From the IDE File menu choose Open Ctrl O then navigate to and select C Program Files Onset CrossCut TT8 Examples OnsetClassic LOGGER LOGGER mcp CW will open a project window for the pre configured logger example It Wu will open in collapsed form because we don t save temporary build S E information or windows positions when we create the installer As you PP work with CodeWarrior you ll see that it intelligently remembers these d Mc gt 3 things for you 21 fies 00 7 For the remainder of this guide Project will often refer to one of CodeWarrior s active project windows Simple TT8 projects consist of two major groups of build components pup The TT8 Support group contains all of the helper files which you can for i e Files Segments Targets the most part safely ignore The Application Files group contains your gt application specific files As your projects grow in complexity you can EEA TTS Suppor 0 0 B TT8Documentationln n a n a create your own group structures and further subdivide the existing BL CrossCutese na na 34 Source D 0 groups as you deem appropriate Ll B TT8Config plk n a n a B TT8StdC c n a n a B userio c n a n a E Libraries 0 0 C_TT8_Runtime lib n a n a C 2i TT8_Onset lib n a n a C 2i CPLI32 Mat n a n a C 2i CPU32_StdC n a n a 1 amp 3 Headers 0 0 B cxtt8 h n a n a B excpu32 h n a n a B dio332 h n a n a AB gs
11. PARIO Sita EE y appropriate directory 21x 5 Click Save in the Seven MyTT8Proiects e 6 c E Create New Select project stationery Project Stationery Project dialog 6 Click OK in the TT8 PicoDOS New dialog 7 Choose one of the p TTS project types Wem feme 1 Save as type Project Fies me zx Cancel z s Sow an ERE v Create Folder dialog a 8 Click OK Some optional cleanup Y our newly created project has a skeletal C application in a source De rotos E file named tt8main c and it s ready to build and run To keep your A ea ee ue les Segments Targets computer from becoming littered with a bunch of identically i l v Fle 1 Code Data named object files we suggest performing the next two optional e amp CI TTS Support 0 0 2 Y E Application Files 0 D m steps g B tt8main c 0 O B gAlt F7 gt TgtSet gt Renamel gt gt Settings 21 xl Click the Settings icon immediately to the right arge of the target name dropdown menu at the top of the Tergat Sairas Targat Nemes MineAlMind r Build Extras Linker Macintosh 68K y project window to bring up the project settings Rune Stine pee The dropdown menu should currently contain the diei ien Postinker CrossCut PostLinker m name Alt F7 gt TgtSet gt Rename gt gt to help m Alt F7 gt TgtSet gt Renamel gt gt Settings 2 xq you remember to do thi
12. Page A 6 Replaces Page 1 8 through 1 9 Getting Started CrossCut Windows Development Tools and Code Warrior Installation Guide Page A 9 Replaces Pages 2 3 through 2 8 Installing the Tattletale Software Introduction to CrossCut Terminal Emulator Page A 14 Replaces Page 3 1 What is CrossCut and how is it used CrossCut Tools Getting Started Guide Page A 15 Replaces Pages 3 2 through 3 20 Operating the CrossCut Program D 6902 A Metrowerks CodeWarrior for Palm OS version 8 0 8 2 or later Call Onset for compatibility above 8 2 replaces Aztec Compiler section on page 1 7 of the main manual CodeWarrior for Palm OS is developed marketed and supported by Metrowerks Although the program package is provided by Onset as a convenience to customers we cannot process any registration cards for the Code Warrior Y package and we do not provide any warranty or support for the CodeWarrior software Any registration for purposes of receiving updates to the CodeWarrior M program must be performed directly with Metrowerks For more information on Metrowerks update policies see the CodeWarrior manual or contact Metrowerks directly at Metrowerks US Phone 512 997 4700 Fax 512 997 4901 info metrowerks com Metrowerks Europe Phone 41 61 690 7500 Fax 41 61 690 7501 info europe metrowerks com Metrowerks Japan Phone 81 3 3780 6091 Fax 8 1 3 3780 6092 asia sales metrowerks com D 6902 A Development Software De
13. Tattletale Model 8 8v2 OPERATION MANUAL ADDENDUM AND CROSSCUT TOOLS USER S GUIDE describing Windows Based Development For the TTS TTSv2 using Metrowerks CodeWarrior for Palm OS Integrated Development Environment and CrossCut Windows Development Tools P N MAN ADD XCTW D 6902 A Onset Computer Corporation 470 MacArthur Boulevard Bourne Massachusetts 02532 Tel 508 759 9500 Fax 508 759 9100 ww onsetcomp com D 6902 A A 2 D 6902 A Introduction This manual is an addendum to the Tattletale Model 8 8v2 Installation and Operation Manual and describes the development process for creating and debugging a C program for the TT8 8v2 in a Windows based Development Environment All tools have been developed for use in the Metrowerks Code Warrior for Palm OS version 8 0 8 2 or later contact Onset for compatibility Integrated Development Environment IDE This addendum will describe how to install and work with the CodeWarrior M C Compiler Suite and with the CrossCut terminal emulator TT8 libraries and sample projects collectively referred to as CrossCut Tools or Windows C Development Tools Note that the TT8 8v2 can also be programmed using Onset s TxBASIC language For instructions on development using TxBASIC proceed to the main part of the TT6 manual MAN TTS TXB Overview for Upgraders For those of you upgrading from the AZTEC C Compiler this package offers a complete code development envir
14. d Settings IDE Extras Plugin Settings Shielded Folders Source Trees Editor Editor Settings of Font amp Tabs 4 Text Colors Debugger j Name Display Settings Windowing Global Settings Remote Connections Java Settings SE Se ss ES S RAD Tools m Source Tree Info Type Absolute Path y Choose Look in Cx IDE e mies E3 G General 21x Filename Source Trees_TT8_1M CWPalm8_IDEGlabalP Factory Settings Import Panel Export Panel Source Trees_PD8_1M CWPalm8_IDEGlobalPref xml OK med 2 Source Trees PD8 256K4 CwPalma IDEGlobalPref xml Source Trees TT8 1M CwPalm amp IDEGlobalPref xml 2 Source Trees_TT8_256K CWPalm8_IDEGlobalPref xml Source Trees Files of type Importable XML Files ml y Cancel Build Settings IDE Extras CxT arget C Program Files Onset CrossCut TT8 TT8_1M Plugin Settings aa y scl un Family AProgram Files Onset CrossCul nn dog CxCommon C Program Files Onset CrossCut CPU 32 B Editor CxRoot C Program Files Onset CrossCut CxStdC C Program FilesMetrowerkssCodeWw NMSL Common w Editor Settings niis zn A MUR of Font amp Tabs L Text Colors m Source Tree Info Debugger Nane Display Settings Windowing Type Absolute Path n OO Global Settings Remote Connections Choose Java Settings PalmDebugger Sett Add Change
15. de Re search for 7 0 Files and Reset Project Entry Paths Finally re build the project by typing F7 This project and target now builds only 256KB TT8 programs as we requested For clarity repeat the cleanup operation we used in the last section to add 256K to both the target and file name panels Add a TT8 1MB target Click the Targets tab in the project window then choose Create Target from the IDE s Project Menu Type in the first part of the first target name but append IMB as an identifier Make sure to click the Clone existing target radio button then click OK Select the new target using the target popup in the project window and click the settings icon to get to the project panels and repeat the Source Trees import but this time choose Source Trees_TT8_1M CWPalm8_Project xml then go the 68K Target panel to rename the output files to wear the 1 MB identifier Now whatever is selected in the project window s target popup is what your builds will generate To build executables to both a 1MB and 256KB TT8 you need to manually select one target and build it then repeat the process after selecting the other target We re going to create one more target to automate this process New Target x Name for new target Mine llMine 1 MB r New target contains C Empty target Clone existing target MinedllMine 256K Y Cancel MyFirstNewTT8Projectmep 5 MyFirstNewT T amp Project mcp Mine llM
16. es or projects in either the Onset or Metrowerks directories They can too easily be lost without warning in the process of updating CodeWarrior or CrossCut Tools That s it You should now be up and running A12 Program Files Onset File Edit View Favorites Tools Help Folders E d Cross Cue ar Special EH cpus2 EC Headers EH Placeholders A sys i Libraries EL TT8 E CJ Motorola p e L3 TPUFunctions Lt Release Notes E Examples A OnsetClassic E ADIOOKHZ 2 ADDFLASH LC ADDMEM ADDPARIO gt C apLoop E COUNTER 2 EEPROM 22 FBENCH 2 FLASHERN LJ HELLOTTS C INFOTTS LJ INTRPTS LOGGER 0 LPSLEEP LO PWMPPWA Us RAMRUN 3 TPRINTF z 3 TPURUPT C UARTINIS of WATCHDOG 0 0 MODEM Eg LInsupported E Experimentall gt CrossCutTTEC pf Headers d 3 Libraries a Picos Eg Examples EC Dungeon AD LogcF8 1 PicopAQ 0 Test rgs n L3 TestExec 3 Project 1 objectis Disk Free sp D bytes My Computer D 6902 A A13 D 6902 A Introduction to CrossCut Terminal Emulator replaces Page 3 1 in the main manual The CrossCut Terminal Emulator part of the CrossCut Windows Development Tools running on a host IBM PC works in collaboration with a companion TOMS mini monitor program running on the Tattletale along with Metrowerks CodeWarrior for Palm OS on the PC to form a complete C development system The TOM 8 mini
17. files are all created by the CrossCut post linker When you work with other projects the name LOGGER will be something different but the relationship of filename extensions remains the same Runtype App type a Hex file S Records containing the executable TT8 program Binary file CMP68K containing the TT8 executable Map file text listing the function and variable addresses Looking again at the IDE project window we see that the make operation erased the needs build checkmarks and filled in the Code and Data sizes for the various components Don t be concerned by the huge code size listed at the bottom It reflects the total size of every library object but two thirds of that isn t used by the logger programs and CW s smart linker will strip it all off For the time being you can safely ignore most of the IDE s menu selections and the project window s icons and controls However this seemingly simple interface hides an amazingly powerful suite of development tools and utilities If you plan on doing a lot of work with CW the couple of hours spent reading the IDE User Guide available from the IDE help menu will be paid back many times over In the next step we ll load and run the logger project on the TT8 Before doing that you might want to double click the LOGGER C file Bl LOGGER C 1438 in the project window to take a look at C source code for what we ll be sending over and what you can expect to happen
18. ine 1MB NER Y A A Files Segments Targets N Targets x Mine llMine 256K Mine llMine 1MB ini x El A20 2 targets 183K 14K g 4 D 6902 A Add a build all target With the targets tab selected in the project window choose Create Target from the x IDE s Project Menu Type in the first part of the first target name but this time een don t append anything or append something like BuildAll and this time make TE sure to click the Empty target radio button then click OK 3 nad Mine llMine 256k Your project window should look something like the snapshot at right If IP xd necessary lengthen the project window for the next steps We re going to 9 MneaMineMe Dy d y first drag the new build all target to the top of the list then we re going to Fies Segments Targets drag a copy of each of the other two targets underneath and to the right of E LLLLLLLLL the build all target to define them as subprojects re E 3 targets 0 0 lol xl Click the expander box for the build all target and your window Ex IBY SS should look something like the snapshot at right We have one more ea a ci cleanup step to perform Select the build all target from the project e e windows popup then click the target settings icon to get to the Target a S ine Settings panel Choose None in the Linker selection popup then click icis uM OK A LL Now whenever you want to build executab
19. kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk k k TOM8 gt Run the flash program You could now simply type G lt enter gt to run the flash program but what s more interesting is what happens when you remove power and then power up again Try it At startup the TOMS automatically runs any program it finds at location 0x2000 and anytime you load an AHX file that s where it goes simple as that Give logger another quick spin to see what happens when you get to the end Ok you can stop now Well it s not quite that easy The simple logger program wasn t designed for running from flash so when it completes the TT8 resets and the program starts over again This is probably the kind of behavior you want from whatever instrumentation the TT will be charged with controlling but right now we want to get back to development mode Fortunately the TT8 has an escape hatch for flash applications The TOMS will automatically skip the flash launch anytime it sees IRQ3 low at startup This is pin A5 on the IO 8 prototyping board and pin 61 on the main connectors Hold this signal at ground and power cycle the TT8 to get back to the TOMS monitor Once you remove the ground connection to IRQ3 the TT8 will once again resume running whatever it finds at 0x2000 You can load and run the CLRFLASH RHX program in the OnsetXCrossCut T T8 bin directory to erase everything except the TOMS monitor A better solution is to provide your programs destined for flash
20. les for both Tattletale memory models you need only select the build all target and choose make CW will take care of the rest Online Documentation The IDE s help menu will lead you to the reference manuals for CodeWarrior C programming and the standard C library The Start menu via Onset Programs Onset TT8 CrossCut will lead you the html documentation index with links to both Onset s and Motorola s reference manuals Good luck Now get to work That s it for the introduction You should be well armed to start creating your own Tattletale Model 8 programs with CrossCut Tools and CodeWarrior What you do next will depend on your C programming experience familiarity with the TT8 and your own imagination A21 D 6902 A A22
21. m332 h n a n a B sim332 h n a n a B tat332 h n a n a B tpu332 h n a n a Bush n a n a B ttSlib h n a n a AB tt pic h n a n a B userio h n a n a 23 Application Files 0 D e 0 De Stretch down the project window then Alt click on each of the two main expander boxes on the far left to give a complete view of the files that make up a TT8 project Double clicking on any file in a project window will open that file with the appropriate application You will likely find yourself leaving the TT8 Support group expanded to quickly open header files and the TT8 documentation links during development Explore the logger example directory amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp amp ba ha ha ka ha da da ka ka ka ka ka ds ka e has ka dos be be has e los le ds ls 4 21 files 0 0 N A45 D 6902 A Before we build the logger example let s take a look at the directory where it resides for a before and after snapshot With CW the easiest way to get there 1s by right clicking the name of a file in the project window and selecting Open in Windows Explorer In the simple logger example directory we find a single project and C source file The LOGGER_Data is created by CodeWarrior to hold intermediate build information The bin directory is a naming convention of the CrossCut stationery and examples It holds the map and object files created during a project build Bo
22. monitor program in the Tattletale communicates with the host computer through a serial port to accept and execute C programs interact with a user and offload logged data for final analysis NOTE The operation of Windows CrossCut is very similar to the DOS version described in the manual Please refer to the Help menu on the Windows version for a detailed explanation of features and functions Ad4 D 6902 A CrossCut Tools Getting Started Guide Introduction This document will give you a gentle whirlwind introduction to the CrossCut and Code Warrior development tools you just installed After you work through all five sections you ll be in good shape to start on your own TT8 project The five sections listed below take up lots of pages but consist mostly of screen snapshots you should be done in about an hour 1 Build the simple logger example 2 Setup CrossCut and run the logger example 3 Burn the logger example into flash for automatic startup 4 Start a new project from the CrossCut stationery 5 Add IMB and 256KB TTS support to your new project Build the simple logger example Start CodeWarrior From the Windows Start menu choose Programs Metrowerks Code WarriorICode Warrior for Palm OS V8 0 CodeWarrior IDE For the remainder of this guide IDE will refer to the Code Warrior Integrated Development Environment application we just started and CW will be used as a generic reference to the CodeWarrior compilation tools
23. onment including all the essential libraries for the TT8 This package brings the TT8 development tools into the Windows environment but the underlying development process remains essentially the same The file types generated are the same as with the AZTEC compiler Assuming you were using the Onset MAKEFILES supplied and are ready to upload and run using the new Windows version of Crosscut The libraries are the same although the code generated may be slightly different due to differences between the AZTEC C Compiler and the Metrowerks CodeWarrior C compiler Besides the standard menus and commands of the Windows environment the CodeWarrior IDE offers many useful tools specifically designed to facilitate and accelerate code development We recommend you do our tutorials and study the CodeWarrior documentation and the online documentation to get the most benefit from the environment Onset support is limited to issues related to the TT8 operation CodeWarrior IDE issues should be directed to Metrowerks tech support D 6902 A This addendum augments or replaces the following sections of the Tattletale Model 8 Installation and Operation Manual ANSI C Version MAN TTSC Introduction and Overview for Upgraders Page A 3 Metrowerks Code Warrior for Palm OS Page A 5 Replaces Page 1 7 Aztec Compiler Updates and Manx Tech Support Development Software Description Page A 6 Replaces Page 1 7 Development Software Description Getting Started
24. ories for locating target components The first time you use Code Warrior with CrossCut Tools you must tell 1t where to look for the correct TT 8 build model by importing one of the pre configured XML Source Tree panels After that source tree operation becomes completely transparent You need to choose one of the four pre defined TT8 memory models that will become the default build model for stationery and example TT8 projects Choose one of the PD8 XML files if you use flash cards with PicoDOS and choose I MB versus 256KB if you work primarily with the large RAM TT8s You can change these global settings later or override the default setting for individual projects 1 Start Code Warrior 2 Select Preferences from the main Code Warrior IDE Edit menu 3 Click select Source Trees from the IDE Preference Panels left 4 Click the Import Panel button from the Source Trees pane lower right Navigate to C Program Files Onset CrossCut TT8 XMLSettingsPanels IDE Then select one of the four primary configurations Source Trees_TT8_256K CWPalm8_IDEGlobalPref xml 256KB RAM Source Trees TT8 IM CWPalms IDEGlobalPref xml IMB RAM Source Trees PD8 256K CWPalm8 IDEGlobalPref xml 256KB PicoDOS Source Trees_PD8_1M CWPalm8_IDEGlobalPref xml IMB PicoDOS 5 Click the OK button back in the Source Trees pane H21x IDE Preference Panels Source Trees G General Buil
25. rst TT8 Windows based program in well under one hour To use the CrossCut package you will need 1 Metrowerks CodeWarrior for Palm OS Version 8 0 8 2 or later 2 64MB RAM 100MB Free Disk Space CD ROM 3 Pentium class processor recommended or 80486 4 Windows 98 ME NT 2000 XP TT8 development in C requires that you install Code Warrior using the Metrowerks CD installer with any of their options to build Palm OS 68K projects If you have an existing CWPalm8 installation that compiles Palm OS 68K programs you can skip right to the Install CrossCut section If you re using CodeWarrior solely for TT8 development you need only select the options checked in the screen captures below which will require about 40MB of disk space Keep an eye on the dialog s Space Required text If it varies a lot from the screen snapshots carefully review your selections If you have trouble it s perfectly safe to reinstall CodeWarrior in part or whole and that generally will get you going CD Installation Start by inserting the CodeWarrior CD On most PCs you will automatically be presented with the C a installation dialog On some others you will have to Select folder where Setup will install files ono IN double click on the CD icon and setup exe to get things Setup wil instal CodeWario for Palm OS Platfom Version BO n he folowing folder TEE started Click your way through the first half dozen or To install to this foldet clok Next To
26. s Type something 3 Target tos LI Target Settin P roject ype alm pplication meaningful in the Target Name text box accen Pathe rn Build Extras ile Name MineAIMing Runtime Settings Standard Mode A5 relative data File Mappings TRIS Click the 68K Target panel selector and type Source Trees La He pidas A 7 68K Target the same or similar name into the File Name 5 Language Settings C C Language tanel text box the click OK C C Waring Emu Code Generation ply ASK Pracessnr After this the project list in the IDE s Open 01x g A i Ez RE Recent list from File menu will show 9 Mins itine de y g bl d L d f Files Segments Targets recogniza e projects an 04 S rom gt Fi Cod Import Panel Export Panel Fie Code Data CrossCut will show object files with names Eg TTB Support 183K MK e mal J Ed Application Fies 86 53 m OK Cancel Apply that make sense B t maine Be Build and run the project We re going to use anes a4 this in the next step A19 D 6902 A Add both 1MB and 256KB TT8 support Multi target projects Multi target projects are a very powerful feature of the Code Warrior IDE This simple but useful example just scratches the surface by demonstrating how to apply this feature to the task of automatically producing executables for both IMB and 256KB TT8 models within a single project and
27. s CodeWarrior Examples aia b ek lt Back i gt ntegrated Development 5 vj Handspring Tools HW sein dn Support Envitonment DE and 1 ouer amia manas supporting help files binaries Space Required on C 196068 K Palm 05 4 0 Documentation need to develop for the Palm Space Available on C 20293667 K Palm Tools OS platform InstallShield Other SDKs i r Thrill Seekers Handspring Tools lt Back Space Required on C 35366 K Space Available on C 20293667 K InstallShield lt Back Cancel Install CrossCut Tools After you ve installed Code Warrior insert the CrossCut CD On most PCs you will automatically be presented with the installation dialog On some others you will have to double click on the CD icon and setup exe to get things started Work your way through the setup screens accepting the default options until the installation is complete InstallShield Wizard dau x Welcome to the InstallShield Wizard for CrossCutT T8Yersioni 00 The InstallShield Wizard will install CrossCutTT8Version1 00 on your computer To continue click Next The Programs item in your Start Menu will now contain an entry for the CrossCut terminal emulation program and for the html TT8 documentation index i Cancel A40 D 6902 A Setup the Source Trees CrossCut Tools uses a powerful feature of Code Warrior called Source Trees to steer projects to the proper direct
28. scription replaces description on page 1 7 in the main manual IBM Software If you purchased any of the following Onset kits you should have received a CD labeled TT8 C DSW which contains the CrossCut C Development Tools If you purchased a Deluxe Development kit you should also have received a CD labeled TTS TXB DSW which contains software tools for programming in TxBASIC Most of the files contained on these disks are also available through the Onset website ww onsetcomp com TT8 C DKW C Development Kit for Windows TT8 and TT8v2 TT8 CW MIG C Compiler Kit for Windows migration from Aztec TT8 DLX DKW Deluxe Development Kit for Windows TT8 version TT8v2 DLX DKW Deluxe Development Kit for Windows TT8v2 version TT8 CW C Compiler Kit for Windows Getting Started replaces Tables 1 6 and 1 7 on pages 1 8 through 1 9 in the main manual TattleTale Model 8 Development Kit Contents for Windows Environment Note Model 8 Tattletale must be purchased separately C Development Kit for Windows TTS and TT8v2 TT8 C DKW Finished Goods IO 8 2 x 3 nch prototyping board for the Tattletale Model 8 PC 3 5 Cable Communications cable to connect the Tattletale to a PC CW Metrowerks CodeWarrior for Palm OS package Manuals MAN TT8C Manual for the Tattletale Model 8 C Version 3 ring binder for the manual Tab set for dividing the sections of the manual MAN MC68332 Motorola manual for the 68332 processor MAN CPU 32 Motorola manual for
29. th of these directories can safely be deleted to reclaim disk space as a subsequent open and build will regenerate them automatically Build the logger project Choose Make F7 from the IDE Project menu to compile and build the logger project Yes it builds very fast When you look again in the bin directory you ll see the files that you just built These fall into three categories The Resource frk LOGGER LOGGER map and LOGGER bin are intermediate files created by the IDE The LOGGER RHX LOGGER RUN and LOGGER RMP are run files that relate to programs that load and run from RAM The LOGGER AHX LOGGER APP and LOGGER AMP EN C Program Files amp OnsetCrossCut TT8 Examples OnsetClassic LOG File Edit wiew Favorites Tools Help Folders x Mame bin B LOGGER C Gat LOGGER Data BS LOGGER mcp LY LPSLEEP O PWMPPWA File Edit wiew Favorites Tools Help Folders 00 INTRPTS EC LOGGER sam File Edit View Favorites Tools Help LI Folders x C INTRPTS rm B C LOGGER am IB LOGGER AHX LOGGER Data E LOGGER AMP O LPSLEEP a LOGGER APP E PWMPPWA isi LOGGER bin C RAMRUN BlLoscer mar 03 TPRINTF E LOGGER RHX CJ TPURUPT E LOGGER RMP C UARTIN15 sa LOGGER RUN are flash files that relate to programs that load and run from flash memory The run and flash
30. u can tailor these to your liking All of the settings will be retained between invocations Send LF automatically after CH Cancel Release port when CrossCut inactive Start your TT8 Connect your TT 8 to the PC s serial port and apply power You should see the standard TOMS monitor sign on prompt Tattletale Model 8 Onset Computer Pocasset MA USA TOMS V109 PIC V1 00 Copyright 1994 TOM8 gt Load the logger program Choose Load S Record from CrossCut s Tattletale menu then navigate to the bin directory holding the logger object files This should be C Program Files Onset CrossCut TT8 Examples OnsetClassic LOGGER bin 21xi Choose S Records rhx ahx from the Files of type Lookin bin e e E dropdown and you should see something like the dialog at si iB LOGGER AHX far right ILOGGER RHX Select LOGGER RHX and you ll see the progress dialog while CrossCut sends the file File name LOGGER RHX Files of type S Records ahx rhx y Cancel Make a mental note of the load time about 30 seconds because we re going to speed that up considerably in a subsequent section Run the logger program On completion the CrossCut window should show the TOMS s load successful response Type G lt enter gt and you should be off and running The logger program asks you to set the TT 8 s time as one of its first chores and you can use CrossCut s Send Date amp Time
31. with code that tests for an appropriate escape condition and calls the TT 8 library function ResetToMon which also bypasses the automatic startup You don t need to do that right now because in the next section we re going to load a flash application that will displace the miscreant logger program A18 D 6902 A Start a new project from CrossCut stationery New Projects CW will let you construct projects completely from scratch but you re better off working from existing Model 8 projects This way you don t need to spend weeks mastering all the complexities of the various CW compilation tools and the nuances of getting TT8 compatible object code to squirt out of a development system that wants to create applications for a Palm OS handheld Fortunately CW makes this particularly easy ee Project File Object 1 Choose New from the IDE File menu and you ll see something like the dialog at right 2 Click TT8 for CWPalms Stationery from the list of stationery groups 3 Type an appropriate name into the Project dE Empty Project Project name i Handspring Springboard Stationery MyFirstiewT T8Project iB Java Applet Wizard iB Java Application Wizard Location 4 Java Bean Wizard C Documents and Settings Joh S807 da Makefile Importer Wizard a Palm OS Application Stationery I Add to Project name box 8 Palm OS Application Wizard Project 4 Click the Set button and navigate to an TS Ta
Download Pdf Manuals
Related Search