Skip to content

JLCPCB Firmware Upload Instructions

Jump to bottom
Just Call Me Koko edited this page Mar 13, 2024 · 3 revisions

JLCPCB Firmware Upload Instructions

The following documentation describes the process for installing the ESP32 Marauder firmware on official supported hardware. The specific hardware detailed in the documentation is the ESP32 Marauder v6.1 and the ESP32 Marauder Mini. The process for installing the firmware is the same between the two devices. The only point that changes is the specific variation of the ESP32 Marauder firmware binary. As they have different hardware configurations, they both have their own version of the firmware. As such, I have written the documentation separately for both hardware versions but you will see the process is the same apart from the specific bin selection.

Boards

ESP32 Marauder v6.1

image showing marauder v6.1 PCB back

  1. Download the firmware files required for the ESP32 Marauder v6.1

  2. Download, unzip, and open the Espressif Flash Download Tool

    • Chip Type: ESP32
    • Work Mode: Factory

  3. Using a USB-C cable, connect the assembled PCB to the workstation you are using for firmware upload

    • NOTE: In Factory mode, up to eight PCBs can be connected and flashed at once
    • image showing marauder v6.1 usb-c connection

  4. Configure the Espressif Flash Download Tool for firmware upload

    • Download Path Config (using downloaded firmware files)
      • esp32_marauder.ino.bootloader.bin @ 0x1000
      • esp32_marauder.ino.partitions.bin @ 0x8000
      • boot_app0.bin @ 0xE000
      • esp32_marauder_vX_X_X_XXXXXXXX_v6_1.bin @ 0x10000
      • MAKE SURE THOSE FOUR CHECK BOXES ARE CHECKED
    • SPI Speed: 80MHz
    • SPI Mode: QIO
    • DownloadPanel BAUD: 921600
    • DownloadPanel COM:
      • Select the COM associated with the PCB's CP2102 chip. This can be done by locating the device in Device Manager image
    • Your Espressif Flash Download Tool window should now appear like the image below... image

  5. Click the START ALL button and allow the firmware to upload to the on-board ESP32 modules

  6. Once the firmware installation completes and the DownloadPanel says FINISH, press the RESET button on the PCB

    • image showing marauder v6.1 reset button

THIS CONCLUDES THE FIRMWARE UPLOAD INSTRUCTIONS FOR THE ESP32 MARAUDER V6.1 PLEASE PROCEED TO TESTING

ESP32 Marauder Mini

image showing marauder mini PCB back

  1. Download the firmware files required for the ESP32 Marauder Mini

  2. Download, unzip, and open the Espressif Flash Download Tool

    • Chip Type: ESP32
    • Work Mode: Factory

  3. Using a USB-C cable, connect the assembled PCB to the workstation you are using for firmware upload

    • NOTE: In Factory mode, up to eight PCBs can be connected and flashed at once
    • image showing marauder mini usb-c connection

  4. Configure the Espressif Flash Download Tool for firmware upload

    • Download Path Config (using downloaded firmware files)
      • esp32_marauder.ino.bootloader.bin @ 0x1000
      • esp32_marauder.ino.partitions.bin @ 0x8000
      • boot_app0.bin @ 0xE000
      • esp32_marauder_vX_X_X_XXXXXXXX_mini.bin @ 0x10000
      • MAKE SURE THOSE FOUR CHECK BOXES ARE CHECKED
    • SPI Speed: 80MHz
    • SPI Mode: QIO
    • DownloadPanel BAUD: 921600
    • DownloadPanel COM:
      • Select the COM associated with the PCB's CP2104 chip. This can be done by locating the device in Device Manager image
    • Your Espressif Flash Download Tool window should now appear like the image below... image

  5. Click the START ALL button and allow the firmware to upload to the on-board ESP32 modules

  6. Once the firmware installation completes and the DownloadPanel says FINISH, press the RESET button on the PCB

    • image showing marauder mini reset button

THIS CONCLUDES THE FIRMWARE UPLOAD INSTRUCTIONS FOR THE ESP32 MARAUDER MINI PLEASE PROCEED TO TESTING

Testing

The testing process is the same between the two referenced devices.

  1. Download, install, and open PuTTY
  2. Connect the flashed ESP32 Marauder PCB to your workstation using a USB-C cable
    • image showing marauder usb-c connection
  3. Configure PuTTY to connect to the ESP32 Marauder PCB
    • Connection Type: Serial
    • Speed: 115200
    • Serial Line:
      • Select the COM associated with the PCB's CP2102 chip. This can be done by locating the device in Device Manager image
    • Your PuTTY window should now appear like the image below
      image
  4. Click Open and a new black window will appear
    • Once the new window opens, it may cause the firmware on the ESP32 to reset in which case you can skip step 5
  5. Press the RESET button on the PCB
    • image showing marauder reset button
  6. Monitor the PuTTY window to look for the output shown in the image below. It may take up to 20 seconds but no longer than 30
    • If the firmware upload was successful, you should see the following output image

THIS CONCLUDES THE TESTING DOCUMENTATION

Clone this wiki locally