Pigeon / RPXL Kit PN-84 / Pigeon base kit Build manual / Draft Resin chassis PLA chassis Print + electronics + shell

PN-84Network thermal printer

A message from a friend, on paper, on your desk. PN-84 is a palm-sized network printer: people on a short list send it a few lines, end-to-end encrypted, and a slip rises from the slot and waits. No screen, no app, no notifications. Wi-Fi carries the messages, and a LoRa radio keeps a link when the internet does not. You print it, wire it and build it by hand.

PN-84 in Oat: a soft rounded cube in warm white with a printed slip rising from the slot near the front of the top, an orange toothed tear edge, one small glowing status light, a speaker grille on the right side and a charcoal base band with screws and a small hexagon mark.
FIG. 0 / PN-84 with the Pigeon base shell, Oatrendered from the CAD
Core
84 x 86mm plate, 59 tall to the printer face
Paper
57 mmrolls up to 40 dia; prints 48 mm, 384 dots
Power
USB-C 9 VPD charger, 2 A or more
Controller
ESP32-S3XIAO + Wio-SX1262 LoRa
Messages
NostrNIP-17, NIP-44 encrypted, contacts only
Parts
A$120about, per unit, before tools and paper
Draft

This manual is written from the design before the first units are built. Sizes and values of bought parts are nominal until they are measured, and the fit coupons in section 04 decide the final clearances. Follow the bring-up order in section 08 exactly: it is how nominal values become measured ones.

00

Which chassis are you building?

Choose onceSwitch any time, in the contentsOutput a manual for your chassis only

One product, two ways to print the chassis. Everything else is the same: the printer adapter, the bench base, the electronics, the firmware and the assembly order. Choose yours: the rest of this page then shows that chassis only.

A link keeps the choice

The choice is saved in this browser and written into the address (?edition=resin or ?edition=pla), so a link opens the right manual. It is the only thing this page remembers.

01

What you're building

Read 5 minNeeds nothingOutput the whole kit in your head

Every PN-84 is a core and a shell. The core does all the work and stands on its own; the shell is what you see. They meet at a small documented interface, so anyone can design a shell for the same core. This manual builds both: the core first, then the Pigeon base shell round it.

Exploded view of PN-84: the finished core standing in the charcoal base band, the white deck with its orange tear trim and light lens lifted above it, the lid above that, six band screws pulled out sideways and four bumpers and core screws below.
FIG. 1 / The core in the base shell, explodedfront right

Layer 1: the core

platform

The printer, controller, power, audio and light on one printed chassis, plus the firmware and the message protocol. Engineering first and neutral: no names, jokes or styling. Open hardware and open source.

  • Works on the bench with no shell (sections 04 to 09).
  • Four M2 screws from below hold it to any shell floor or to the bench base.
  • USB-C power on the back, paper exit on top, status light at the front.

Layer 2: the shell

casing

The exterior, the colourways, the slip wording and the sound. The Pigeon base shell (FIG. 0 and FIG. 1) is three printed parts, a band, a deck and a lid, with an orange tear trim, a clear light lens, ten screws, eight magnets and four bumpers. It is built in section 11. Community shells fit the same core through the interface listed there.

  • Owns its own floor, feet, lid and outline. The base shell's band is the floor; the lid lifts off for paper.
  • Never changes the core; the core never changes for a shell.
  • The firmware's wording comes from a voice file, so a shell can bring its own words.
02

Tools and supplies

Gather onceNeeds a bench and a 3D printerOutput nothing missing mid-step

Tools

needed
  • Soldering iron, solder, flux. Every board joint is soldered. A fine tip helps on the XIAO pads.
  • Multimeter with a mA range.
  • Bench power supply, 0 to 12 V with a current limit (3 A). Every board is first powered on it.
  • In-line USB-C power meter that shows volts and amps.
  • Calipers, to measure the bought parts and check the coupons.
  • Wire strippers, flush cutters, tweezers, a heat gun or lighter for heat shrink.
  • Hex driver for M2 button head screws (1.3 mm).
  • A 3D printer: resin (MSLA, bed 196 x 122 or larger) with wash and cure, or FDM (0.4 mm nozzle).
  • PLA chassis: A soldering iron tip for pressing M2 heat-set inserts.Resin chassis: Sandpaper 400 to 2000 for the light pipe ends and the adapter bezel face.

Supplies and helpful extras

nice to have
  • USB-C PD charger that offers 9 V at 2 A or more (18 W). A 30 W charger (9 V 3 A) is recommended. Plus a USB-C cable.
  • USB-C data cable for the first firmware flash.
  • Silicone wire 24, 26 and 28 AWG in the 10 colour set, 1.5 and 3 mm heat shrink, small cable ties (2.5 mm) or waxed lacing.
  • Kapton tape over the u.FL antenna connectors.
  • Hot melt or UV resin for the XIAO pad joints after the bench test, and a dot of glue for the buck trimmer.
  • Oscilloscope and a 0.1 ohm 1 W shunt: strongly wanted for the current tests in bring-up steps 7 and 8.
  • A 10 ohm 10 W resistor, optional: a load for checking the PD trigger.
  • An SDR or a second LoRa node, optional: proves the radio in bring-up step 11.
03

Parts to buy

Prices A$, November 2026Recheck before buyingOutput everything on order

Prices are per unit as listed by Australian retailers or AliExpress in November 2026, GST inclusive where the retailer shows it, shipping not included. Lines marked "est." had no listing and are planning figures. Small parts come in packs, so the cash for a first unit is higher than the per-unit total: allow about A$135 for everything except printing material.

PartSpecQtyTypical sourceA$ each
Core: the three main parts
Thermal printer58 mm embedded panel printer, QR203 / EML203 family, TTL + USB, 5 to 9 V. Usually comes with paper rolls1AliExpressabout 73 for the three
Controller kitSeeed XIAO ESP32S3 + Wio-SX1262 kit, with its LoRa FPC antenna and Wi-Fi FPC antenna (u.FL)1AliExpress, Seeedin the 73
PD triggerUSB-C PD trigger board, fixed 9 V1AliExpressin the 73
Core: power, audio, light
Buck converter9 V to 5 V, set to 5.2 V; at least 1.5 A continuous, input rated 12 V or more (MP1584 class module)1AliExpress, Core Electronics4.00 est.
Audio amplifierMAX98357A I2S class D, 3 W (DFRobot DFR0954 or Adafruit board)1Core Electronics10.15
Speaker28 mm dia x about 5 mm, 8 ohm, 1 W class1DigiKey AU6.60
Status LED0805 LED, warm white or amber, on a 4 x 3 mm PCB or breakout1AliExpress, DigiKey AU2.00 est.
Foam seal ringclosed cell foam, 28 outside, 22.4 inside, about 1.4 to 1.8 thick (cut from foam tape)1AliExpress, Bunnings0.50 est.
Core: protection and connectors
C1 bulk capacitor470 uF 16 V low-ESR electrolytic, 8 x 11.5 (Panasonic FR class)1DigiKey AU0.60 est.
C2 ceramic10 uF 25 V X5R, 1206 or radial1DigiKey AU0.30 est.
F1 resettable fuseradial PTC, hold 1.6 A, trip 3.2 A, 30 V or more (Littelfuse RXEF160 class)1DigiKey AU1.10 est.
D2 TVS diodeSMBJ10A, unidirectional1DigiKey AU0.50 est.
D1 SchottkySS14 (1 A, 40 V), buck to the XIAO 5V pad1DigiKey AU, AliExpress0.20 est.
ResistorsR1 1 kohm (LED); R2 10 kohm (only if bring-up step 6 needs it); 1 k + 2 k (optional divider)1 setDigiKey AU0.15 est.
J1, J2 connectorsJST-XH 2.54 mm pigtail pairs: one 2 pin (J1, power), one 3 pin (J2, data)2 pairsAliExpress0.40 est.
Wire and sundriessilicone wire, heat shrink, labels, ties, solder (share of the packs)1 setAliExpress, Core Electronics3.00 est.
Fixings
Resin chassis: M2 hex nutAF 4.0, 1.6 thick, captive in the chassis bosses4 + 2AliExpress, Bunnings0.05 est.
PLA chassis: M2 heat-set insertfor a 3.2 mm hole, 4 deep4 + 2AliExpress0.10 est.
M2 x 10 screwISO 7380 button head, black; core to the bench base or a shell floor4AliExpress, Bunnings0.15 est.
Rubber feet10 dia x 3, self-adhesive; optional, for grip under the bench base (the base shell uses the bumpers below)4AliExpress, Bunnings0.30 est.
Base shell (section 11)
M2 x 8 screwISO 7380 button head, black; core up through the band floor into the corner bosses (the bench base takes M2 x 10)4AliExpress, BunningsNOMINAL
M2 x 6 screwbutton head (ISO 7380 head shape), thread-forming, black; band into the deck skirt bosses6AliExpressNOMINAL
Bumperround self-adhesive bumper, 10 dia x 3.5; one in each band recess, over a core screw4AliExpress, BunningsNOMINAL
Disc magnetN35, 5 x 2 mm; four pressed into the lid bosses from above, four into the deck rim bosses from below, press fit plus a drop of CA glue8AliExpressNOMINAL
Tear trimprinted, orange: the toothed U trim round the paper slot (section 04)1you print itin material
Light lensprinted, clear resin: the 6.3 x 1.0 pipe through the deck over the light port (section 04)1you print itin material
Shell materialPLA or tough resin in your colourway for the deck and lid, the band colour for the band, orange for the trim; about 95 cm3 solid for the three main partsabout 0.13 kganyNOMINAL
Printing material
Resin chassis: Resintough or ABS-like opaque resin for the chassis, adapter and bench base; clear resin for the light pipeabout 0.24 kgAU resin suppliersabout 12
PLA chassis: PLA or PETGany colour; plus a clear resin light pipe (or ask a friend with a resin printer)about 0.2 kganyabout 5
Approximate build cost

About A$120 per unit for the core parts, fixings and printing material at the prices above. The base shell's screws, bumpers and material are NOMINAL and not in this total.

Not included

The USB-C PD charger and cable, a USB-C data cable, tools, and spare paper. Paper is generic 57 mm thermal roll, 40 mm diameter or less (57 x 38 rolls fit), BPA free.

04

Print the parts

Time five core prints, coupons first, then the shellNeeds a resin or FDM printer, calipersOutput the printed parts and your fit sizes

Print the fit coupons before anything else. They print three sizes of every tight fit; the size that fits your parts and your printer is the one you set before printing the chassis.

What gets printed

every file as .stl and .3mf
PartPart fileBuild plateQty
Resin chassis: Chassis (captive nuts)pn84_core_chassis_resinpn84_plate_resin_2_chassis_adapter1
PLA chassis: Chassis (heat-set inserts)pn84_core_chassis_plapn84_plate_pla_2_chassis_adapter1
Printer adapterpn84_printer_adapterpn84_plate_resin_2_chassis_adapterpn84_plate_pla_2_chassis_adapter1
Bench basepn84_bench_basepn84_plate_resin_3_bench_basepn84_plate_pla_3_bench_base1
Light pipe (clear resin)pn84_light_pipepn84_plate_clear_light_pipe3, keep the best
Shell band (band colour)PN84_p5_bandsingle part1
Shell deck (body colour)PN84_p5_decksingle part1
Shell lid (body colour)PN84_p5_lidsingle part1
Magnet pull-test couponPN84_magnet_coupon (in out_H3)single part1, on arrival day
Tear trim (orange)PN84_p5_trimsingle part1, or 2 to keep the best
Light lens (clear resin)PN84_p5_lenswith the light pipes2, keep the best
Fit couponspn84_coupon_*pn84_plate_resin_1_couponspn84_plate_pla_1_coupons1 each

Build plates come with the print rotations already applied (3MF, one object per part, so each part can still be moved). The STL of a plate is one fused mesh for a quick look. Plates are laid out for a 196 x 122 bed and use 186 x 112 of it; any FDM bed that size or larger takes the PLA plates.

Print order

five prints, then the shell
  1. Coupons. About an hour of resin or two of PLA. Test each with the real part. Each coupon carries three sizes marked with 1, 2 and 3 notches.
  2. Chassis, in the variant you chose: Resin chassis: resin with captive nut wells.PLA chassis: PLA with heat-set insert holes.
  3. Printer adapter. The ring the printer clips into. It is the one part to reprint if your printer differs from the QR203 family, so print it after the chassis (or with it, if the coupons already agree).
  4. Bench base. Stands the core on a desk with no shell. PLA is the easiest material for it.
  5. Light pipe, clear resin, any time. Print three and keep the best polished one. Print the shell's light lens on the same plate.
  6. The shell, once the core has passed bring-up: band, deck, lid and the tear trim. The shell files are single parts in the CAD frame (cad/plasticity/p5/out_H3/: deck, lid and band, with the magnet bosses), so rotate them in the slicer as the table below says.

The coupons

what each one proves
CouponFits whenSizesSetting
coupon_clip_landthe printer's side clip latches under the land with no playland thickness 1.5, 2.0, 2.5PANEL_T
coupon_adapter_pinthe adapter ring presses onto the chassis pins (post block and ring strip)hole 1.6, 1.7, 1.8ADAPTER_HOLE_D
Resin chassis: coupon_nut_pocketan M2 nut drops in and does not turnnominal and 0.1 either sideNUT_POCKET_AF
PLA chassis: coupon_heatsetan M2 insert presses in squarenominal and 0.1 either sideHEATSET_D
coupon_usb_openinga USB-C plug seats fully (for shell designers)nominal and 0.2 either sideUSB_RECEPTACLE
coupon_speaker_seatthe 28 mm speaker presses past the lips and sits squareone sizeSPK_SEAT_CLEAR
PN84_magnet_coupontwo blocks with a magnet each, skin to skin, pulled apart on a kitchen scale hold 40 to 75 g per pair. Too strong: raise MAG_SKIN by 0.2 and reprintone sizeMAG_SKIN
coupon_light_pipethe pipe slides in with no rattle and the LED PCB sits in its pocket0.10, 0.15, 0.20 per sidePIPE, CLEAR
Change the value, not the scale

Never scale a part to fix a fit. Put the winning sizes into cad/core_params.py, then from cad/ run python -m pytest, python tools/write_interface.py and python -m ticker.printing to rebuild the print files. The tests name any clearance that a change breaks.

Orientation and supports

rotations from the STL frame, degrees, right-hand rule

Part files lie in the STL frame: lowest point on z = 0, chassis seat face down, adapter bezel face up, bench feet down. If your slicer's sign is the other way, use the check column.

Resin chassis
PartRotateCheck after rotatingKeep supports off
ChassisX -30the front end (the little light column) is the high edgepost tops and pins, nut wells, board lips, fences and tab barbs, PD rail slots, antenna clips, pipe slot and LED pocket. Supports go on the seat face (sand flat) and a few inside the speaker bore
Printer adapterX 195bezel face down, clip pockets open upward, front edge (column notch) highclip pocket roofs, the opening walls, the pin holes, the column notch. Sand the bezel face flat on 1000 grit
Bench baseX -15feet down on the supports, top face up, the end without the USB cut-out highthe top face (core seat) and the four screw holes. 3 to 4 raft layers; if it cups, print it in PLA
Light pipenonelying on its 7.8 x 11 back faceboth end faces. No supports
Shell decktilt about 30open skirt toward the build plate, front (slot side) highthe whole outside: slot, trim pocket, light hole, grille. Supports go on the skirt edge and the inside of the roof only. It is open, so it needs no drain holes
Shell lidtilt about 30open rim toward the build plate, front edge highthe outside and the front edge (it closes against the paper slot). Supports on the rim and the inside only
Shell bandtilt about 20floor toward the build plate, the USB-C pill highthe outer wall (mark, screw spot faces, USB-C pill) and the top edge. Supports on the floor underside; the bumpers cover the four recesses
Tear trimnoneflat, the visible face away from the platethe toothed edge. Print it flat on light supports or straight on the plate
Light lensnoneclear resin, lying on its side as the light pipeboth end faces. Sand the outer face flush with the deck afterwards if it stands proud
Couponsclip land X 180, others noneclip land: pocket roofs up, notched end upthe faces each coupon tests
PLA chassis
PartRotateCheck after rotatingSupports
Chassisnoneseat face on the bed, posts and frame pins uponly a few inside the speaker bore (a 28 mm arch); light scars there are fine, it is the glue land
Printer adapterX 180bezel face on the bed, pockets open upwardnone; keep supports out of the 1.7 pin holes
Bench baseX 180top face on the bed, feet upnone; add a 5 mm brim
Light piperesin onlyclear resin, lying on its back facenone
Shell decknoneupright as it sits, skirt on the bedinside only, under the roof and the paper bay floor; the outside needs none. Tree supports, 0.16 layers, 3 perimeters
Shell lidnoneupright as it sits, rim on the bedinside only, under the roof
Shell bandnoneupright as it sits, floor on the bednone; the counterbores bridge. 0.12 layers if you want the mark sharper
Tear trimnoneflat, visible face upnone. 0.1 layers; the 0.45 teeth come out rounded on a 0.4 nozzle, so resin is better for this one part
Light lensresin onlyclear resin, as the light pipenone
Couponsclip land X 180, others noneclip land: pocket roofs upspeaker seat: light supports on the foot side only
Resin chassis: Resin settings

Layer 0.05 mm, normal exposure for your resin. Use a tough or ABS-like resin for the chassis and adapter: the 0.8 mm flex tabs and the clips must bend and come back, and a brittle standard resin snaps. Do not hollow any part. Holes print 0.05 to 0.1 small, which is what the coupons decide. Wash and cure lightly (over-curing makes the tabs brittle) and remove supports before the final cure.

PLA chassis: PLA or PETG settings

0.4 mm nozzle, layer 0.16 mm (0.2 acceptable), 4 perimeters (1.6 mm walls), 5 top and 5 bottom layers, 30 percent gyroid. Turn on thin wall detection so the 0.8 flex tabs and 1.0 clip arms print as single walls. Elephant foot compensation 0.1 mm if available. PETG is tougher for the snap features. Heat-set holes (3.2 dia x 4 deep) open from the plate underside.

Light pipe finish

Clear resin, support-free on its back face. Wash, then sand both end faces from 400 up to 2000 and clear-coat or dip them. The pipe is 7.8 x 11 x 1.6 and delicate, which is why there are three on the plate.

The RPXL mark on the band

The hexagon mark on the band front is debossed 0.3 deep in 12 stripes about 0.28 wide with 0.22 gaps. They come out crisp in resin. On a 0.4 mm nozzle the stripes soften and run together into a plain hexagon; that is expected, and the mark still reads.

05

Bench base

Time one printNeeds PLA is the easiestOutput the core runs with no shell, fitted last (step 15)
The core seen from below with the bench base, lifted off its seat lowered under it and four M2 screws below the base.
FIG. 2 / Bench base under the corefour M2 x 10 from below

The bench base stands in for a shell floor, so the core can live on a desk while you test it, use it, or wait for a shell. It puts the core's seat at exactly the height a shell would, so the same four screws and the same seat plane apply.

  • A flat plate 88 x 92 x 2.5 with four printed feet 1.5 tall. The screw heads sit in the foot height, clear of the desk.
  • Four 2.3 mm holes on the core's boss axes (32, 33.5 from the centre).
  • A cut-out at the back for the USB-C plug and its cable, wide enough that the PD board can still be pushed out backwards for service.

Print it in PLA top face down with a brim; it is the easiest of the parts. It goes on last, in step 15, once the core has passed bring-up.

06

Wiring and harness

Time an eveningNeeds iron, meterOutput 20 wires, 2 connectors, soldered at every board

USB-C power comes in at the back at 9 V, through a fuse to a single star point. The printer takes 9 V from the star; everything else runs from a 5.2 V buck. Grounds form a tree from the star: no loops.

PN-84 core wiring USB-C PD trigger at 9 V feeds a fuse and a protection star. From the star: the printer through connector J1, and the buck converter at 5.2 V. The buck feeds the XIAO through a Schottky diode and the amplifier. The XIAO drives the printer data on D4 through J2, the amplifier over I2S on D1 to D3, and the status LED on D0. The amplifier drives the speaker. Every power pair carries its own black ground. USB-C PD source 9 V, 2 A or more PD trigger fixed 9 V, back port Star (C1 leads) C1 470 uF 16 V C2 10 uF, D2 SMBJ10A the one ground point Thermal printer QR203 family, 5 to 9 V J1 power, J2 data Buck 9 V to 5.2 V MP1584 class, trim glued XIAO ESP32S3 + Wio-SX1262 (LoRa) 5V pad about 4.8 V own USB-C: flash, console Wi-Fi and LoRa FPC antennas MAX98357A amp I2S, gain 9 dB Speaker 28 mm, 8 ohm Status LED 0805, R1 1 kohm F1 W1 24 AWG W3/W4 24 AWG, 9 V through J1 (2 pin), 20 mm service loop W5/W6, 9 V D1 W7/W8, 5.2 V SS14, band to the XIAO W9/W10 W11 D4 to RX 3.3 V, via J2 (3 pin) W13 BCLK D1 W14 LRC D2 W15 DIN D3 W16/W17 W18/W19 D0 Every power pair carries its own black ground back to the star or the buck output. No ground loops. Colours are the harness colours.
FIG. 3 / Core wiring, harness numbers W1 to W19colours are the wire colours
Two rules

The printer is never powered from the XIAO 5V pin. And check the PD trigger's output on its own before connecting anything to it: above 9.45 V, stop (the printer is rated 9 V maximum). Bring-up step 2 does this.

Conventions

colour, gauge, ends
ColourCarriesGauge
Red+9 V24 AWG printer and PD leads, 26 AWG to the buck
Orange+5.2 V26 AWG
Blackground; every pair carries its ownas its pair
Yellowprinter data, XIAO to printer RX28 AWG
Blue / purple / greyI2S bit clock / word select / data28 AWG
Brown / whitespeaker + / speaker - (not ground)26 AWG
GreenLED anode28 AWG

Cut length is the routed length plus 10 mm per end, plus 20 mm where there is a service loop. Each joint gets 1.5 mm heat shrink, and each wire a heat-shrink label with its W number at the board end. J1 (2 pin, power) and J2 (3 pin, data) are the only connectors, both at the printer so it lifts out; their pin counts differ, so they cannot be swapped.

Wire list

lengths nominal
WFromToSignalAWGCut mm
9 V
W1PD trigger VOUT+star (C1 +), through F1 inline+9 V2445
W2PD trigger GNDstar (C1 -)GND2445
W3starJ1 pin 1, printer power+9 V2495
W4starJ1 pin 2GND2495
W5starbuck IN++9 V2675
W6starbuck IN-GND2675
5.2 V
W7buck OUT+XIAO 5V pad, D1 inline at the buck+5.2 V2675
W8buck OUT-XIAO GND padGND2675
W9buck OUT+amp VIN+5.2 V2650
W10buck OUT-amp GNDGND2650
Signals
W11XIAO D4J2 pin 1, printer RXdata, 3.3 V28105
W12XIAO GNDJ2 pin 3, printer TTL GNDspare, only if bring-up step 6 needs it28115
W13XIAO D1amp BCLKI2S bit clock2890
W14XIAO D2amp LRCI2S word select2890
W15XIAO D3amp DINI2S data2890
W16amp OUT+speaker + tabspeaker2640
W17amp OUT-speaker - tabspeaker (not ground)2640
W18XIAO D0LED PCB anode (R1 on the PCB or inline)LED28160
W19XIAO GNDLED PCB cathodeLED return28175
W20printer TXJ2 pin 2, XIAO D5 (divider if 5 V)status; not fitted28105

Inline parts: F1 in W1 about 10 mm from the PD pad; D1 in W7 at the buck, band (cathode) toward the XIAO; D2 and C2 soldered across the C1 leads, which are the star. The two antenna leads are the kit's own u.FL pigtails: press fully home, cover with Kapton, and never put a tie over the coax.

XIAO pads

top view, USB-C toward the back
Left column (toward the antenna fin)Right column (toward the centre)
D0 LED, W185V W7 (through D1)
D1 BCLK, W13GND W8, W19
D2 LRC, W143V3 R2 (option)
D3 DIN, W15D10 LoRa MOSI, inside the kit
D4 printer data, W11D9 LoRa MISO, inside the kit
D5 printer TX return, W20 (not fitted)D8 LoRa SCK, inside the kit
D6 free (debug UART TX)D7 free (debug UART RX)
Why the printer is on D4, not D6

D6 and D7 are the ESP32-S3's UART0, which prints the boot log on every reset. On D4 the printer never sees it, and the firmware drives D4 high as its first action. If a stray character still prints after power-up (bring-up step 6), fit R2: 10 kohm from D4 to 3V3.

07

Firmware

Time about 20 minNeeds arduino-cli, a data cableOutput a printer that makes its own setup slip

One sketch (firmware/papernet/) with one settings file, config.h. Every pin, baud rate, heat value and layout size lives there. The printed wording comes from a voice file: VOICE_PLAIN is the neutral platform default, VOICE_PAPERNET is the Pigeon shell's wording.

Build

from firmware/
arduino-cli core update-index
arduino-cli core install esp32:esp32
arduino-cli compile --fqbn esp32:esp32:XIAO_ESP32S3 --libraries libraries papernet
# the Pigeon voice, without editing config.h:
arduino-cli compile --fqbn esp32:esp32:XIAO_ESP32S3 --libraries libraries \
  --build-property "compiler.cpp.extra_flags=-DVOICE_PAPERNET" papernet

Keep the board defaults (USB CDC On Boot enabled, 8 MB flash, default 8 MB partitions with two app slots, PSRAM off). --libraries libraries is required: it adds the protocol core, the power and bench library and libsecp256k1 kept in the repository. Everything else ships inside the esp32 core; do not install the separate "QRCode" Arduino library.

First flash

over the XIAO's own USB-C
  1. Connect the XIAO to the computer with a data cable. It may stay plugged in with the 9 V supply on: D1 keeps the two apart. arduino-cli board list shows it. If not, hold BOOT, press and release RESET, then release BOOT.
  2. Upload. arduino-cli upload --fqbn esp32:esp32:XIAO_ESP32S3 -p /dev/cu.usbmodemXXXX papernet. Press RESET if it stays in download mode.
  3. Open the console. arduino-cli monitor -p /dev/cu.usbmodemXXXX. The boot log shows the reset cause, printer on D4/D5 at 9600 baud, heat n1 1 (auto), the device key and the command list.
  4. Optional, updates over the air. Set a password now: ota pass <8 to 63 characters>. Later, ota on opens a 15 minute window on the home network.

First boot: the setup slip

no app, no account

On its first boot the printer makes its own identity key and prints a setup slip with a QR code. The QR is a Wi-Fi join code for the printer's own setup network; its password exists only inside the QR.

  1. Scan the QR with a phone. The phone joins the printer's network and the setup page opens by itself.
  2. Choose your home Wi-Fi and enter its password.
  3. Note the printer's public key (npub): senders need it.
  4. Pick a display id: 3 to 8 letters, a dash, one digit (for example HARBOR-2). Save; the printer restarts onto your Wi-Fi.
Keep the setup slip

Whoever holds it can open the admin page while it is on (portal over USB opens it for 15 minutes). setup prints it again; portal reset forgets the Wi-Fi and starts setup over; factory erases everything, including the identity key.

Bench commands

selftest test slip, power power budget and brownout count, baudscan and baud N, heat, density, sweep, burst, lora probe, dry on (slips to the terminal instead of paper), help.

08

Bring-up on the bench

Time 12 stepsNeeds boards loose, a current-limited supply, a meterOutput measured values; full sheet in docs/bring-up.md

Power each part on its own, on a current-limited supply, before anything is joined. A step that fails stops the run until it is understood. Record every value; each one replaces a nominal figure in the firmware or the CAD.

  1. Boards one at a time. Buck alone at 9.0 V, 100 mA limit: turn the trimmer to 5.20 V and glue it. Amp alone at 5.2 V. XIAO on USB through the power meter, with both antennas fitted. LED through R1 at 3.3 V.buck 5.15 to 5.25 V; amp idle under 10 mA; XIAO idle under 150 mA
  2. PD trigger, nothing connected. Charger, cable, trigger; meter on the output pads after 2 s.8.55 to 9.45 V. Above 9.45 V stop: do not connect the printer
  3. Protection star and harness. Build the star (C1, C2, D2) and W1 to W6. 9.0 V, 200 mA limit into the star; then the reverse check at 100 mA for one second; then continuity of every W.under 5 mA after charging; reversed, the supply limits; no shorts
  4. Printer at 5 V, alone, 2.0 A limit, paper in. Hold FEED while switching on: the printer's own self-test prints. Note its baud rate and measure its TX idle level.idle under 100 mA; the slip is legible
  5. Printer at 9 V, bench supply (3 A limit), then on the real chain: charger, trigger, star, J1.self-test complete, the trigger does not cut out, 8.0 V or more during printing
  6. Controller and printer link. Flash, then lora probe; wire W11 (D4 to printer RX) and a ground; baudscan, baud N, selftest; reset the XIAO ten times.probe PASS, 0x1424; one rate prints clean; both edge marks print, ruler 48.0 mm; no stray characters
  7. Current burst test. Bench supply, 3 A limit, scope on a 0.1 ohm shunt: burst 7, then burst (auto) three times on the PD chain, then power.9 V sag 0.5 V or less; no resets; brownout count 0
  8. Darkness. sweep, pick the lowest heat time with a solid black bar and separate checkerboard dots; try density 10, 14, 18; set heat.solid black, no bleed; the last line clears the tear edge after feed
  9. Wi-Fi and messages. factory, scan the setup slip, finish setup. Add a contact; send to the printer and back (section 12). A message from a key that is not a contact must not print.send to slip under 30 s; non-contact held as pending
  10. Sound and light. msg KESTREL-7 HARBOR-2 TEST: the arrival sound plays, then the slip prints. Check the four light patterns through the pipe.clear sound, no rattle; LED visible, not glaring
  11. LoRa. lora probe on buck power; lora cw 2000 14 sends a 2 s carrier at 923 MHz. The radio link itself is still in development; this proves the module and antenna feed.current rises about 45 to 60 mA; carrier seen on an SDR if you have one
  12. Soak, assembled. After section 09: twenty message slips and three self-tests back to back on the PD charger, then power and a touch check.all 23 clean, no resets; buck and trigger under 60 C, printer under 50 C
Never force the heat on a charger

The firmware keeps the print head's peak current inside the charger's 9 V rating (heat auto). Forcing a larger heat block makes the charger cut out and the printer restart mid-slip. Do it only on a current-limited bench supply, as in step 7.

09

Assembly

Time 16 stepsNeeds printed parts, a passed bring-upOutput a finished core, new part lifted off its seat

Assemble only after the electronics have passed bring-up steps 1 to 11 loose on the bench. Each part goes in along its own direction with the earlier parts already in place; the order matters. Images show the part being fitted lifted off its seat, with an arrow in the direction it goes in.

FIG. 4 / Exploded view, numbers are stepsfront right
  1. 01

    Fit the four fixings

    4 x M2 nut4 x M2 heat-set insert
    The chassis with four M2 nuts, lifted off its seat above the corner bosses.

    Resin chassis: Drop an M2 nut into the hex well in each corner boss (the wells open upward). A dot of glue keeps each one in when the chassis is turned over.

    PLA chassis: Turn the chassis over and press an M2 heat-set insert into each boss hole from the plate underside with the soldering iron, flush with the seat face.

    The nuts sit flat and do not turn.

    Each insert is square and flush, not proud of the seat face.

  2. 02

    Fit the LED

    LED PCB, W18, W19
    The LED PCB, lifted off its seat in front of the light column at the front of the chassis.

    Solder W18 (green, anode) and W19 (black, cathode) to the LED PCB, with R1 on the PCB or inline. Feed the wires down the channel at the back of the light column and slide the PCB into its pocket from the front, LED up.

    The LED faces up into the column.

  3. 03

    Drop in the light pipe

    clear light pipe
    The clear light pipe, lifted off its seat above its slot in the light column.

    Drop the polished pipe into its slot from above until it rests just over the LED. Its top end is the light port, level with the printer face; a shell's lens sits over it.

    The pipe slides in with no rattle and both polished ends are clean.

  4. 04

    Fit the antennas

    LoRa FPC, Wi-Fi FPC
    The two flat antennas, lifted off its seat beside the left fin of the chassis, seen from the back left.

    Both antennas are flat FPCs on the outside of the left fin, each in its shallow recess. Stick the LoRa FPC upright on the front half, feed end down; the Wi-Fi FPC on the back half. Plug the leads into the Wio and XIAO u.FL sockets, fully home, Kapton over each. Coil spare coax at 10 mm radius or more, never under a tie.

    Antennas are fitted before any firmware that could transmit is run.

  5. 05

    Click in the buck

    buck converter, set to 5.2 V
    The buck converter, lifted off its seat above its place at the front of the chassis floor.

    Tuck the board under the lip on its left fence and press it down until the flex tab on the right clicks over the edge. Input pads toward the back.

    The trimmer is glued at 5.20 V (bring-up step 1).

  6. 06

    Click in the amplifier

    MAX98357A
    The amplifier board, lifted off its seat above its place on the right of the chassis floor.

    The same way: under the back lip, then click the front tab. Speaker terminals toward the right.

  7. 07

    Click in the XIAO + Wio

    controller stack
    The XIAO and Wio stack, lifted off its seat above its posts, seen from the back left.

    Under the front lip, then click the right tab. Its own USB-C faces the back, with a clear plug path for flashing later.

    The flex tab barb lands on a pad you do not solder; move it if it does not.

  8. 08

    Slide in the PD trigger

    PD trigger, from the back
    The PD trigger board, lifted off its seat sliding into its rails from the back of the chassis.

    Slide the board into its rails from the back, receptacle last, until the PCB front edge meets the two stops. The stops take the plug force and the rail lips hold it down. With no shell, a dot of glue stops it sliding back when a plug is pulled.

    The USB-C receptacle faces straight out of the back.

  9. 09

    Fit the capacitor and the star

    C1, C2, D2, F1
    The bulk capacitor, lifted off its seat above its two saddles beside the PD board.

    Press C1 into its two saddles beside the PD board. Its leads are the star: C2 and D2 are soldered across them, W1 (through F1) and W2 come in from the PD board, W3 to W6 go out.

    C1 and D2 polarity: minus and the TVS band on the correct leads.

  10. 10

    Fit the speaker

    28 mm speaker, foam seal
    The speaker and its foam seal ring, lifted off its seat to the right of the speaker cradle.

    Glue the speaker on the cradle seat, sliding it in from the right until its face is flush with the cradle side. Stick the foam seal ring on the face; a shell's grille wall presses on it.

  11. 11

    Route and tie the wiring

    W1 to W19, ties
    The wire routes, lifted off its seat on the chassis floor, seen from high at the front right.

    Run each bundle on the floor and tie it at the anchors: 9 V pairs beside the PD board, the printer pairs (W3, W4, W11) up into the cable room at the front, the speaker pair at the cradle. Signals leave the XIAO's left column in one lane between the XIAO and the fin (data nearest, then I2S, then LED), tied at the anchor at its front end. The 5 V pair rises beside the XIAO's right edge; its last 8 mm to the 5V pad is a free lead. Leave a 20 mm service loop at the printer harness.

    No wire crosses the refill path or the XIAO's USB-C plug path.

  12. 12

    Press on the printer adapter

    printer adapter
    The printer adapter ring, lifted off its seat above the four chassis posts.

    Press the adapter ring onto the four pins on the post tops until it rests on the posts, notch to the front round the light column. It is a firm slip fit; if the pin coupon showed it loose, a dot of glue on two pins.

    The ring sits flat on all four posts (the fit was set by the adapter pin coupon).

  13. 13

    Lower in the printer

    thermal printer, J1, J2
    The thermal printer, lifted off its seat above the adapter ring.

    Plug J1 and J2 into the printer's leads. Lower the printer straight down through the adapter until the bezel sits on it and both side clips click under the lands. If your printer has ears instead of clips: two M2 x 6 through the bezel flange into the adapter bosses, from above.

    Both clips latched, no rock, the service loop free below.

  14. 14

    Load the paper

    57 x 40 roll
    A paper roll, lifted off its seat above the printer.

    Open the printer door, drop a roll in from above with the paper end toward the front, and close the door with the paper out through the slot.

  15. 15

    Screw on the bench base

    bench base, 4 x M2 x 10
    The bench base and four screws, lifted off its seat below the core, seen from below.

    Stand the core on the bench base over the four holes, the cut-out at the back under the USB-C port. From below, drive four M2 x 10 button head screws up through the base into the corner bosses. Snug, not tight.

    The screw heads sit inside the feet height; the core does not rock.

  16. 16

    Test it

    PD charger
    The finished core on its bench base with a slip of paper above the printer.

    Plug a 9 V PD charger into the back port. Run selftest, check the light, the chirp and a slip, then do the soak in bring-up step 12.

    The brownout count in power is still 0 after the soak.

Service

Printer out: press both clips in from the sides and lift. A different printer needs only a new adapter: pull the old one off the pins. Reflash: the XIAO's USB-C faces the back with a clear plug path under the roll. PD board: slides out backwards through the bench base cut-out. Refills never need the core opened.

With the base shell instead of the bench base

Skip step 15 and go on to section 11: the core slides back into the shell's band, four M2 x 8 hold it from below, and the deck and lid close over it. Another shell takes the same four screws at the length its floor needs.

10

Which screw goes where

Fasteners M2 onlyHeads button, 1.3 mm hexCore screws from below, band screws from the side
FastenerQtyWhereDrivenStep
M2 x 10 button head, ISO 73804bench base (or shell floor) up into the four corner bosses, at 32 and 33.5 from the centrefrom below, 1.3 mm hex15
Resin chassis: M2 hex nut, AF 4.0 x 1.64captive in the hex wells of the corner bosses; the screws above thread into themdropped in, a dot of glue01
PLA chassis: M2 heat-set insert4in the corner boss holes (3.2 dia x 4 deep), flush with the seat facepressed with the iron, from below01
M2 x 62only for a printer with ears: through the bezel flange into the adapter bossesfrom above13
Base shell (section 11)
M2 x 8 button head, ISO 73804up through the band floor (head in the counterbore under each bumper recess) into the four corner bosses; replaces the M2 x 10 of the bench basefrom below, 1.3 mm hexS6
M2 x 6 button head, thread-forming6through the band wall into the bosses on the deck skirt: two on the front (x +-18), two on each side (y +-24), at 10.5 above the deskfrom the side, 1.3 mm hexS9

Screw length rule: the tip must pass the nut or insert by 1 mm. For a floor thicker than 2.5 mm, add the difference to the length. The base shell's band clamps only 1.2 under the seat, so an M2 x 8 passes the nut by 1.2 and the insert by 2.8; an M2 x 10 would stand 1.8 above the boss top. The band screws cut their own thread in a 1.6 pilot: drive them gently and stop when the head seats on its spot face. Keep 2 spare nuts or inserts.

11

Exterior shell

Time 10 steps, about an hourNeeds a finished, tested core, the printed shellOutput the finished PN-84

The Pigeon base shell is three printed parts round the core: a band that is the floor and the lower wall, a deck with the paper slot, the tear trim, the light and the grille, and a lid that lifts off for paper. The core slides into the band, the deck drops over it, ten screws hold the lot and eight magnets hold the lid. Build the core first (section 09, steps 01 to 14, not the bench base) and pass bring-up.

  1. S1

    Print the band, deck and lid

    PN84_p5_band, deck, lid
    The three printed shell parts side by side: the charcoal band, the white deck and the white lid.

    Print them as section 04 says: the deck and lid in your colourway, the band in the band colour. Clear the supports from the inside; the outside should need no sanding. Try the fit before anything goes in: the skirt round the deck's lower edge drops into the band, and the lid sits on the deck behind the slot.

    The deck sits down on the band with an even 0.65 seam all round and does not rock. The lid lifts off and goes back on straight.

  2. S2

    Fit the tear trim

    tear trim, CA glue
    The deck seen from above the front, with the orange tear trim lifted off its pocket round the paper slot.

    The orange trim drops into the 0.7 deep pocket round the front and both ends of the slot, toothed edge toward the slot. Put a few small dots of CA glue in the pocket, never on the teeth, and press the trim flat.

    The trim is flush with the bay floor, the teeth run straight along the slot edge, and a strip of paper slides out past them without catching.

  3. S3

    Fit the light lens

    light lens, UV resin
    The deck with the clear light lens lifted out of its hole in the front slope, along the hole's axis.

    Push the clear lens into the pill-shaped hole in the front slope from outside. The hole leans back toward the light port inside, so push along it, not square to the skin. Stop when its face is flush with the deck, then hold it with a touch of clear UV resin round the inside end.

    From outside the lens face is flush, not sunk or proud. From inside, its lower end points down at where the core's light port will be.

  4. S4

    Press in the lid and deck magnets

    8 x N35 disc 5 x 2, CA glue
    The three printed shell parts side by side: the charcoal band, the white deck and the white lid. The lid and the deck each carry four magnet bosses.

    Eight N35 disc magnets, 5 x 2 mm, hold the lid on: four go in the lid bosses, pressed in from above, and four in the deck rim bosses, pressed in from below. Do the deck now, before it goes on the band. Each is a press fit plus a drop of CA glue. Polarity matters. Stack the magnets and mark the top face of each with a marker, so every marked face is the same pole. Press every lid magnet in with the marked face down and every deck magnet with the marked face up, so each pair attracts.

    Each magnet sits fully in its bore with the glue dry. Hold the lid just above the deck: all four pairs pull together and none pushes away.

  5. S5

    Slide the core into the band

    the finished core
    The band seen from the back left, with the finished core lifted above it, a little forward of its seat.

    Lower the finished core into the band about 1.5 mm forward of its seat, so the USB-C nose clears the back wall. Then slide it back: the USB-C nose enters the pill opening in the back of the band, and the end of the PD board drops into its pocket inside.

    The core sits flat on the floor, the four boss holes over the four floor holes, and the USB-C port is centred in the pill opening.

  6. S6

    Screw the core to the band

    4 x M2 x 8
    The band and core turned over, with four M2 x 8 screws lifted out below the four bumper recesses.

    Turn the band over on a soft cloth, holding the core in. Through each bumper recess, drive an M2 x 8 button head screw up through the floor into the corner boss. Snug, not tight: the floor under the head is only 1.2 thick.

    Each head sits inside its counterbore, below the floor of its recess, so a bumper will lie flat over it.

  7. S7

    Stick on the bumpers

    4 x bumper, 10 x 3.5
    The band and core turned over, with four round black bumpers lifted out of their recesses.

    Wipe the four recesses with alcohol and let them dry. Press a bumper into each one, centred over the screw head, and hold it for a few seconds.

    Stood on the desk, it does not rock and no screw head shows.

  8. S8

    Lower the deck onto the band

    deck with trim and lens
    The deck, with its trim and lens in place, lifted straight above the core in its band.

    Turn it upright. Lower the deck straight down over the core, slot to the front and grille to the right: the skirt round its lower edge drops inside the band and locates it. Nothing needs force; if it stops, lift it and look rather than push.

    The seam is an even 0.65 all round, the six holes in the band line up with the bosses on the skirt, and the grille sits over the speaker.

  9. S9

    Fix the deck with six screws

    6 x M2 x 6, thread-forming
    The assembled band and deck with six band screws lifted out of their holes: two on the front and two on each side.

    Drive the six screws through the band wall into the skirt bosses: two at the front, two on each side. They cut their own thread, so the first turns are stiff. Go gently and stop as soon as each head seats on its spot face; over-driving strips the printed thread.

    All six heads sit flat on their spot faces, and the seam does not open or pinch near any screw.

  10. S10

    Set the lid on

    lid, PD charger
    The finished PN-84 with the lid lifted straight above the deck behind the paper slot.

    Set the lid on the deck behind the slot. The two tapered pins at its front corners seat in sockets in the deck, so the lid fits one way only, and the four magnets then draw it down onto the seam. To change the roll, pinch the lid by its sides and lift it straight off. Plug a 9 V PD charger into the back port and run selftest: the slip comes up through the slot past the trim.

    The pins seat and the lid pulls down by itself; its front edge meets the back of the slot with no gap, the light glows through the lens, and a test slip tears cleanly on the teeth.

Service

Paper: pinch the lid by its sides and lift it off the magnets. Anything else: take the six band screws out and lift the deck straight up; the core stays in the band. To take the core out, peel the bumpers, remove the four floor screws and slide the core forward 1.5 before lifting it, so the USB-C nose clears the pill.

Antennas

Both antennas are on the core's left side. The left band screws sit just behind and in front of the antenna zone; do not add metal (paint, tape, extra screws) to the left face of the shell. The left lid magnet and the left band screws sit near this zone, so check them in the radio test.

For community shells: the interface

what any shell must meet

Any shell that meets the interface below fits the core with no change to it. The base shell above is one example.

Envelope and seat

mm
PointRequirement
Hard box85 x 87 in plan, R 20 corners, from the seat plane to the printer face (59 tall). Keep 1 clear everywhere except where the shell meets the core on purpose
I1 Seatflat floor under the 84 x 86 plate (R 19.5). Reference: seat plane 4 above the desk (feet 1.5 + floor 2.5)
I2 Fixingfour 2.3 holes at x +-32, y +-33.5; M2 x 10 up from below for a 2.5 floor
I3 Paper exitslot at least 59.5 x 2.5, centred on x 0, y -28.5, at the printer face; paper rises vertically
I4 USB-Copening at least 9.4 x 3.7 on the back, centre z 11.65 in the reference placement; a notch open to the lower edge, since the nose stands 5 past the box

Light, sound, refill

mm
PointRequirement
I5 Lightlens over the 7.8 x 1.6 light port at x 0, y -41.85, starting within 1 above it
I6 Speakergrille wall 1.4 to 1.8 from the speaker face on the right side, over the foam ring; open pattern inside radius 10.6
I7 Refilla removable lid over the door; with it off, the space over the door to 70 above the face is free. Anything that stays on ends in front of y -27.5
I9 Heatprint head about 6 W peak under the exit; let warm air leave high at the back and enter low. No fan needed
I10 Antennasboth FPCs on the left fin (x -42, y +-23.5, up to z 54). No metal (paint, inserts, magnets, screws) within 10 of the left side between y -23.5 and 23.5

Frame: +x to the right seen from the front, +y to the back (the USB-C side), origin on the vertical centre line. The full interface, with every figure and the core's extents per height, is cad/INTERFACE.md. Positions are fixed; sizes of bought parts are nominal until measured.

12

Sending messages

Senders contacts onlyEncryption end to endLength plain text, up to 280 characters

The PN-84 prints only messages from its contacts. Messages are Nostr private direct messages (NIP-17), sealed and gift wrapped (NIP-59) and encrypted with NIP-44, sent through public relays (wss://nos.lol and wss://relay.primal.net by default). Relays see the recipient, the size and the time, never the sender or the text.

From a browser

the web sender
  1. Open the web sender page. It makes a sender key in your browser and shows your sender npub.
  2. Become a contact. Give the npub to the printer's owner, who adds you with a short display id (the page shows the exact command): contact add <your npub> ABC-1
  3. Enter the printer's npub (the owner reads it with id or from the setup page), write the message and press Send.
  4. Read the relay list. One relay returning OK is enough. It means the relay has the message, not that it has printed.

Manage key: export the nsec to keep it, import one, or use a NIP-07 browser extension that supports NIP-44. The key lives in the browser's local storage; treat it as a low-value identity used only for this.

From the printer and the command line

USB console, rc-cli
# on the printer's USB console
id                             # this printer's npub, Wi-Fi, relays
contact add npub1... KESTREL-7 rc
send KESTREL-7 hello back      # reply to a contact
pending                        # senders waiting for approval
contact approve KEY ID         # their next message prints

# from a computer, with resilient-comms rc-cli
rc-cli send --peer <printer hex from id> \
  --relays "wss://nos.lol,wss://relay.primal.net" "hello"
Strangers cannot print

A valid message from a key that is not a contact never prints. The sender is held as pending with a 40 character preview, for the owner to approve or dismiss in the admin page (portal) or over USB. Approving does not print the held message; the sender's next one prints.

What a slip shows

Sender and recipient display ids, a serial number, the local time and the path (internet or radio), then the message. Wording and layout depend on the voice the firmware was built with.

A

Troubleshooting

Layout symptom, cause, fix
SymptomLikely causeFix
Printing
Nothing prints, no setup slipbaud rate differs from 9600baudscan; the clean number is the rate; baud N. Or hold FEED at power-up for the printer's own self-test, which lists its rate
Garbled slips3.3 V data not read reliably, or a ground issuefit W12 (TTL ground) first; if still garbled, a 3.3 to 5 V level shifter in W11
A stray character or feed after each resetD4 floats during bootfit R2, 10 kohm from D4 to 3V3
Printer restarts in the middle of a slipthe charger cut out on a current peakuse a charger with 9 V at 2 A or more; keep heat auto; check power for brownouts
Faint or streaky printheat time and density not tunedsweep, then heat and density (bring-up step 8)
The last line does not clear the tear edgetail feed too shortfeed 5 to check, then set the tail feed in config.h
Power
PD trigger reads above 9.45 Vwrong trigger setting or a misnegotiationstop; do not connect the printer. Replace or re-set the trigger
More than 0.5 V of sag during the burst testnot enough local capacitanceadd a second 470 uF at J1 in the cable room
Supply goes into its limit at power-ona short or a reversed partpower off; check C1 and D2 polarity and every W end to end. Never raise the limit
Network
A message does not printsender is not a contact, or the printer reads other relayspending to see held senders; check both sides use a common relay; id shows relay states
Phone will not join from the setup QRslip lost or the QR too small to readsetup prints it again; portal reset restarts setup
Board not found for flashingnot in download modehold BOOT, press and release RESET, release BOOT
No USB console after flashingUSB CDC On Boot disabled in the buildkeep the board defaults; the sketch refuses to build with it off
lora probe failsthe kit's pins differ from config.hstop and fix the LoRa pins before anything else
Fit
Printer will not clip in, or rocksclip land thicknessreprint coupon_clip_land, set PANEL_T, reprint the adapter only. Ears printer: M2 x 6 from above
Nut turns in its well, or insert goes in crookedpocket sizereprint the nut or heat-set coupon and set the winning size before the chassis
PD board slides back when unpluggingno shell to stop ita dot of glue at the rail
B

Licence and credits

Openness every layerStatus being finalised before the first public release
WhatLicence
Hardware: core chassis, printer adapter, bench base, light pipe, interface files, electrical reference. Changes to the core stay open; shells that only connect through the interface choose their own licenceCERN-OHL-W-2.0
Firmware: the sketch and its libraries in the repositoryApache-2.0
Third-party parts of the firmware keep their own terms: libsecp256k1 (MIT), libsodium (ISC), cJSON (MIT), ESP-IDF components (Apache-2.0), arduino-esp32 core (LGPL-2.1)their own licences
Web sender: the sender page (nostr-tools is Unlicense, its noble libraries MIT)Apache-2.0
Documentation: this manual and its images, the spec, wiring and parts lists. Code samples in the docs are Apache-2.0CC BY-SA 4.0
Fonts embedded in this page: Inter, IBM Plex MonoSIL Open Font License 1.1
Names

Pigeon and PN-84 are names used by Reactive Pixels and are not licensed by the above. Compatible devices may say they are based on or compatible with the open platform, but may not use these names as their own branding. Paper rolls are generic and are never sold under the Pigeon name.

© 2026 Rod Leviton, RPXL / Reactive Pixels. The PN-84 page and the rest of the range: Pigeon. More from the studio at reactivepixels.com.