Skip to content
mxmxmx edited this page Mar 20, 2017 · 53 revisions

firmware

  • the steps below assume you have cut the Vusb trace on the teensy board.

  • you'll need: a micro usb cable.

  • to get the firmware onto teensy, you can either use the teensy loader application + precompiled hex file (from here) (in ~/eurotrash_mkII/soft/) (‡), or ....

compile it (yourself):

1) IDE, libraries:

  • If you don’t have it already, you need to install the Arduino software (1.6.x) as well as the teensyduino add-on (1.2x). Make sure you install the latest version as well as the pjrc Audio library (you’ll be prompted on install to choose from several available libraries). You can also get it from github (recommended). clone it, or download the zip (bottom right of the page) and use the "library manager". (Sketch > Include Library > Add .ZIP Library)

2) eurotrash code:

  • clone the repository or, from the eurotrash_mk2 github, download the zip and unzip it, say onto your desktop. the repo contains the sketch and a few libraries: u8glib, RotaryPlus, SerialFlash and i2c_t3 (ie these libraries.); move those libraries into your ~/Arduino/libraries folder, as above (see step 1).

3) overclock:

  • prepare to overclock: find and edit the file called boards.txt; uncomment the line that says

    teensy31.menu.speed.120opt=120 MHz optimized (overclock).

  • on OSX, boards.txt can be found in your Arduino.app folder:

    /Applications/Arduino.app/Contents/Java/hardware/teensy/avr/boards.txt.

  • (NB: that path will be slightly different on other OSs, of course).

4) PJRC audio API mods:

  • in real life, we can’t use the official pjrc audio API (yet) unfortunately, because it doesn’t support everything we need. so we need to change/replace a few tiny things:

    • to do so, go to the ~/eurotrash_mkII/soft/libraries/Audio folder.

    • in total, there's eight files in that folder. copy them into your (actual) Audio library folder (wherever it lives / you put it), that is: replace/overwrite the existing files (of that name).

    • now, close and restart the Arduino app. from within the app, open the eurotrash_mk2.ino sketch located in ~./eurotrash_mkII/soft/eurotrash_mk2. things should look somewhat like so:

5) compile + upload:

  • You should now be able to compile + upload the eurotrash firmware.
    • again, make sure you have selected Teensy 3.2/3.1 in the Tools>Boards tab.
    • also make sure to select CPU Speed: 120Mhz optimized (overclocked) (in Tools>CPU Speed).

6) calibration.

  • before actually trying to use it, don't forget to calibrate the module!

(‡) i haven't tried this myself lately; if the stand-alone app doesn't work, install the arduino IDE and teensyduino; this will also install a working loader application. simply open the IDE, choose Board: Teensy 3.1, and press compile, which will open the loader app. in the app, go to File > open HEX File. open eurotrash_mkII.hex and upload.