Device Setup Help
Configure the analyzer / LIS settings on your POCT device to transmit HL7 results
over TCP/IP to this machine, using one of the addresses below and
port 5000.
This machine's addresses
- 10.100.0.1 — wg0 ← likely the address to use on the LAN
- 172.17.0.1 — docker0
- 172.18.0.1 — br-b65fd92e955a
- 172.19.0.1 — br-559f73533ae4
- 172.20.0.1 — br-358efdf2bede
- 95.216.27.126 — enp0s31f6
- 127.0.0.1 — lo (loopback / this machine only)
Settings to enter on the device
| Host / Server IP | 10.100.0.1 |
|---|---|
| Port | 5000 |
| Protocol | HL7 v2 over TCP, MLLP framing enabled |
| Framing bytes | Start 0x0B, End 0x1C, then 0x0D |
| ACK | This server returns an HL7 ACK |
Verify connectivity
From another machine, confirm the port is reachable (replace the IP):
Test-NetConnection 10.100.0.1 -Port 5000 # Windows PowerShell nc -vz 10.100.0.1 5000 # macOS / Linux
Send a synthetic test message
Pipe the bundled sample over MLLP using the included sender script:
pwsh ./scripts/send-hl7.ps1 -Server 127.0.0.1 -Port 5000 -File ./samples/sample-oru-r01.hl7 bash ./scripts/send-hl7.sh 127.0.0.1 5000 ./samples/sample-oru-r01.hl7
Or insert one directly from the Dashboard, or POST raw HL7 to
/api/test/hl7.
Firewall / network notes
- The listener binds to
0.0.0.0:5000.0.0.0.0= all interfaces. - On Windows, allow inbound TCP 5000:
New-NetFirewallRule -DisplayName "Across LIS 5000" -Direction Inbound -Protocol TCP -LocalPort 5000 -Action Allow
- Device and server must be on the same subnet (or routed/reachable). Avoid "Public" Wi-Fi profiles which block inbound.
- The admin UI (this page) runs on a different port (HTTP 8080) from the HL7 listener (5000).