Skip to content

K4-PB

The smallest pixel controller: 4 eFused pixel ports with per-port current monitoring and a DMX header, on a 71 × 67 mm board that fits a small TA-200 enclosure.

This page describes revision v3.0.1 (printed on the board as K4-PB v3.0.1). The K4-PB works with both the PocketBeagle 2 and the original PocketBeagle 1, and nothing blocks the SD card slot.

How the K4-PB differs from the K8, K16 and K32 boards

  • No Ethernet on the board. Plug a USB Ethernet adapter or an FPP-supported USB Wi-Fi adapter into its USB-A port. You need one of them to set it up. A "nano" or "mini" Wi-Fi adapter fits inside a TA-200 enclosure.
  • One power terminal, 5 or 12 V. It powers the controller and all four ports, so all of them run at the same voltage. 18 V is the absolute maximum; don't use 24 V supplies.
  • No differential ports and no expansion port. It drives only its four local ports.
  • DMX is a 3-pin header, not an RJ45 jack.
  • No real-time clock. The board gets the time from the network (NTP).
  • Not protected against a reversed supply. Check the polarity before you power up.

PocketBeagle 1: never connect its USB port to a computer

With an original PocketBeagle 1 fitted, don't power or set up the K4-PB through the PocketBeagle's own USB port (USB tethering). It can permanently damage the K4-PB. Power it only from its power terminal, and set it up over a USB network adapter. With a PocketBeagle 2, USB tethering is safe.

Specifications

K4-PB
Local pixel ports 4 (PT1–PT4), 3-pin 3.5 mm pluggable, plugs included
Port protection eFuse per port, about 5.2 A, latching
Power switching per port (FPP-controlled)
Current monitoring every port
Differential ports none
Total strings 4
Power input 1 terminal, 5 or 12 V DC (18 V maximum), powers the controller and all 4 ports
DMX / serial 1, RS-485 transmit, 3-pin 2.54 mm header (ttyS4)
GPIO header 2×4, unpopulated: 3.3 V, GND and six PocketBeagle pins (P1-2 to P1-12)
Audio none built in. Use a USB sound card.
Ethernet none. Use a USB Ethernet or Wi-Fi adapter.
USB-A 1
Display & buttons 128×64 OLED, Test-Down / Enter
Real-time clock none
Temperature sensor yes
Size 71.1 × 67.1 mm (2.80 × 2.64 in), 3 mounting holes, 4.0 mm
FPP output BBB48String
Requires PocketBeagle 2 (FPP 9.5 or later recommended; any 9.x works) or PocketBeagle 1

Board map

K4-PB from above

Power terminal

The power terminal is at the bottom left: GND on the left screw, V+ on the right. It powers the PocketBeagle, the USB port and all of the logic, and all four pixel ports. FPP shows its voltage as VIN.

  • Every port shares this supply, so all four strings must be the same voltage: 5 V or 12 V pixels.
  • 18 V is the maximum. A 24 V supply will damage the board.
  • Two blue LEDs on the right-hand edge show that the board has power and that its internal 5 V supply is running.

Check polarity before you power up

The K4-PB is not protected against a reversed supply. The controller's own logic is protected, but a supply wired backwards drives the input surge-protection diode, which is likely to burn out. It usually fails as a short, and the board then won't power up until it is repaired.

Pixel ports

The four pixel ports are in a row across the middle of the board, PT1 on the left to PT4 on the right. Each is G D V (ground, data, +V), as printed beneath it. PT1 is FPP port 1, and so on. See Pixel outputs.

eFuses and current monitoring

Every port has its own eFuse, which trips at about 5.2 A and latches off. FPP reads every port's current and turns each port on and off as needed. When an eFuse trips, FPP marks the port with a red icon on Status/Control → Port Status; click it to turn the port back on once the fault is fixed. See Current monitoring.

DMX

DMX is on the 3-pin, 2.54 mm header on the left edge, marked ttyS4:

Pin Marking Signal DMX XLR pin
top G Ground 1
middle - Data − 2
bottom + Data + 3

Make up a cable from a 3-pin socket to an XLR or RJ45 DMX connector, wired as above. The output is transmit-only and can also drive Renard, LOR or Pixelnet through a suitable adapter. FPP calls the port ttyS4. See DMX / serial.

DMX on a PocketBeagle 2 with an older EEPROM

On a PocketBeagle 2, FPP finds this DMX port through a mapping in the cape EEPROM, added in EEPROM 3.0.1 (February 2025). On a board programmed before then, a DMX output on ttyS4 goes to the wrong serial port and nothing comes out. Fix it by updating the cape EEPROM under Help → About → Cape Info (see Updating), or set the DMX output's port to ttyS5 instead. On a PocketBeagle 1, ttyS4 always works.

GPIO header

The 2×4 header position at the top right is not fitted: solder in a 2×4, 2.54 mm pin header if you want to use it. It brings out 3.3 V, GND and six PocketBeagle pins, numbered on the board: P1-2, P1-4, P1-6, P1-8, P1-10, P1-12. Use them in FPP's GPIO Inputs for buttons or switches to ground. They connect straight to the PocketBeagle, so they are 3.3 V only; never connect 5 V or anything higher.

Other connectors

Connector Marking Details
USB-A — 1 port, top left, for the network adapter. USB
OLED GND 3.3 SCL SDA Controls & display
Buttons Test/Down Enter Down and Test share one button. Controls & display

FPP setup

When FPP detects the K4-PB it sets itself up automatically. It enables the K4-PB pixel-string layout (FPP's BBB48String output), with each port set to 100 WS2811 pixels at 50 % brightness, the voltage, current and temperature sensors, and a disabled DMX output on ttyS4. Set the pixel counts and start channels from xLights or the FPP Pixel Strings page. See Configuring outputs.

For the first setup, plug in a USB Ethernet adapter and connect it to your network, or use a USB Wi-Fi adapter and FPP's Wi-Fi hotspot. Because the board has no clock, set up NTP under Settings → Time so schedules run at the right time.

Dimensions & mounting

  • 71.12 × 67.06 mm (2.80 × 2.64 in), 3 mounting holes, 4.0 mm, for M3 or M3.5 (or #6) screws.
  • Designed to fit a TA-200 enclosure.
  • Use standoffs at least 6 mm (¼ in) tall, so nothing on the underside touches the enclosure.