PPC680x0 QUICK GUIDE Good... Here we go then. Go to Workbench and copy the PPC680x0:Fonts/ directory into the SYS:Fonts/directory or simply double-click the 'install font' icon. Then copy the s/fprom.s file to the s: directory of your boot-partition and make the following assign: assign >NIL: PPC680x0: You can now double-click on the 'PPC68k' icon. After double-clicking on the PPC68k icon, you get a window with some buttons, strings, a scroller and a picture. Pressing any button will remove the picture and display all the project-information on the place of the picture. The buttons mean the following: Button 1 - two arrows: This means interleaving on/off. Interleaving means that the original 68k source-code file is placed throughout the file as comments. Default is on. Button 2 - r#13 : This button selects the stackpointer register. Default is r13 (the official stackpointer) but you can change it to r27 (=a7) to create a user-stackpointer with the size (in longwords) as selected in the 'stacksize a7' string. This will put a user-stack on bottom of the output source-code. (ds.l size) Button 3 - a7 sp : This means that (a7) is treated exactly the same as (sp). Default is on. When disabled, you can use (a7) as a general purpose register (if r13 is selected as the stackpointer). Button 4 - Wup : WarpUp goodies/PowerUp goodies. Default is WarpUp. Button 5 - Gpr : Display General Purpose Registers or Floating Point registers in the '680x0 register usage' part. Default is General Purpose Registers. You can switch in realtime. Button 6 - err : Display unknown errors or trash as ERRORUNKNOWN. When disabled, unknown errors or trash is ignored. A pushed button means no trash-error-reports. Button 7 - D : Process Directory. Allows you to (1) convert an entire directory, (2) learn all the files from a directory or (3) flush the learnfile. Pushing this button brings up a requester where you can select one of those three. Button 8 - 32 : Switch between 32/64-bits implementations. Default is 32-bits. Button 9 - 00 0 : Carry emulation on/off. Default is off. Button 10 - Rest : Rest emulation for divisions. Default is off. Button 11 - Stat : Status register/Condition Code register/ Lower-level emulation on/off. Button 12 - Frc : Force 32-bits addressing modes. Default is on. This selects if you want to use 32-bits addresses as standard when working in 64-bits implementations. This is useful if you are using a PPC processor with a 32-bits address-bus. Has no effect when working in 32-bits implementations. Button 13 - (disk 1) : ASL requester for source-file selection Button 14 - (disk 2) : ASL requester for destination-file selection Button 15 - M : Big Motorola M. Push to start converting Button 16 - Full : Full address loading or BAD address loading Button 16 - X=D : Emulate FPU .X by converting to .D (Default is on) Button 17 - CFG : Load/Save Config to/from any of the 6 slots Go to a file editor and load the non-reassembler example-file called 'freemem.68k' into any text editor. Put an incdir include powerpc/powerpc.i warpreq forceb above the source code. Then re-route the includes to the ppc include directory and remove the easystart.i include. Add the following instructions just before the first instruction to be executed: prolog 1024 head Then, change the last instruction to be executed (the 'returning' rts) into a 'lastrts' instruction. Finally add a 'tail' instruction underneath the source-code and save the file away. The file should now look like the 'freemem.ppc68k' file. Select the saved file as the input file in PPC680x0, and select an output file (ie 'Ram:output'). Press the 'M' button... You are now ready! Load your file with any editor or try to assemble it! The output code is Storm PowerAsm compatible and can be run after conversion. If assembling has some errors, go to the Trial And Error section.