Firmware Installation

Upload Firmware

Provisioning UI

If your board does not come pre-programmed, you will need to upload the firmware.

  1. Open the Firmware Helper page
  2. Select your board revision
  3. Select your firmware version
  4. Click Install Firmware
  5. Select your serial port, click upload
  6. Board will reboot, beep, and status will show as BLUE on success

WiFi Provisioning

  1. Power your board through USB or external power.
    • The status led should show as BLUE (ready to pair)
  2. Open the Firmware Helper page
  3. Select either Configure via BLE (Bluetooth) or Configure via Serial (USB cable)
  4. Enter your WiFi credentials
    • Status led will turn GREEN on success.
  5. Open your browser to http://brineomatic.local

If your WiFi changes or the board cannot connect to WiFi, the status led will turn RED You can hold the BOOT button for 10 seconds to switch back into provisioning mode.

Firmware Update Methods

  • Update the firmware using OTA from the web interface
  • Use the Firmware Helper linked above to choose a specific version
  • Compile from source using instructions below

Development / Building From Source

  1. Clone the firmware repository
  2. Run npm install in the repository root to install the build tooling (npm is used only for dev tooling — this is not a Node.js application)
  3. Plug your computer into the board
  4. Open the repository in VSCode
  5. Install the Platformio plugin if needed
  6. At the bottom, select your board from the build environments
  7. Build and/or upload firmware with the arrow in the upper right.

ArduinoOTA

This allows you to upload new firmware over wifi from VSCode.

  1. Enable Arduino OTA in Settings -> Miscellaneous on the board
  2. Edit platformio.ini and add this to the bottom of your desired board [env:] section
; OTA Upload Config - replace "admin" with your board's admin password
upload_protocol = espota
upload_port = brineomatic.local
upload_flags = 
 	--auth=admin
 	--port=3232