Skip to content

Latest commit

 

History

History
62 lines (54 loc) · 2.67 KB

File metadata and controls

62 lines (54 loc) · 2.67 KB

TeensyROM software/firmware build instructions

Main TeensyROM C/C++ aplication

Software tools & lib needed

Build parameters/instructions

  • In the Arduino IDE
    • Load the Teensy.ino file from the /Source/Teensy directory
    • Tools menu item settings:
      • Board: "Teensy 4.1"
      • Port: Select target Teensy
      • Optimize: "Faster"
      • CPU Speed: "600 MHz"
      • USB Type: "Serial + MIDI"
    • Build the project and download directly to TeensyROM
      • TeensyROM needs to be powered by a C64/128 for programming since the Teensy USB power trace should be severed during assembly.
    • Alternately, you can generate a .hex file and put it on a SD/USB drive
  • Note: To do a full build including the minimal image for large CRT files, see this doc.

Latest Support tool/lib versions as of v0.7.1+ on 2026/03/08

  • Arduino IDE 2.3.7
  • Teensyduino 1.60.0
  • Included libraries
    • SD at version 2.0.0
    • SdFat at version 2.1.2
    • SPI at version 1.0
    • USBHost_t36 at version 0.2
    • NativeEthernet at version 1.0.5
    • FNET at version 0.1.3
    • EEPROM at version 2.0
    • CRC32 at version 2.0.0
    • PN532 (link above) last updated 9/12/2018

C64/128 6502 Assembly code

These steps are only needed if modifying the application menu assembly code running on the C64/128.

Software tools needed

Build instructions

  • Edit the "build8000CartBin.bat" file in the C64 directory
    • Set "toolPath" to an absolute path of the SW tools
    • Edit the following 2 variables to point to the associated tool directory
      • Relative, based on toolPath: "compilerPath", "bin2headerPath"
  • Execute the batch file to complete the following
    • Compile the main TeensyROM Code
    • Compile the Cartridge loader executed on startup
    • Convert the final binary into a header file for the Teensy code
    • Copy the updated header file to the Teensy directory
  • Any compile errors will cause early exit
  • Build information is displayed and files are created
  • Main TeensyROM application must be recompiled to incorporate header/code and load to Teensy module for execution

Back to main ReadMe