Skip to content

Feeder UART Bootloader Fix

This guide is for fixing an issue in a small batch of feeders where they can't be reprogrammed using the programming dongle that came with your feeders. This issue does not affect the feeder's normal operation.

Our chip supplier sourced a slightly different version of the RS-485 transceiver we use with the exact same part number, just from a different lot. This lot behaves slightly differently when the DE/RE pins are left floating: the previous lot would default itself to a disabled state which allows UART programming, but the new lot has just enough leakage current to end up being enabled, which causes it to interfere with communication from the UART programmer.

There are two fixes to the issue.

Send to Opulo for Repair

If you don't mind some downtime, we'd be happy to perform the fix for you. Reach out to our support line and we can facilitate getting your units shipped back to Opulo for repair.

Fix #1: Firmware Update

We've developed a new version of firmware that has a workaround for this bug, and allows it to still be programmed over UART. However, it must first be programmed over SWD.

Tools Needed

J-Link

You can also use a Segger J-Link or other SWD programmer, but these instructions are for a Black Magic Probe.

Instructions

  1. Prepare your computer to flash the new firmware (MacOS and Linux).
    1. Download the .elf file from the most recent release of Photon here.
    2. Install arm-none-eabi-gdb if it is not installed already.
      1. MacOS using Homebrew: brew install arm-none-eabi-gdb
      2. Linux using apt: sudo apt install arm-none-eabi-gdb

  2. Remove the version number sticker on your feeder. This sticker covers the SWD port we'll use to program the feeder.

  3. Connect the Black Magic Probe to your computer, and apply the spring pin interface onto the pads on the feeder.

  4. Flash the new .elf file to the feeder using: 

     arm-none-eabi-gdb -nx --batch \
     --ex target extended-remote /dev/BLACK_MAGIC_PROBE_PORT \
     --ex monitor tpwr enable \
     --ex monitor swdp_scan \
     --ex attach 1 \
     --ex load \
     --ex compare-sections \
     --ex kill /path/to/firmware.elf
    after replacing /path/to/firmware.elf and /dev/BLACK_MAGIC_PROBE_PORT with the correct paths for your machine.

Your feeder now has the ability to update firmware over UART, but now enters the bootloader by holding both feeder buttons until the blue and red flashing lights stop. Check out the feeder programming page to see full instructions.

Fix #2: Interposer Board Installation (WIP)

Tools Needed

  • Soldering Iron
  • Flux
  • Solder
  • Allen key set from your LumenPnP Tool Kit
  • 1x Interposer Board per feeder (request from Opulo)

Installation

Instruction to be updated shortly.