To enable feeder usage, you'll need to update both your LumenPnP's firmware and OpenPnP.
LumenPnP feeders are a new OpenPnP feature, are not yet in mainline OpenPnP. These docs are based on a 2023-04-05 release, which you can download here:
You can also download the most recent builds of OpenPnP that support feeders here, but there could be updates or changes that differ from these docs.
Because of a bug with how OpenPnP signs their releases, Mac users with ARM processors might experience a crash on boot. You can still run OpenPnP by navigating to
Applications -> OpenPnP and right clicking on the OpenPnP app and selecting "Show Package Contents":
Then navigate to
Contents -> MacOS and double click on
JavaApplicationStub to run OpenPnP.
Update LumenPnP Firmware
Machines Version v3.0.5+
If your machine's version number is
v3.0.5 or greater, you already have firmware that supports feeders. You can skip this section.
Download the LumenPnP firmware with feeder support from the latest release here.
It is important that you pick the correct firmware file for your machine.
- If you have a v2, choose
- If you have a v3, choose
- If you have a v2, choose
Follow the instructions for updating your LumenPnP's firmware.
Update Feeder Firmware (Optional)
All feeders come with firmware pre-programmed. These instructions are for updating to a new version of firmware, or putting custom firmware on the feeder.
Set Jumper to 3.3v
Make sure that the jumper on your programmer is set to 3.3v. On the 3 pin header, make sure the jumper is connecting the center pin to the pin labeled "3.3v". The feeder logic operates at 3.3v, so it should be set to this prior to use.
Connect the included programmer to your computer.
- Download and install the STM32CubeProgrammer application.
- Open the STM32CubeProgrammer application
Set the following settings:
While holding the BOOT button, insert the pins of the programmer into the plated holes on the feeder as shown in the picture below. The holes are slightly offset, so the programmer pins will stay in contact with the through holes. Once connected, release the BOOT button. If the feeder's LED flashes and turns red, it is not ready to be programmed. Try again.
The feeder does not need to be mounted on a rail for this step; it can be powered by the programmer.
If You Can't Connect
If you can't connect to your feeder, check that the programmer is inserted into the pins in the correct orientation. Also, applying gentle pressure to the side of the programmer can help ensure that the pins are making good contact with the plated holes in the feeder PCB.
Next, you'll mount your feeders.