- TeensyROM connections and Menu button
- Main Menu Options-Navigation
- SD Card or USB Drive Setup
- Loading files and emulating ROMs
- The Settings Menu
- Selecting and associating Special IO
- Firmware updates
- Troubleshooting
- With the power off, attach the TeensyROM to the Expansion port of your Commodore64 or 128 machine
- Power on, the TeensyROM main menu should be displayed
- The Menu button can be pressed at any time to return to the TeensyROM main menu from another program
- Additional external hardware connection points:
- (as of FW v0.9.1)
- Menu navigation: Use the keyboard or a Joystick connected to Control Port 2
CRSR or Joystick Up/DownMove cursor up/down the list of files on the currently selected source deviceCRSR or Joystick Left/RightPage up/down the list of filesReturn or Joystick Fire buttonSelect/run the highlighted file or enter sub-directory
- Additional Keyboard commands:
Up ArrowUp 1 directory levela-zSearch current directory for first item beginning with letter pressedHomeMove cursor to first item in directoryLeft ArrowWrite NFC Tag that will launch currently highlighted file?Write NFC Tag that will launch a random file from the currently selected Directory<Shift-A>Set Auto-Launch to currently highlighted file<Shift-M>Transfer/Mount/Launch highlighted .Dxx file via attached Meatloaf device- Requires Meatloaf using latest FW connected to the TR USB Host port.
<Shift-K>(TR+ only) Set highlighted file as the Kernal Replace image<Shift-R>(TR+ only) Set highlighted file as the REU pre-load/save imageINST/DELDelete the highlighted file from the SD card or USB drive (asks for confirmation first)1-5Programmable Hot Keys to immediately launch a specified file- Defaults:
1Cynthcart,2Station64 (TR+ default: REU-Checker v1.0),3CCGMS,4TeensyROM ASID Player,5Jupiter Lander CRT
- Defaults:
!-%(Shift1-5) Set corresponding Hot Key to currently highlighted file (on any media source)F1Display files stored in Teensy Memory via firmwareF3Display files on an attached SD cardF5Display files on an attached USB DriveF7Show Help Menu (2 pages: navigation/source keys, and per-file select options)F2Exit to regular BASIC startup screen, TeensyROM deactivated- Re-activate TeensyROM by pressing button
F4Toggle background SID on/offF6Show SID InformationF8Show Settings Menu
- Screen contents:
- File Source and dir path is shown in the upper left corner
- Page number and number of pages is shown in the lower right corner
- Current time is shown in the upper right.
- Time is synched to the Teensy integrated RTC
- If an RTC battery is present (built-in on TR+, or added to TR via battery mod), the time should be correct, no Ethernet needed.
- Optionally, the time can be automatically synced via Ethernet on startup (see settings).
- If neither of these are available, time can be set manually in the settings menu, or just let it start at midnight.
- File type is to the right of each file/dir displayed. If "Unk" (unknown) then it is not a recognized/supported file type.
- A file on the SD card whose extension an installed extension package (in
/VMS) claims shows the first three characters of its own extension instead, such as "MPE". - '+' in front of file type means it is pre-associated with Special IO emulation needed for function (MIDI, Swiftlink network)
- A file on the SD card whose extension an installed extension package (in
- Quick Help is displayed at the bottom of the screen, use F7 for detailed help screen.
- General info/configuration
- No TR firmware is stored on these external drives, so they are not required to start using your TeensyROM and all of its firmware-bundled programs.
- SD Cards are somewhat favored over USB drives as they have slightly faster access times.
- 32GB SD cards typically give the fastest directory read times
- We've seen some issues with USB (or SD) drives with non-standard partitioning of the drive, especially manufacturer default partitions.
- If you have issues reading drive contents via the TR, try deleting the existing partition(s) (either via the 'diskman' Disk Management gui or using 'diskpart' and 'clean' via command line) then re-partition. After that, re-format in either FAT32 or FAT16 and load files.
- Recommended Files/Games/SIDs
- The OneLoad64 Games Collection (v5) is a wonderful (and free) source for thousands of files/games in CRT format, which is perfect for the TeensyROM
- The High Voltage SID Collection contains over 50,000 SID files, most of which are directly playable on the TeensyROM.
- There's a great collection of Single Load Demos located here.
- Here's a .zip of files/programs that highlight TeensyROM+ capabilities.
- We recommend adding this autolaunch.txt file to the root of an SD card in case you want to set up your TeensyROM as an unprompted diagnostics cartridge in the future.
- Here are a couple scripts that copy all of the above referenced files to an SD Card
- Cross platform MAKEFILE by The JEEP
- Or use this Windows PowerShell Script
- TeensyROM+ owners: add the Mean Hamster Power Engine (MPE) Host Extension and its game system VMs (NES, Game Boy, Game Gear, Tritari, Doom and more) to play games never released for the C64.
- Licensed material isn't included with MPE or its VMs: game ROMs and original game files for the MPE/VMs are yours to obtain as needed.
- Files can be launched from any of the available sources, including any subdirectory
- When a file is selected, load/run status is displayed on the screen. Usually this will flash by too quickly to read, but in the case of an error, it will pause to provide additional information.
- File types supported:
- .PRG and .P00 files:
- Super fast-loads any PRG into C64/128 RAM and executes
- Same result as LOAD"file",x,1 and RUN (but much faster)
- Must be single PRG file, not multi-part
- Super fast-loads any PRG into C64/128 RAM and executes
- .CRT files:
- Emulates/supports most popular cartridge types:
- All 8khi, 8klo, 16k, and C128 "Generic" carts
- EasyFlash, Magic Desk, Ocean, Dinamic, Zaxxon/Super Zaxxon, GMod2
- Epyx Fast Load, Game System 3, SuperGames, FunPlay/PowerPlay, Magic Desk 2
- Ethernet (Swiftlink/Turbo-232), MIDI (Passport, Datel, Sequential, & Namesoft)
- Action Replay, Retro Replay, Final Cartridge III, Super Snapshot V5 (freezer carts, TR+ only)
- Additional CRT support info
- Files larger than 850KB will automatically employ a bank-swap scheme
- These files must be run from an SD Card (not USB Stick)
- Uses "old school" REU type of DMA assertion for fast pausing and no additional CPU execution
- This method will not work on some systems (Most C128s and a low percentage of NTSC systems)
- DMA Pause check utility included in Test+Diags dir to test specific system DMA reliability
- Many large CRT files have been tested with this scheme, all are working smoothly (as long as host C64 passes DMA check)
- See full CRT implementation details here.
- On rev 0.2x PCBs, when using the C128 to emulate "Ultimax" carts (Deadtest, Jupiter Lander), some screen artifacts are visible.
- This issue only impacts Ultimax CRTs on C128s and is resolved in PCB rev 0.3
- EasyFlash images up to 4 MB (256 banks) are supported. Large images use the SD card bank-swap scheme above, so they must be launched from SD.
- EasyFlash EAPI not currently supported
- Files larger than 850KB will automatically employ a bank-swap scheme
- Emulates/supports most popular cartridge types:
- .SID files:
- Play SID file: ~90% of known SID files are supported
- Adjusts playback speed based on machine and SID type (NTSC/PAL)
- SID info screen contains SID header information and playback controls
- .KLA/KOA files:
- Displays Koala multi-color picture
- Compatible with output from Retropixels online
- .ART/AAS/HPI/OCP/PIC files:
- Displays Art Studio Hi-Res picture
- .TXT/NFO/MD files:
- Displays ASCII text in the TR text viewer
- See viewer usage/navigation doc via TR on your C64 in the /Text+PETSCII+Docs directory.
- .SEQ files:
- Displays PETSCII directly in the TR text viewer
- Compatible with SEQ output from lvllvl.com and petscii.krissz.hu
- See viewer usage/navigation doc via TR on your C64
- .D64/.D71/.D81 files:
- Single File load/exec only (no multi-file/writebacks)
- Exception (FW 0.9.1 and later): GEOS 64 and GEOS 128 boot from a .D81 boot disk in
/GEOS64and/GEOS128with full disk read/write. See GEOS 64 on the TeensyROM and GEOS 128 on the TeensyROM.
- .HEX files:
- Used for TeensyROM firmware updates (see below)
- .PRG and .P00 files:
- (as of FW v0.9)
- Accessed via
F8from the main menu. Organized into indexed pages — settings changes take effect live and are stored in EEPROM (recalled on power-up). - Shared navigation, works from any page:
CRSR Left/RightPrevious/Next page1-9,0Jump directly to a page (see page # below)F1Reboot TeensyROM (applies any power-up-only settings)Space BarReturn to Main Menu
- Lists every page below for quick-jump access
- Emulation Selections:
a/ACycle forward/backward through available Special IO to apply when launching a PRG/CRT (see Selecting and associating Special IO)- Current Kernal Replace file is shown (TR+ only) — select via
<Shift-K>from the file browser - Current REU Pre-load/save file is shown (TR+ only) — select via
<Shift-R>from the file browser
- Current Kernal Replace file is shown (TR+ only) — select via
- User Interface/other:
bCycle Serial device connected to USB Host Port: None, NFC Reader, or TR Controller- Selected device is initialized on power-up/reboot
cCycle Alt Button action (TR+ only):AutoLaunch(default),Pause/Unpause,TR Menu,Reboot TR, orNone- Only active when the button isn't already in use by a freezer cart or REU
d/DIncrement/Decrement Joystick 2 repeat speed for menu navigationeToggle Show File ExtensionsfToggle External Reset Detect (TR+ only): when on (default), an external reset (C64 reset button, User port, etc.) returns to the TeensyROM menu, as if the TR menu button was pressed- Turn it off when an external reset shouldn't return to the TR menu, such as when getting into C128 BASIC
gToggle TR+ REU with RetroReplay, SuperSnapshotV5, and Final Cartridge III 101% (TR+ only)- On (default): those carts launch with the TR+ REU alongside them. A short press of the Alt button freezes; holding it 700 ms or longer saves the REU image
- Off: they launch as the plain cartridge, with no TR+ REU
- Only FC3 CRTs flagged as the REU-compatible 101% version (CRT subtype 1) get the REU
- On Main Menu Startup:
aToggle Play selected SID on startup (file shown; select from the SID Info page)bToggle Enable TCP Listener on port 2112 of the current IP, for remote control — see ControlComms.mdcToggle Synch RTC via net on startup (Ethernet NTP time sync — see Main Menu Options-Navigation for how this interacts with a battery-backed RTC)
- On TeensyROM Boot/Power-up:
dToggle Auto-Launch Enable (file shown; select via<Shift-A>from the file browser)
- Individual colors, each cycled through the 16 C64 colors:
a/AScreen Backgroundb/BScreen Borderc/CTop of screen banner colord/DTime Display & Headingse/EInput key option indicatorf/FGeneral text/descriptionsg/GFile names & Values
- Presets:
hTR DefaultiBlack & WhitejC64 MonokCGAlThe BluesmRainbow
ReturnApply the selected colors
- Only message types marked "On" are passed through to the C64/128 — useful for DAWs or MIDI controllers that send extra packets that can overwhelm some C64 MIDI software (such as Cynthcart)
- Packet types to transfer, each individually toggled on/off:
aNote Off/On (8x/9x)bAfterTouch Poly (Ax)cControl Change (Bx)dProgram Change (Cx)eAfterTouch (Dx)fPitch Change (Ex)gSystem Exclusive (F0)hTimeCode QuarterFrame (F1)iSong Position (F2)jSong Select (F3)kTune Request (F6)lReal Time System (F8-FF)
- Format/Location:
aToggle 12/24 hour clock displayb/BSet local Time Zone (UTC offset, half-hour increments)
- RTC Adjustment:
cSynch RTC via Ethernet now (also displays the local IP address)d/DRTC Hours down/upe/ERTC Minutes down/upf/FRTC Seconds down/up
- Current Ethernet IP Values: IP Address, Gateway IP, Subnet Mask
aInitialize/re-init Ethernet connection
- TeensyROM/Machine info:
- FW version and build date/time
- Teensy clock speed and internal temperature
- Unique Teensy hardware ID (also shown via the Version Info remote command — see ControlComms.md)
- Detected C64/128 clock rates (PAL/NTSC and CIA TOD) — handy for confirming what machine video/mains power standard the TR sees
- General Settings: MAC Address, IP Type (Static/DHCP)
- DHCP Specific: DHCP Timeout, DHCP Response Timeout
- Static IP Specific: Static IP, DNS IP, Gateway IP, Subnet Mask
- This is a read-only display — to modify these values, use a terminal program (such as CCGMS) and the
AT?command for help. See Ethernet Usage.
- Shows the currently assigned file for each of the 5 programmable Hot Keys (#1-5)
- Reassign from the main menu file browser using
!/"/#/$/%(Hot Keys 1-5 respectively)
- Shows the name of the installed extension, or "None installed"
- Extensions are optional add-ons, distributed as
.TRHfiles. TeensyROM works normally without one - See TR Host Extensions for what they are and how to get them
- To install: copy the
.TRHfile to SD or USB and select it in the file browser - Firmware updates keep the installed extension
- Extensions are optional add-ons, distributed as
- Lists the file types registered on the SD card: one row per registration folder in
/VMS, with the file types it claims*another folder claims the same file type, so neither opens it;xthe folder couldn't be read;!it wouldn't launch: its module or client file is damaged or missing, or the installed extension can't run it- Rows below the list say what stops a launch, then how the last launch went. See TR Host Extensions
uUninstall the extension (yto confirm). TeensyROM restarts afterwards- Also use
uif the page saysNone installed; slot not blank.That means an earlier install or uninstall didn't finish
- Also use
- Important Uninstall any extension before loading an older firmware without extension support. That firmware can't update itself while an extension is installed
- What is it?
- "Special IO" in this context means additional HW that is emulated to assist with SW function.
- This emulation runs at the same time as a selected program/cartridge
- Examples of these are Swiftlink/Modem, and MIDI interfaces
- This HW uses the IO1 ($DE00) address space and interrupts to pass information to/from the program running on the C64/128.
- How is it used/selected?
- The easy method is to use the software supplied with the TeensyROM with a '+' sign in front of the type.
- These will automatically associate the needed IO to emulate Swiftlink Internet or the required MIDI interface.
- This includes the following, for example:
- CCGMS Terminal Pre-configured and associated with Swiftlink interface to Ethernet connection
- Cynthcart Associated with the Datel MIDI interface to USB MIDI Host/Device
- Station 64 Associated with the Passport MIDI interface USB MIDI Host/Device
- Special IO can also be selected in the settings menu
- This setting will be applied at the time of launching any program or generic cartridge
- The setting stays in memory and will be re-loaded for any app until changed
- We recommend disabling NFC if Special IO is selected to avoid interference.
- If a selected CRT file is associated with different Special IO (i.e. Epyx, EasyFlash etc), that Special IO will be loaded instead
- The easy method is to use the software supplied with the TeensyROM with a '+' sign in front of the type.
- RAM expansions:
- GeoRAM: Berkeley Softworks geoRAM, 128K to 512K (as much as fits). Its window is at
$DE00and its registers at$DFFE/$DFFF. The TeensyROM's USB mouse and block device registers sit beside it at$DF00.- Loads
SD:/georam.ramat launch. (TR+ only) Press and release the Alt button to save it there; the previous save is kept asgeoram.bak.
- Loads
- 512KB REU (TR+ only): a Commodore REU (1700/1764/1750) at
$DF00, 128K to 512K (as much as fits).- Loads the REU pre-load/save image at launch (choose it with
<Shift-R>in the file browser). Press and release the Alt button to save it there.
- Loads the REU pre-load/save image at launch (choose it with
- REU+USB Mouse/Disk (TR+ only): the same REU at
$DF00, with the USB mouse and block device registers moved to$DE00. The REU's unused registers read$FF, as a 1764's do.
- GeoRAM: Berkeley Softworks geoRAM, 128K to 512K (as much as fits). Its window is at
TR and TR+ have separate firmware files, so first pick the one for your hardware:
- TR (PCB v0.2–0.3):
TeensyROM_<version>_full.hex - TR+ (PCB v0.4):
TeensyROM+_<version>_full.hex- A TR+ shows "+" in its banner and title (e.g. "TeensyROM+ v0.9"), if you're not sure which you have
- The menu-based updates below (SD/USB and Ethernet) refuse a file built for the other board
- The TeensyLoader application doesn't check, so take care to load the right file with it
- Firmware older than 0.4 can't update from SD/USB (0.5.8 for Ethernet); use the TeensyLoader method once
There are multiple ways to update the TeensyROM firmware, choose one of the following:
- Get the .hex file containing the latest major (x.x) or minor (x.x.x) release from the releases page
- Copy the file to a USB Thumb drive or SD card
- This can be done by the traditional method of moving the card to a capable computer
- Or directly from your computer using Trom UI or Trom Terminal from the cross-platform TeensyROM Suite
- In the TeensyROM USB or SD Menu, select the Firmware .hex file
- A new screen will open and ask you to confirm that you want to update
- Check that the file name shown is correct
- 'y' to confirm/continue, 'n' to abort
- The update process takes about 2 minutes and goes through several stages.
- Important You must leave your C64/128 powered up during the update
- Interrupting this process could render your TeensyROM unusable
- When the update completes successfully, your computer will reset and the new version of TeensyROM will be shown
- If there are any problems, take note of any messages shown before pressing any key to return to the main menu.
- Digitalman uses a similar approach in this video
- Connect active Ethernet cable to TeensyROM
- An inserted SD card (preferred) or USB Thumb drive is also required
- Open CCGMS from the main menu and type "atbrowse"
- There are two sites hosting TeensyROM firmware updates, use one of the default bookmarks to enter either of them
- Bookmark #1 is for the TinyWeb64 site, entering "b1" will take you to sensoriumembedded.com/tinyweb64
- Bookmark #2 is for Digitalman's site, so "b2" to go to digitalman.azurewebsites.net
- Alternatively the 'U' command will also work: "u sensoriumembedded.com/tinyweb64"
- From the main menu, the Firmware download section is link #6 on TinyWeb64 and link #5 on Digitalman's site
- Choose the link # for the FW version you want to download/install
- The FW file will take a minute or two to download, dots shown on screen to indicate progress
- Use the "d" command to see the local downloaded files directory.
- Choose the link # of the firmware .hex file downloaded in the previous step to directly launch the update.
- Check the version and confirm as described in the section above.
- Get the .hex file of the latest released version from the releases page
- Download and install the Teensyduino/TeensyLoader app
- Teensyduino requires Arduino to run, which works fine.
- Alternatively, the Teensyloader stand alone file can be downloaded via a link further down the page
- Launch the Teensyloader/teensyduino app (teensy.exe)
- Select File, Open HEX File and select the saved TeensyROM .hex file
- Connect the TeensyROM to your computer with a USB A to microB cable.
- Plug the TeensyROM into your C64/128 and power it up to the main menu
- Press the white button on the Teensy module itself, as shown in the app
- If TeensyROM is in its case, a straightened paperclip through the small access hole reaches the button — no need to open the case
- The process only takes a few seconds to complete
- Important You must leave your C64/128 powered up during the update
- This is electrically safe by design — the C64 just won't be usable again until the update finishes
- Important You must leave your C64/128 powered up during the update
- You should see the app process through erasing and programming before your C64/128 reboots with the new version
- See the Software build document:
npm run build:tr/build:tr-plusbuilds the full firmware, andnpm run flash -- --hex <file>writes it, or any release .hex, over USB, refusing a file built for the other board
- Check settings to be sure no other devices (such as a SID/UtiliSID or ACIA/Swiftlink mapping) are using the IO1 ($DE00) location. Some CRTs emulated by the TR can use the IO2 ($DF00) range as well.
- Set
Cartridge PreferencetoExternalandBus Operation ModetoWrites(in C64 and Cartridge Settings). Required for TR+ DMA features and safe for any TR. See C64 Ultimate Enhancements
- To set all EEPROM values back to default settings:
- With C64 off, press and hold down menu button on the TeensyROM
- Power up the C64 (nothing will be displayed)
- Keep TR menu button pressed for ~10 sec, until the LED starts blinking
- Release the TR Menu button and wait for the TR menu to be displayed
- TR EEPROM settings are now reset to default
- For additional support, please consider joining the TeensyROM Discord
- Or contact Travis directly via e-mail.
