Firmware
Install firmware via USB
Flash JoyReef firmware (Controller or Doser) directly from the browser (like Tasmota).
What you need
- Chrome / Edge on desktop (Web Serial).
- Open this page over HTTPS (or http://localhost).
- A USB data cable (not charge-only).
- USB-serial drivers installed (CH340/CP210x depending on the board).
Flash firmware
Select the correct USB port and wait for completion.
Choose the correct firmware for your hardware. Flashing the wrong firmware may prevent the device from booting.
Loading flasher…
Controller
Main JoyReef controller: temperature, levels, plugs, automations.
Doser
6-channel dosing pump: calibration, manual dosing, schedules.
Feeder
Automatic feeder: meal schedules, manual feed, motor calibration.
pH Device
Dedicated pH probe: pH reading, 2-point calibration, temperature compensation.
Note: Flashing may erase the device memory. If prompted, choose “Erase” for a clean install.
If you see “Failed to open serial port”
The browser can see the port, but the operating system cannot open it. This is usually not a firmware or manifest issue.
- Close any IDE, serial monitor, browser tab, or other tool that may already be using that port.
- Check the board USB-serial drivers: usually CH340 or CP210x.
- Use a real USB data cable: many cheap cables only provide power.
- Unplug and reconnect the board, then try again and reselect the correct port.
- If the browser still fails, use the .bin with an external flasher: if that also fails, the problem is hardware/driver/port related.
Steps
- 1 Choose the firmware (Controller or Doser).
- 2 Connect the device via USB (data cable) and keep it powered.
- 3 Click “Connect & flash”, select the serial port, and confirm.
- 4 Wait for completion, then reboot the device.