|
1 | 1 | # AMSKY01 Software Tools |
2 | 2 |
|
3 | | -Nástroje pro práci se senzory AMSKY01 (MLX90641, SHT4x, TSL2591). |
| 3 | +Tools for working with AMSKY01 sensors (MLX90641, SHT4x, TSL2591). |
4 | 4 |
|
5 | | -## Nástroje pro real-time monitoring |
| 5 | +## Real-time Monitoring Tools |
6 | 6 |
|
7 | 7 | ### `amsky01_viewer.py` |
8 | | -GUI vizualizátor s PyQt/PyQtGraph pro zobrazení dat v reálném čase: |
9 | | -- IR teplotní mapa z MLX90641 (12×16 pixelů) |
10 | | -- Teplota a vlhkost ze SHT4x včetně dew pointu |
11 | | -- Osvětlení z TSL2591 včetně SQM |
12 | | -- Parametry senzorů (Vdd, Ta, rohy IR mapy) |
| 8 | +GUI visualizer with PyQt/PyQtGraph for real-time data display: |
| 9 | +- IR thermal map from MLX90641 (12×16 pixels) |
| 10 | +- Temperature and humidity from SHT4x including dew point |
| 11 | +- Light from TSL2591 including SQM |
| 12 | +- Sensor parameters (Vdd, Ta, IR map corners) |
13 | 13 |
|
14 | | -**Použití:** |
| 14 | +**Usage:** |
15 | 15 | ```bash |
16 | 16 | python amsky01_viewer.py --port /dev/ttyACM0 --baud 115200 |
17 | | -python amsky01_viewer.py --port /dev/ttyACM0 --debug # s výpisem komunikace |
| 17 | +python amsky01_viewer.py --port /dev/ttyACM0 --debug # with communication output |
18 | 18 | ``` |
19 | 19 |
|
20 | | -**Závislosti:** `pyserial`, `numpy`, `pyqtgraph`, `PyQt5` |
| 20 | +**Dependencies:** `pyserial`, `numpy`, `pyqtgraph`, `PyQt5` |
21 | 21 |
|
22 | 22 | --- |
23 | 23 |
|
24 | 24 | ### `amsky01_cli.py` |
25 | | -CLI viewer s curses rozhraním + automatické logování do CSV: |
26 | | -- Real-time zobrazení senzorových dat v terminálu |
27 | | -- Automatické ukládání dat do CSV souborů |
28 | | -- Rotace log souborů každých 10 minut |
| 25 | +CLI viewer with curses interface + automatic CSV logging: |
| 26 | +- Real-time sensor data display in terminal |
| 27 | +- Automatic data saving to CSV files |
| 28 | +- Log file rotation every 10 minutes |
29 | 29 |
|
30 | | -**Použití:** |
| 30 | +**Usage:** |
31 | 31 | ```bash |
32 | 32 | python amsky01_cli.py --port /dev/ttyACM0 --baud 115200 |
33 | 33 | ``` |
34 | 34 |
|
35 | | -**Závislosti:** `pyserial`, `curses` |
| 35 | +**Dependencies:** `pyserial`, `curses` |
36 | 36 |
|
37 | 37 | --- |
38 | 38 |
|
39 | | -## Nástroje pro analýzu logů |
| 39 | +## Log Analysis Tools |
40 | 40 |
|
41 | 41 | ### `plot_logs.py` |
42 | | -Vykreslování grafů z uložených CSV logů: |
43 | | -- Podpora více souborů současně |
44 | | -- Interaktivní režim s auto-refresh |
45 | | -- Export do PNG |
| 42 | +Plot graphs from saved CSV logs: |
| 43 | +- Support for multiple files simultaneously |
| 44 | +- Interactive mode with auto-refresh |
| 45 | +- Export to PNG |
46 | 46 |
|
47 | | -**Použití:** |
| 47 | +**Usage:** |
48 | 48 | ```bash |
49 | 49 | python plot_logs.py sensor_logs/latest.csv |
50 | 50 | python plot_logs.py --interactive --refresh 30 sensor_logs/*.csv |
51 | 51 | python plot_logs.py --output myplot.png sensor_logs/data.csv |
52 | 52 | ``` |
53 | 53 |
|
54 | | -**Závislosti:** `pandas`, `matplotlib`, `numpy` |
| 54 | +**Dependencies:** `pandas`, `matplotlib`, `numpy` |
55 | 55 |
|
56 | 56 | --- |
57 | 57 |
|
58 | 58 | ### `plot_latest.sh` |
59 | | -Bash wrapper pro rychlé vykreslení logů: |
| 59 | +Bash wrapper for quick log plotting: |
60 | 60 | ```bash |
61 | | -./plot_latest.sh # Vykreslí nejnovější log |
62 | | -./plot_latest.sh --all # Vykreslí všechny logy |
63 | | -./plot_latest.sh specific.csv # Vykreslí konkrétní soubor |
| 61 | +./plot_latest.sh # Plot latest log |
| 62 | +./plot_latest.sh --all # Plot all logs |
| 63 | +./plot_latest.sh specific.csv # Plot specific file |
64 | 64 | ``` |
65 | 65 |
|
66 | 66 | --- |
67 | 67 |
|
68 | | -## Formát UART zpráv |
| 68 | +## UART Message Format |
69 | 69 |
|
70 | | -Zařízení komunikuje přes UART rychlostí 115200 baud (konfigurovatelné). Zprávy: |
| 70 | +Device communicates via UART at 115200 baud (configurable). Messages: |
71 | 71 |
|
72 | | -- `$thrmap,<192 hodnot>` - IR teplotní mapa (12×16 pixelů) |
73 | | -- `$cloud,<TL>,<TR>,<BL>,<BR>,<CENTER>` - Rohy a střed IR mapy |
74 | | -- `$cloud_meta,<Vdd>,<Ta>` - Napětí a teplota MLX90641 |
75 | | -- `$hygro,<temp>,<humidity>,<dew_point>` - Teplota, vlhkost, rosný bod |
76 | | -- `$light,<lux>,<full>,<ir>,<gain>,<int_time>,<sqm>` - Osvětlení a SQM |
| 72 | +- `$thrmap,<192 values>` - IR thermal map (12×16 pixels) |
| 73 | +- `$cloud,<TL>,<TR>,<BL>,<BR>,<CENTER>` - Corners and center of IR map |
| 74 | +- `$cloud_meta,<Vdd>,<Ta>` - Voltage and temperature of MLX90641 |
| 75 | +- `$hygro,<temp>,<humidity>,<dew_point>` - Temperature, humidity, dew point |
| 76 | +- `$light,<lux>,<full>,<ir>,<gain>,<int_time>,<sqm>` - Light and SQM |
77 | 77 |
|
78 | 78 | --- |
79 | 79 |
|
80 | | -## Instalace závislostí |
| 80 | +## Installing Dependencies |
81 | 81 |
|
82 | 82 | ```bash |
83 | 83 | pip install pyserial numpy pyqtgraph PyQt5 pandas matplotlib |
|
0 commit comments