usb-adc-dfr1184

Sterownik i lokalny adapter HTTP dla dwukanałowego modułu DFRobot DFR1184 Gravity 0–10 V, podłączonego bezpośrednio do UART Raspberry Pi 3.

Kompletny inwentarz używanego sprzętu, lokalne kopie kart katalogowych, schematy, zdjęcia i stan dokumentacji sensorów ciśnienia znajdują się w hardware/.

Docelowy stos wejść OqlOS używa trzech niezależnych transportów. ADS1100 jest pojedynczym wejściem na StackNet i domyślnie zastępuje DFR1184 AIN1:

Wejście OqlOS	Źródło	Transport	Zakres nominalny
`ai01`	MCP2221A G1	USB HID	0–3,3 V
`ai02`	M5Stack Unit ADC / ADS1100 AIN	StackNet HTTP + I²C	0–8,192 V liniowo
`ai03`	DFR1184 AIN2	RPi3 UART	0–10 V

Projekt zapewnia:

oficjalny protokół UART DFR1184: test AT, zapis rejestru przez 0xCC i odczyt przez 0xBB;
komunikację /dev/serial0, 9600 8N1;
uśrednianie pomiarów i wyniki w jednostkach surowych, mV oraz V;
JSON CLI, samodzielne API DFR1184 oraz wspólne API ai01–ai03;
testowalny backend bez wymagania fizycznego sprzętu w testach jednostkowych.

Instalacja na Raspberry Pi 3

cd ~/github/oqlos/usb-adc-dfr1184
python3 -m venv .venv
.venv/bin/pip install -e '.[api,dev]'

Użytkownik usługi musi mieć dostęp do UART, zwykle przez grupę dialout. Konsolę systemową na porcie szeregowym należy wyłączyć, a UART włączyć w raspi-config. Dokładna procedura jest w hardware/dfr1184/README.md.

Podłączenie

Schemat pin po pinie, zasady zasilania i wariant podłączenia sensora napięciowego są w dokumentacji sprzętowej DFR1184.

CLI

usb-adc-dfr1184 health
usb-adc-dfr1184 info
usb-adc-dfr1184 adc 1 --samples 16 --sample-delay 0.01
usb-adc-dfr1184 adc-all --samples 8
usb-adc-dfr1184 --serial-port /dev/serial0 adc 2

Samodzielne API DFR1184

usb-adc-dfr1184-api
curl http://127.0.0.1:8213/health
curl 'http://127.0.0.1:8213/api/v1/adc/1?samples=16'

Zmienne środowiskowe:

DFR1184_SERIAL_PORT — domyślnie /dev/serial0;
DFR1184_BAUDRATE — wymagane 9600;
DFR1184_UART_TIMEOUT — domyślnie 1.0 s;
DFR1184_API_HOST i DFR1184_API_PORT — domyślnie 127.0.0.1:8213.

Wspólne API ai01–ai03

W produkcji oba lokalne pakiety mogą działać w jednej usłudze:

.venv/bin/pip install -e ../usb-adc-mcp2221
usb-adc-stack-api
curl http://127.0.0.1:8214/api/v1/adc

Wspólna usługa mapuje ai01 na USB MCP2221A, ai02 na ADS1100 przez StackNet oraz ai03 na DFR1184 AIN2. Ustawienia STACKNET_ADS1100_URL i STACKNET_ADS1100_CHANNEL (2 albo 3) pozwalają przełączyć logiczny kanał podczas działania bez reflasha. Pusty URL zachowuje starsze mapowanie obu kanałów DFR1184. Jeden ADS1100 nie może dostarczać dwóch niezależnych ciśnień. Szczegóły zawiera docs/OQLOS_INTEGRATION.md. Nie uruchamiaj jednocześnie wspólnej i samodzielnych usług na tych samych fizycznych urządzeniach.

Gotowa jednostka użytkownika systemd dla BoardNet znajduje się w deploy/systemd/usb-adc-stack.service.

Ograniczenia

Ograniczenia elektryczne i źródła producentów są utrzymywane w jednym miejscu: hardware/. 0,01 mV pozostaje jednostką raportowania protokołu, a nie fizyczną rozdzielczością toru.

Testy

.venv/bin/pytest
.venv/bin/ruff check .
.venv/bin/mypy src/usb_adc_dfr1184

This site is open source. Improve this page.