- Builds the full, shippable firmware: the combined dual-boot hex (MinimalBoot + main) that CI produces and Releases ship, plus for TeensyROM+ the stock extension host as a separate
.TRHpackage npm run build:trfor plain TeensyROM,npm run build:tr-plusfor TeensyROM+- Requires Node.js (
.nvmrcpins the version) and no other dependencies; downloads a pinned, checksummedarduino-clion first run if one isn't already onPATH npm testruns the build tooling's own testsnpm run flashwrites the result to a TeensyROM over USB, checking first that the image is built for that cartridge (npm run flash -- --helpfor the options)- See Build-System.md for how this works, and the build skill for step-by-step use
- Builds and uploads one image at a time, not the full dual-boot firmware above
- Software tools & lib needed
- Arduino IDE 2.x
- Teensyduino app
- Install as directed in links above
- 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"
- The same for MinimalBoot.ino (/Source/Teensy/MinimalBoot): both images must present the same USB device, so a board passing through MinimalBoot keeps its COM and MIDI ports. It won't build with anything else.
- 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.
- Alternatively, you can generate a .hex file and put it on a SD/USB drive
- See FW update section of the General Usage doc
- Arduino IDE 2.3.10
- Teensyduino 1.61.0
- Note: 1.62.0 not recommended — its GCC 15.2.1 toolchain (up from 11.3.1) causes intermittent SD-read stalls with 2 PSRAM chips installed
- 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 — vendored in Source/Teensy/MinimalBoot/Common/USBHost_t36, pinned to upstream commit f943c4b; Teensyduino's bundled copy is not used
- NativeEthernet at version 1.0.5 — vendored in Source/Teensy/MinimalBoot/Common/NativeEthernet, upstream commit fe82aa7 plus local fixes, pinned to tag tr-pin-0747ad0 in a fork; Teensyduino's bundled copy is not used
- FNET at version 0.1.3
- EEPROM at version 2.0
- Time at version 1.6.1
- PN532 — vendored in Source/Teensy/src/PN532, trimmed from Seeed Studio's PN532 library; nothing to install
- Bounce (legacy)
- CRC32 at version 2.0.1
These steps are only needed if modifying the application menu assembly code running on the C64/128.
- Node (see
.nvmrc) - ACME Cross-Compiler 0.97 and, for TRCustomBasicCommands only, KickAssembler 5.25 with Java. The build finds them on your
PATH(or throughACME,KICKASS_JARandJAVA_HOME) and otherwise downloads a checksummed copy: KickAssembler on any platform, ACME on Windows and macOS (on Linux, install it with your package manager). Java is never downloaded. See Source/C64/README.md.
- Run
npm run build:c64(or double-clicktools/Build-C64.ps1on Windows) to complete the following- Regenerate
Menu_Regs.ifromMenu_Regs.h - Compile the main TeensyROM Code
- Compile the Cartridge loader executed on startup
- Compile the settings menu, help screens and the other bundled programs
- Convert each binary into a header file for the Teensy code, written straight into the Teensy directory
- Regenerate
npm run build:c64 -- --project MainMenuCRTbuilds just one program;--listshows the names- 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