Loading Software - doudar/SmartSpin2k GitHub Wiki

How do I load the software on the ESP32?

This guide will walk you through how to flash your SmartSpin2K and how to apply firmware updates manually. The flashing instructions will help you get started for a new build, or in case you're troubleshooting something and want to completely reset your device. Manual updates can be applied using your browser - this is used for flashing test builds that have not been released through the Over The Air update service.

Instructions for compiling through your IDE are below

Updating your existing firmware

You will need the The latest SmartSpin2K firmware .

  1. Download the latest SmartSpin2kFirmware-xx.xx.xx.bin.zip
  2. Unzip the contents - you'll need the firmware.bin
  3. Access http://smartspin2k.local on your browser
  4. Select Update Firmware
  5. For both Username and Password, enter "admin"
  6. Choose firmware.bin (ensure the filename exactly matches this)
  7. Click Update
  8. Once updating is complete (the progress bar shows 100%), the SS2k will automatically reboot.
  9. You can then check the installed firmware version at the bottom of http://smartspin2k.local/index.html

Flashing with SmartSpin2K Flasher (First time installations or for troubleshooting)

We have tried to make these instructions accessible and approachable for most levels of technical comfort

You will need:

  • Micro USB cable
  • Drivers for flashing the microcontroller. Instructions to verify if you need drivers and links to install the latest are provided by Espressif. You will most likely need the CP210X driver in the link provided.
  • SmartSpin2K Flasher
  • The latest SmartSpin2K firmware - you need firmware.bin

Flashing the SmartSpin2K firmware

  1. Connect a Micro USB cable to your computer and your SmartSpin2K (You do not need the power cable for this)
  2. Start SmartSpin2KFlasher.exe

  1. Click the serial port dropdown and select your SmartSpin2K - it will appear as COM# (the number may vary)

  1. Click Browse and find your firmware.bin file from above

  2. Click Flash ESP

  3. The ESP32 Microcontroller will be flashed with the firmware and the logger will immediately start showing data if flashing was successful:

If you experience an error while flashing

  1. There's a pair of holes next to the arm and USB port. You'll want to access the one on the left of the USB port when you're looking at the back of the device as pictured below. Stick it in, make sure you can press the button (you'll feel the click). Leave this in place for the next step. If you don't have a small enough tool, you will need to disassemble your SmartSpin2K to gain access to the PCB. Disassembly is outside the scope of this article.

  1. While pressing the button described above, insert the USB cable into the SmartSpin2K. You can release the button after a second or two.

  2. Repeat steps 2-7 above

If you are a developer and want to use the IDE

  1. Install Microsoft Visual Code. https://code.visualstudio.com/
  2. Install PlatformIO into Visual Code. https://platformio.org/platformio-ide
  3. Open this project in PlatformIO.
  4. Compile the project and upload to an ESP32