Program the Tympan from a Single Hex File

What does a Hex file do?

When you program the Tympan using the Arduino IDE, it compiles the code into a hex file, then uploads it using the Teensy Loader app. That same hex file can be shared with others who can program their Tympan without installing the Arduino IDE or worrying whether they have the correct libraries installed. All that is required is the Teensy Loader app.

• Uploading a Hex File to the Tympan

• Exporting a Hex File from the Arduino IDE

---

---

Uploading a Hex File to the Tympan

1. Locate a hex file that you want to upload, such as the example: AudioPassThru.ino.TEENSY36.hex. To download, right-click then "Save as..."

• NOTE: The hex file must match the Teensy version that your Tympan uses.

2. Download and install Teensyduino. If you've programmed the Tympan before, then it should be already installed. There are options for Windows, Mac, and Linux. It is fine to select all the default options.

3. Locate the two applications we will use: teensy.exe and teensy_reboot.exe.

• On Windows 11, open %localappdata%\Arduino15\packages\teensy\tools\teensy-tools\

• On Windows 10, open C:\Program Files (x86)\Arduino\hardware\tools\

  
  
  

• On Mac, open Applications and control-click the Arduino icon. Then select Show Package Contents.

  
  
  

  Under Java/hardware/tools/, locate the two executables: teensy.exe and teensy_reboot.exe.

  
  
  

4. Connect the Tympan's USB port to your computer and turn it on.

5. Run teensy.exe. Open the hex file you want to upload: Select File->Open HEX File. You should see the file listed as the bottom of the Teensy Loader.

   

6. Click the "Auto" button, if it is not enabled.

   

7. Run teensy_reboot.exe. You should see the following sequence appear in quick succession.

   

8. If you don’t see the teensy window change, then you’ll need to open up the enclosure. Reattach the USB cable, turn the Tympan back on, then press the white Program Button.

   

Exporting a Hex File from the Arduino IDE

1. Open the Arduino IDE. (If it is not installed, then follow the instructions from Getting Started with Tympan).

2. Open the Arduino sketch you want to compile (File->Open). (If the sketch is a read-only example, then you will need to save it to a different folder.)

3. If you are using a Tympan, Rev-D, select the Teensy 3.6 Board:

   

4. Export a hex file by selecting Sketch->Export compiled Binary

   

5. The hex file will be saved inside your sketch folder. To open your sketch folder, select Sketch->Show Sketch Folder: