Firmware flashingNEORACER DOCS
These docs are public and open source.Edit on GitHub
SOFTWARE / FIRMWARE FLASHING

FLASH THE BOARD.

The OSCORE controller runs its own firmware, the real-time layer that reads the receiver and drives the ESC and servo. You update it from a browser: the talks to the board over USB. No toolchain, no install.

OSCORE · ESP32-S3Chrome / Edge onlyUSB + V_IN 9–26 V
01 / GET THE FIRMWARE

THE .BIN.

The flasher ships with the chapter example builds, so for those you don't download anything. To run a specific release, grab its .bin from the OSRCORE releases and unzip it.

bash
# Example: fetch a tagged release and unzip it. wget https://github.com/osrbot/osracer/releases/download/v1.0.5/osrcore-firmware-v1.0.5.zip unzip osrcore-firmware-v1.0.5.zip # -> osrcore-firmware-v1.0.5.bin
02 / BEFORE YOU CONNECT

POWER AND A BROWSER.

  • Chrome or Edge. The flasher needs the Web Serial API, which only the Chromium-based browsers have. Firefox and Safari won't work.
  • USB to the board. Connect the OSCORE board to your computer with USB.
  • V_IN powered. The board needs V_IN on a 9 to 26 V supply while you flash.
03 / THE KEY SEQUENCE

ENTER DOWNLOAD MODE.

Flashing needs the board in download mode. It's a four-step press, in this exact order, right before you connect:

01
Hold BOOT

Press and keep holding the BOOT button.

02
Tap RESET

With BOOT still held, press RESET once.

03
Release RESET

Let go of RESET while still holding BOOT.

04
Release BOOT

Now let go of BOOT. The board is in download mode.

04 / FLASH IT

CONNECT, THEN WRITE.

Open the OSCORE web flasher in Chrome or Edge.

  • Pick the firmware. Choose a chapter example from the dropdown, or Custom firmware and drop in your .bin.
  • Put the board in download mode (the sequence above), then click Connect Board.
  • Select the serial port. The board shows up as a USB JTAG/serial debug unit on a COM port. Pick it and connect.
  • Start Flashing. Watch the progress bar; the console logs each write. It finishes on Flash successful.
05 / AFTER THE FLASH

SERIAL MONITOR.

When the flash completes, the board resets and runs the new firmware. To confirm it's alive, open the Serial Monitor in the same tool (no download mode needed) and watch the log at 115200 baud. From there you can bring the car back up with the driver.