Antenna Control

The U300 supports up to 8 antenna ports. Parlevel lets you enable or disable individual ports per location and persists the selection to Supabase so it survives relay restarts.

Setting active antennas

Via the UI

1. Go to Locations → [Location Name] → RFID tab
2. Scroll to Antenna Control
3. Toggle individual antenna ports on or off
4. Changes apply immediately — the relay is updated in real time

The selection is saved to the location's device_config row in Supabase and reapplied automatically every time Start RFID is clicked.

Via the API

POST /api/rfid/u300/antennas/mask
Authorization: Bearer <token>
x-selected-location: <locationId>
Content-Type: application/json
 
{
  "antennas": [1, 2, 4]
}

Valid port numbers: 1 through 8. Omitting a port disables it.

Persistence

When you toggle an antenna in the UI (or call the mask API), two things happen:

1. The mask is sent to the relay immediately (POST /antennas/mask on the U300)
2. The selection is saved to device_config in Supabase as u300.antennas: [1, 2, 4]

On the next Start RFID, the saved mask is reapplied before ingest starts — so you never need to re-configure after a relay restart.

Priority order

If u300.antennas is empty ([]) in the saved config, the relay uses whatever antenna configuration it already has (hardware default = all ports active). A non-empty array always overrides.

Reading current status

GET /api/rfid/u300/antennas/status
Authorization: Bearer <token>

Returns configuredAntennas: [1, 2, 4] from the live relay state.

GET /api/rfid/u300/config
Authorization: Bearer <token>

Returns the full persisted config including result.u300.antennas.

Physical layout tips

• Ports 1–4 are typically on the front panel
• Ports 5–8 are on the rear panel (8-port model)
• Disable unused ports to reduce read noise from adjacent areas
• For a single bar station, 1–2 antennas directly under the shelf are usually sufficient