Factory Reset After Uploading Your Own Code

We’ve built our trackr boards to be hackable, you can write your own code and upload it to your board as needed, displaying your own data, or changing the way you display our data.

However, at some point you may want to reset the board to it’s factory firmware, here’s how you do it.

Disclaimer: We can’t fully support boards when new firmware has been uploaded, and can’t guarantee that you’ll be able to factory reset. We’ll help point you in the right direction, but in the event your ‘brick’ your board or can’t get the below code working you may need to send your board back to us for a firmware upgrade.

First you’ll need to install the Arduino IDE and the ESP8266 board files, these can be found here:

We don’t provide access to our firmware directly, but give you a simple sketch that will connect to our servers and download the most recent firmware to your board.

The code for this can be found here: https://github.com/Traintrackr/base_firmware_updater

There are further instructions listed at the top of the Arduino sketch. You’ll need your WiFi SSID, WiFi password, and an update code from us to authorize the server update.

Send us an email if you need to update your board and we’ll send you the details you need.

Reprogramming Your Trackr

We designed our trackr boards to connect to our servers, access our processed data, and then display that on the onboard LEDs.  Collecting this data in most cases isn’t easy, so we’ve done the hard work for you. All you need to do is enter your setup code (which comes with each board) + WiFi password and you’re away.

However as hackers ourselves, we realize that some of you may want to take matters into your own hands when it comes to the data, especially if you want to display something different, or data of your own.  So we’ve made it easy for you to reprogram the board, allowing you to display whatever you want.

Disclaimer: We can’t fully support boards when new firmware has been uploaded, and can’t guarantee that you’ll be able to factory reset. We’ll help point you in the right direction, but in the event your ‘brick’ your board or can’t return the firmware to it’s default state you may need to send your board back to us for a firmware upgrade.

One option is to use the Arduino IDE, with ESP8266 Core installed.  This will allow you to program the ESP8266, which is the main microcontroller on the board.  

Standard 0805 LEDs

Some of our boards come with standard 0805 LEDs driven by the HT16K33 LED driver chip, to drive this you’ll need to use a suitable library.

Addressable WS2812-mini LEDs

If you are trying to reprogram one of our boards with onboard RGB LEDs (WS2812-mini) you’ll need a library that can speak to those LEDs.

The hardware side of programming your board is easy, we’ve included a USB to UART chip (CP2104) onboard, so all you need (apart from your computer and the board itself) is the USB cable that came in the box. 

Programming Steps

  • Write your code in the Arduino IDE and make sure it compiles
  • In the board manager select ESP8266
  • Holding the onboard ‘Flash’ button, connect your board to your computer via USB
  • Release the flash button
  • Make sure you have the correct port selected, it will look something like SLAB_USBtoUART
  • Upload to your board

We’ve put together a very simple Arduino sketch to get you started with the basics, it’s then up to you to write some code and make something amazing.

Schematics and basic firmware can be found here: https://github.com/Traintrackr/board_files

If you need to reset your board to it’s original firmware, you can find our instructions here

Let us know how you get on with your boards, we’d love to see what you do with them.