background image

Contents

6.5.6.  Limitations of the file-browser.....................................................................................................................41

6.6.  ML Monitor...........................................................................................................................................................42

6.6.1.  Features........................................................................................................................................................42
6.6.2.  Number formats............................................................................................................................................42
6.6.3.  Converting values.........................................................................................................................................43
6.6.4.  Commands....................................................................................................................................................43

6.7.  Online Help...........................................................................................................................................................45

6.7.1.  Keys..............................................................................................................................................................45

6.8.  System Info...........................................................................................................................................................46

7.  ChaCo, the Chameleon Control Software.................................................................................47

7.1.  Preparations...........................................................................................................................................................47

7.1.1.  Linux / macOS.............................................................................................................................................47

7.2.  Linux notes............................................................................................................................................................47
7.3.  macOS notes.........................................................................................................................................................47
7.4.  Overview...............................................................................................................................................................48

7.4.1.  Slot Management..........................................................................................................................................49
7.4.2.  Memory Access............................................................................................................................................49
7.4.3.  Debugging....................................................................................................................................................49
7.4.4.  Status display................................................................................................................................................49

7.5.  Examples...............................................................................................................................................................50

7.5.1.  Starting a core...............................................................................................................................................50
7.5.2.  Flashing a Core.............................................................................................................................................51
7.5.3.  Accessing memory.......................................................................................................................................52

7.6.  Command-line options..........................................................................................................................................55
7.7.  chacocmd..............................................................................................................................................................56

7.7.1.  examples.......................................................................................................................................................56

8.  Frequently asked questions.........................................................................................................57
9.  known Bugs and Limitations......................................................................................................57
10.  Reporting Bugs..........................................................................................................................57
11.  Developer information...............................................................................................................58
12.  Related projects.........................................................................................................................59
13.  Appendix.....................................................................................................................................60

13.1.  PS/2 Keyboard Key Assignment.........................................................................................................................60
13.2.  PS/2 Keyboard Joystick Assignment..................................................................................................................61
13.3.  CDTV Remote Control Key Assignment............................................................................................................62
13.4.  supported Cartridge types...................................................................................................................................63
13.5.  Opening the Cartridge.........................................................................................................................................64

13.5.1.  Chameleon v1.............................................................................................................................................64
13.5.2.  Chameleon v2.............................................................................................................................................65

13.6.  Re-programming the USB micro-controller.......................................................................................................66

13.6.1.  Chameleon v1.............................................................................................................................................66
13.6.2.  Chameleon v2.............................................................................................................................................68
13.6.3.  Linux..........................................................................................................................................................71

13.7.  configuring Quartus for JTAG............................................................................................................................72
13.8.  Chameleon breakout-cable pinout (Chameleon v1)............................................................................................79
13.9.  mini IEC cable pinout (Chameleon v2)..............................................................................................................81
13.10.  Technical Data...................................................................................................................................................82

13.10.1.  Turbo Chameleon FPGA Core.................................................................................................................82

14.  Credits.........................................................................................................................................83
15.  Fine print....................................................................................................................................84

3

Summary of Contents for Turbo Chameleon 64

Page 1: ...Turbo Chameleon 64 User Manual Draft Version Beta 9i 19 04 19...

Page 2: ...mounting images 17 5 3 Using cartridges 18 5 3 1 Cartridge slot organization 18 5 3 2 Mounting cartridge images 19 5 3 3 some notes on specific cartridges 20 5 4 using custom ROM images 21 6 Chameleon...

Page 3: ...7 7 chacocmd 56 7 7 1 examples 56 8 Frequently asked questions 57 9 known Bugs and Limitations 57 10 Reporting Bugs 57 11 Developer information 58 12 Related projects 59 13 Appendix 60 13 1 PS 2 Keyb...

Page 4: ...mber of times that the current state of the firmware is beta and we appreciate that you ve bought the unit anyway If you find any bugs please report them in our forum http forum icomp de This is where...

Page 5: ...er right corner breakout cable with connectors for USB power supply 80cm keyboard and mouse both PS 2 20cm IEC DIN 20cm a short user manual which you do not need any more now that you have found this...

Page 6: ...one A battery CR 1220 required to make use of the RTC feature is not included and must be supplied by the user See page 63 13 5 Opening the Cartridge Also not included is a mini USB cable since most...

Page 7: ...The Chameleon hardware will take about 2 Watts of power so make sure that your keyboard and mouse don t overload the power supply Most PCs don t have any trouble supplying Chameleon with power Note th...

Page 8: ...pen If you want to use ChaCo with the cartridge you also need to connect the mini USB cable to that PC see chapter 7 ChaCo the Chameleon Control Software For the second version of the chameleon you ne...

Page 9: ...Better double check before you apply power to the unit All C64 keyboards that we have encountered have been keyed There is no danger when plugging in the keyboard the wrong way round you will just obs...

Page 10: ...eleon or the mini USB connector at the bottom left second version of the chameleon Make sure that your power supply is strong enough With the docking station we recommend to use a 5V 1000mA power supp...

Page 11: ...ridge nor together with other cartridges It will only work if it s plugged directly to the C64 Don t experiment with combinations of cartridges It cannot work and you risk damage to valuable equipment...

Page 12: ...fail safe configuration skips booting from SD card and copying ROMs from C64 There seems to be a timing problem that makes copying ROMs from the C64 fail on some SX 64s this will result in a crash whe...

Page 13: ...his either in standalone mode or leave the Chameleon connected to your C 64 In addition to the files contained in the release archive the UPDATE directory may contain the following custom ROM files BA...

Page 14: ...of power many 500mA types are already at their limit with a Chameleon If possible use a 5 2V 1000mA type instead of 5V 1000mA However do not go over 5 2V for supply voltage 3 2 2 Using the flasher pro...

Page 15: ...YCLE YOUR CHAMELEON It may then give an error blink on the red LED but there s nothing to worry about Updating will fix it If the Chameleon does not start correctly please try the following Disconnect...

Page 16: ...into Chameleon that s purely for system purposes and hence can t be utilized by the user The flash carries FPGA cores and their respective ROM files The FPGA core is the true core of Chameleon s opera...

Page 17: ...t means that all mounted images for this drive will get unmounted and the selected image will become the first image in the list for the selected drive 5 2 3 Unmounting images To write changes made to...

Page 18: ...why you can use these cartridges after power up and without an SD card However it would be a waste of memory space to keep all the EPROM contents of all supported cartridges in the menu system They w...

Page 19: ...d which cartridge slot to use and the cartridge will be started Note that ROM files must be in a Chameleon specific layout which may be different from what you get from converting a CRT file to a flat...

Page 20: ...ents may change you may save the current contents by using the ROM saver see 6 5 2 User File menu below Easyflash The Flash ROM chip of the Easyflash is not emulated Instead if the EAPI signature is f...

Page 21: ...6 1 Boot Loader below or load the respective images through the file browser see chapter 6 5 File Browser Note that loading custom ROM images has several implications For example loading a broken ker...

Page 22: ...HAM64 KERNAL ROM C64 kernal ROM CHAM64 CHARGEN ROM C64 character ROM CHAM64 MMC64 ROM MMC64 BIOS ROM CHAM64 SLOT1 ROM Cartridge slot 1 ROM 1 CHAM64 SLOT2 ROM Cartridge slot 2 ROM 1 CHAM64 SLOT3 ROM Ca...

Page 23: ...g and to eventually recover from a broken boot loader and or menu system If you press the menu button to enter the menu after skipping the boot loader the result will be that the boot loader will run...

Page 24: ...TOP ESCAPE ESCAPE exit menu one level up Cursor up down Cursor up down PLAY STOP up down navigate up down Cursor left right Cursor left right REW FWD left right enter sub menu toggle item RETURN Enter...

Page 25: ...asic reset with all cartridges and expansions disabled F5 File Browser enter file browser see chapter 6 5 File Browser F6 Monitor enter machine language monitor see chapter 6 6 ML Monitor F7 Reset wit...

Page 26: ...options can will be changed when restarting see chapter 6 4 Options NOTE 6 4 Options 6 4 1 CPU Turbo Option Turbo Mode Enable turbo mode Turbo Speed Limit Set maximum speed if turbo is enabled Turbo d...

Page 27: ...3 Cartridges and Memory Expansions Option MMC64 Enable MMC64 emulation default Cartridge Set default cartridge slot used by reset with cartridge and with browser exec setup set to custom Cartridge Typ...

Page 28: ...f scanline shading to simulate the look of a CRT off 75 brightness 50 brightness 25 brightness VGA VIC II sync When enabled the VGA output is synced to the VIC II When used with 50 or 60 Hz modes this...

Page 29: ...always re maps all SID I O That means accesses are always intercepted at the address configured for SID Emulation and then in cartridge mode always routed to the addresses configured as SID Real Ster...

Page 30: ...ort When enabled always sort SD cards directories Browser start up Browser may start in 1 or 2 panel mode Browser charset The character set used by default Menu colour scheme Select menu colour scheme...

Page 31: ...e middle button is generally used as the freezer button A short button press shorter than 0 7 seconds will activate the freezer of an activated cartridge such as retro replay or the final cartridge 3...

Page 32: ...will be copied from the register s to the options when entering the menu by freezing so they can be changed after freezing and restarting does not alter them otherwise A Chameleon aware program should...

Page 33: ...n Cursor up down PLAY STOP Up Down navigate up down Cursor left right Cursor left right REW FWD Left Right choose left or right tab F1 F7 Page up down 1 7 page up page down F2 F8 F2 F8 2 8 start end o...

Page 34: ...e CBM R ALT R re read directory of active panel CBM S ALT S sort directory of active panel CBM M ALT M mount image file CBM U ALT U Unmount images CBM L ALT L load file CBM E ALT E load and execute fi...

Page 35: ...on create Directory creates a new directory create empty D64 creates an empty D64 file create empty G64 creates an empty G64 file 1 save Disk as D64 save contents of a mounted disk as D64 image 2 save...

Page 36: ...t be available if no disk has been mounted 3 Note that current limits of the drive emulation apply This item will not be available if no disk has been mounted 4 These items will not be available if GE...

Page 37: ...format crt CCS64 Cartridge Image Also see chapter 13 4 supported Cartridge types reu REU image geo GEORAM image rom ROM images koa Koala Paint image rpm Runpaint image cdu CDU Paint image blp Blazing...

Page 38: ...s reu load REU image geo load GEORAM image rom load ROM images koa view Koala Paint image rpm view Runpaint image cdu view CDU Paint image blp view Blazing Paddles image pmg view Paint Magic image art...

Page 39: ...l NOT mount the image it is located in and just load the selected file view action F3 Type Action koa view Koala Paint image rpm view Runpaint image cdu view CDU Paint image blp view Blazing Paddles i...

Page 40: ...om an IEC drive to a file switch to two panel mode CBM P then change to the drive panel and press F6 on any file 6 5 6 Limitations of the file browser MMC SD SDHC cards supported max medium size 32GB...

Page 41: ...switching edit binary character maps sprite maps edit CPU registers and I O registers to be set when you leave the monitor and then unfreeze 6 6 2 Number formats By default all numbers are interprete...

Page 42: ...ds a regular CBM DOS command where the SD card device can be used with the following i initialize re initialize the SD card cd change directory Change active working directory A single shows the direc...

Page 43: ...dr show edit memory mchar addr Show Edit chars msprite addr Show Edit sprite registers Show Edit CPU registers save file name start addr end addr 1 new start Save a block of memory to a PRG file If ne...

Page 44: ...t updated when time permits 6 7 1 Keys The help system can be controlled by the following keys buttons Key PS 2 Key Remote Function arrow left RUN STOP ESCAPE ESCAPE exit to main menu RETURN Enter ENT...

Page 45: ...leon Menu System 6 8 System Info The system info screen shows some basic information such as the menu software version the currently used FPGA slot the RTC time and some details on the inserted SD car...

Page 46: ...ping your password all the time you can change it to suid root like this sudo chown root root Chaco chacocmd sudo chmod u s Chaco chacocmd 7 2 Linux notes We currently provide a dynamically linked 64...

Page 47: ...ChaCo the Chameleon Control Software 7 4 Overview With a Chameleon connected ChaCo will open with this screen 47...

Page 48: ...lock Read memory Write Memory These will let you access the memory of the running FPGA core see chapter 7 5 3 Accessing memory 7 4 3 Debugging Start Boot loader Start boot loader of the USB micro cont...

Page 49: ...selected slot to 6 and click on the Start Core button The error message in the window reflects what you should see on Chameleon The red LED should blink seven times then pause then start over with bl...

Page 50: ...ster is for The first file you need to choose is the FPGA core the second file is the ROM file that belongs to the core These two files will be distributed with each Chameleon update Make sure to sele...

Page 51: ...Software 7 5 3 Accessing memory Now let s use ChaCo for some remote debugging Power up the Chameleon and then select reset with cartridge F7 followed by INSTALL FASTLOAD again F7 The VGA screen should...

Page 52: ...re Now in ChaCo enter address 0x400 and size 360 into the fields for memory access Then click on Read memory ChaCo will read the memory of the C64 into a file that you can save to your PC s hard disk...

Page 53: ...on Control Software In a second step we ll write back this same file to the C64 memory but to a different address Let s use address 0x590 Then click on Write memory and choose the file you ve just sav...

Page 54: ...ould be like this What you ve just done is to copy the first nine lines of the screen memory to lines ten and following of the C64 screen memory 7 6 Command line options ChaCo recognizes these command...

Page 55: ...dumpmem show memory dump readmem name read RAM to file writemem name write file to RAM dumpflash show flash dump readslot slot name read slot image to file readimage name read full image to file flas...

Page 56: ...wiki ChaCo_Bugs collects bugs in ChaCo http wiki icomp de wiki Chameleon_SD_Card_Problems lists a few problematic SD cards http wiki icomp de wiki Chameleon_Monitors lists some working and non workin...

Page 57: ...evelopers chameleon_schematics pdf Chameleon board schematics for FPGA core developers chameleon_fpga_pins zip a pin file that you can add to the Quartus qsf project settings file chameleon_v5_hwtest_...

Page 58: ...rojects This section of the manual has been removed to reduce maintenance Please refer to the Individual Computers WIKI http wiki icomp de wiki Chameleon for up to date information on related projects...

Page 59: ...F3 F3 F3 F4 F4 RShift F4 F5 F5 F5 F6 F6 RShift F5 F7 F7 F7 F8 F8 RShift F7 F9 F9 Pound F10 F10 F11 F11 Left cartridge button F12 F12 Middle Freeze cartridge button Print Screen Print Screen Right Res...

Page 60: ...Down Numeric 4 Joystick Left Numeric 6 Joystick Right Numeric 7 Joystick Left Up Numeric 8 Joystick Up Numeric 9 Joystick Right Up Take note that it is possible with the keyboard to press both Joysti...

Page 61: ...0 Space bar ESCAPE Left Arrow ENTER RETURN REW CRSR Left RShift CRSR Right PLAY PAUSE CRSR Up RShift CRSR Down FF CRSR Right STOP CRSR Down GENLOCK Left Push Button CD TV Middle Push Button Freeze Men...

Page 62: ...ermann 15 C64 Game System System 3 1 16 Warpspeed 17 Dinamic 1 18 Zaxxon 19 Magic Desk 1 20 Super Snapshot v5 21 Comal 80 23 ROSS 28 Mikro Assembler 31 Stardos 32 Easyflash 1 34 Capture 36 Retro Repla...

Page 63: ...Chameleon v1 Use the flat screwdriver as a lever Be sure not to touch the Chameleon board only the case must be touched There will be no warranty for scratched boards Use the zoom function of your PD...

Page 64: ...oam on your cartridge may look different 13 5 2 Chameleon v2 Opening the second version of the chameleon is much easier since the new cases are held together by a screw instead of plastic clips Simply...

Page 65: ...er to run the tool as root otherwise it will not get access to the USB port You can easily find FLIP using Google URL not given here as links might change in the future FLIP is the same for a large fa...

Page 66: ...eon and the mini USB connection is your data connection Now place the micro controller into de brick mode with the following combination of button presses Press and hold the left button then press the...

Page 67: ...is not populated on the second version of the chameleon In case of emergency the existing solder joints can be connected eg with a paperclip Now make two USB connections to your PC and switch on the...

Page 68: ...Appendix Then release the right reset button but keep on holding the left button As the last step release the left button 68...

Page 69: ...After programming the micro controller FLIP will indicate the successful steps with a green light next to the action tags Note The checksum may be different for a possible update That s it the micro c...

Page 70: ...dfu programmer http dfu programmer sourceforge net may be used sudo chacocmd bootloader sudo dfu programmer at90usb162 erase sudo dfu programmer at90usb162 flash chameleon_microcontroller hex sudo dfu...

Page 71: ...ring Quartus for JTAG Drivers are needed for the USB Blaster they can be found in the Quartus II installation directory quartus drivers usb blaster Click Hardware settings and select USB Blaster from...

Page 72: ...tings won t work because there s another device on the JTAG chain the flash chip so to solve that Click the Autodetect button to reveal the second device You ll also be asked whether the FPGA is an EP...

Page 73: ...Appendix When using the Chameleon v2 there will be only one JTAG device select the 10CL025Y 73...

Page 74: ...f the EP3C25 and click the Change File button or double click the none in the File column of the EP3C25 s line in the top panel Pick the sof file in the file dialog Check the Program Configure checkbo...

Page 75: ...ck the Change File button or double click the none in the File column of the 10CL025V s line in the top panel Pick the sof file in the file dialog Check the Program Configure checkbox in the 10CL025V...

Page 76: ...ow Quartus will offer to save changes to the device chain so you don t have to repeat this procedure each time you program the device Unfortunately saving will fail while the extra device is classed a...

Page 77: ...ndix In the dialog that appears the Unknown device should already be selected so just click Edit and change the name to something else Quartus should now be able to save the device chain for future us...

Page 78: ...r for RM158 DN508H 9 Pin numbering is taken from drawing CN2 and CN3 are coloured female Mini DIN6 connectors purple CN2 green CN3 shield GND shield GND 1 KDat 1 MDat 2 NC 2 NC 3 GND 3 GND 4 Vcc 4 Vcc...

Page 79: ...AWG26 cable length 200mm CN1 CN3 shield shield and pin 3 pin 3 pin 1 pin 5 pin 5 pin 6 pin 4 Connection CN1 to CN4 is a 4 core shielded AWG26 cable length 200mm CN1 CN4 shield shield and pin 2 pin 1...

Page 80: ...T CN2 is a male DIN6 connector 240 degrees angle shield GND 1 IEC_SRQ 2 GND 3 IEC_ATN 4 IEC_CLK 5 IEC_DAT 6 Reset Connection CN1 to CN2 is a 5 core shielded AWG26 cable CN1 CN2 Signal Name Shield Pin...

Page 81: ...TV remote control Connector for RR NET USB link to a PC for debugging and data transfer 13 10 1 Turbo Chameleon FPGA Core Turbo function with full 6510 processor compatibility incl illegal opcodes REU...

Page 82: ...macher Menu System ChaCo user manual Stefan Seitz USB Micro controller code first version of ChaCo Andreas Postler case modifications other manual steps in production Andreas Muttke logo design Christ...

Page 83: ...f their respective trademark holders None of these trademark holders are affiliated with Individual Computers Windows is a registered trademark of Microsoft Corporation in the United States and or oth...

Reviews: