usb-adc-dfr1184

Integracja stosu ADC z OqlOS

Topologia

MCP2221A.G1 0–3,3 V ─ USB HID ─┐
                                ├─ usb-adc-stack-api :8214 ── OqlOS
DFR1184 AIN1/AIN2 0–10 V ─ UART ┘
                         Raspberry Pi 3 /dev/serial0, 9600 8N1

Urządzenia używają niezależnych transportów. MCP2221A nie pośredniczy w komunikacji DFR1184. Wspólna usługa zapewnia tylko jeden spójny kontrakt logicznych kanałów.

Mapowanie kanałów

Pełny profil znajduje się w config/oqlos-adc-stack.yaml.

Kanał	Adapter	Endpoint	Wejście i transport
`ai01`	usb-adc-mcp2221	`:8214/api/v1/adc/1`	MCP2221A G1 / USB
`ai02`	usb-adc-dfr1184	`:8214/api/v1/adc/2`	DFR1184 AIN1 / UART
`ai03`	usb-adc-dfr1184	`:8214/api/v1/adc/3`	DFR1184 AIN2 / UART

Konsumenci powinni używać pola reading.volts. Pola raw_10bit z MCP2221A i raw_hundredth_millivolts z DFR1184 mają różne znaczenie.

Kontrakty HTTP

Wspólna usługa :8214:

Metoda i ścieżka	Znaczenie
`GET /health`	stan obu adapterów
`GET /api/v1/adc`	`ai01–ai03`
`GET /api/v1/adc/{1..3}`	pojedynczy kanał logiczny

Samodzielna diagnostyka DFR1184 :8213:

Metoda i ścieżka	Znaczenie
`GET /health`	odpowiedź `OK` na polecenie `AT`
`GET /api/v1/device`	parametry UART i ADC
`GET /api/v1/adc`	AIN1 i AIN2
`GET /api/v1/adc/{1..2}`	pojedyncze wejście DFR1184

Instalacja i start wspólnej usługi

pip install -e ../usb-adc-mcp2221
pip install -e '.[api]'

[Unit]
Description=OqlOS MCP2221A USB and DFR1184 UART ADC stack
After=network.target

[Service]
Type=simple
User=oqlos
Group=dialout
WorkingDirectory=/home/oqlos/usb-adc-dfr1184
Environment=DFR1184_SERIAL_PORT=/dev/serial0
Environment=DFR1184_BAUDRATE=9600
ExecStart=/home/oqlos/usb-adc-dfr1184/.venv/bin/usb-adc-stack-api
Restart=on-failure
RestartSec=2

[Install]
WantedBy=multi-user.target

Konto musi mieć jednocześnie uprawnienia do MCP2221A HID (reguła udev) i UART (dialout). API domyślnie nasłuchuje na 127.0.0.1:8214.

Semantyka błędów

422 — nieprawidłowy kanał lub parametr;
503 — urządzenie USB, UART albo DFR1184 są niedostępne;
health.ok: false — co najmniej jeden składnik nie przeszedł diagnostyki.

Odczyt DFR1184 przekraczający 11 V jest traktowany jako uszkodzona odpowiedź. Nominalna granica sprzętu pozostaje równa 10 V.

PaHUB2 / ADS1110: mieszane źródła (0.4.0)

STACKNET_ADC_URL=http://stacknet.local:8080 wybiera bank ADC. STACKNET_ADC_CHANNEL_MAP={"ai02":1} przypisuje PaHUB2 CH1 do AI02; AI01 i AI03 pozostają na BoardNet. Można mapować dowolne AI01–AI03 na CH0–CH2, np. {"ai01":0,"ai02":1,"ai03":2}. Konfiguracja jest ładowana przy starcie usługi, więc zmiana wymaga restartu usb-adc-stack. Przy niepustej mapie starszy STACKNET_ADS1100_URL jest ignorowany. Aby wrócić do BoardNet: mapa {} i pusty STACKNET_ADS1100_URL.

Każdy odczyt zachowuje physical_input i adapter. Próbki starsze niż 1000 ms, nasycone, spoza 0–12 V lub z błędną tożsamością są odrzucane. Awaria StackNet oznacza brak tego pomiaru, bez cichego powrotu do innego czujnika. Kalibracja ciśnienia wymaga osobnego potwierdzenia po zmianie źródła.

This site is open source. Improve this page.