diff --git a/CHANGELOG.md b/CHANGELOG.md index fa544b9..5ae7054 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,27 @@ ## Zmiany robocze po 2.0.0-rc.1 +- Audyt integracji sprzęt–firmware (2026-10-28), spójność ESP32-S2-MINI + + CC1101 SMA + LM317T: + - Budzenie EXT1: pociągnięcia RTC przycisku i LF konfigurowane przed deep + sleep. Pull-up cyfrowy (`pinMode`) nie działa przy wyłączonej domenie + RTC_PERIPH (dokumentacja ESP-IDF), więc piny budzenia pływały i EXT1 + mogło budzić losowo. Zalecany też zewnętrzny 10 kΩ. + - Konsola: parsowanie liczb odrzuca NaN i nieskończoność (wcześniej + `pressure nan` / `rf freq nan` przechodziły walidację; NaN trafiał do NVS + jako ciśnienie, a `rf freq nan` blokował późniejsze zapisy). Logika + parsowania wydzielona do przenośnego modułu `parse` z testami native. + - Zasilanie: dzielnik ADC R2 270 kΩ → 180 kΩ. Poprzedni dzielnik nasycał + ADC (pełna skala 2,5 V) już powyżej ok. 11,8 V i nie mierzył napięcia + instalacji 12 V w warunkach pracy 12,6–14,4 V. + - `tools/package_release.sh`: pełny obraz `merge_bin` z `--flash-freq 80m` + zgodnym z manifestem `lolin_s2_mini`; poprzednie `40m` nadpisywało + nagłówek bootloadera (80 MHz) innym parametrem niż build. + - `tools/tpms_frame.py`: saturacja temperatury do 0–255 zgodna z firmware + (temperatury ≤ −19 °C psuły ramkę w modelu Pythona). + - Testy: ujemny przypadek checksum odwraca całą komórkę Manchester + (poprzednio ćwiczył naruszenie Manchester zamiast sumy); nowy zestaw + `test_parse` (zakresy, NaN/inf); poprawiony diagram bitów w `PROTOCOL.md`. - Sprzęt docelowy zmieniono na ESP32-S2-MINI (ESP32-S2FN4R2, np. ARD-ESP32-S2-MINI, płytka `lolin_s2_mini`); zaktualizowano target PlatformIO, natywne USB CDC, pinout SPI/przycisku/ADC i polaryzację wbudowanej LED diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 53b93a0..3ca60d2 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -34,9 +34,9 @@ Przed pełnym flashem zapisz ID — partycja NVS może zostać skasowana. Konfig sprawdź po restarcie przez `info`. Migracji z wersji 1.0 bez NVS nie ma; należy wpisać ID w konsoli jeden raz. -## Wyniki testów bez sprzętu (2026-10-27) +## Wyniki testów bez sprzętu (2026-10-28) -- native: 20/20 PASS; +- native: 24/24 PASS (po audycie integracji sprzęt–firmware); - pełny ESP32 build z `-Werror`: PASS; - cppcheck: PASS, 0 defektów; - rtl_433: 64/64 rekordy referencyjne, 3/3 syntetyczne, 3/3 negatywne: PASS. diff --git a/docs/AUDIT.md b/docs/AUDIT.md index 752b6b9..10dc8fe 100644 --- a/docs/AUDIT.md +++ b/docs/AUDIT.md @@ -16,6 +16,13 @@ | P2 | Brak pełnego jednego check/build artefaktów | check_all, CI, Docker, package_release | dodane; wyniki VALIDATION | | P2 | Okno konsoli po każdym RTC zwiększa pobór | sen od razu po cyklu RTC | poprawione; pomiar HIL otwarty | | P2 | README niezgodne z zachowaniem | nowy Quick Start, jedna tabela UI | przepisane | +| P1 | Pull-up cyfrowy przycisku/LF nie działa w deep sleep (EXT1, RTC_PERIPH off) | pociągnięcia RTC + HOLD przed snem | naprawione w power.cpp; HIL budzenia otwarte | +| P1 | `nan` przechodził walidację konsoli (cisnienie/RF) i trafiał do NVS | odrzucanie NaN/inf + testy native | naprawione; `parse` + test_parse | +| P2 | Dzielnik ADC nasycany powyżej ~11,8 V — brak odczytu 12–14,4 V | zakres do ~16 V | naprawione config.h (R2 180 kΩ); wymaga pomiaru | +| P2 | Pełny obraz release z `40m` vs nagłówek builda `80m` | zgodność parametrów flash | naprawione package_release.sh; weryfikacja headera | +| P2 | Model Pythona bez saturacji temperatury (roznica z C++) | clamp 0–255 + self-test | naprawione tpms_frame.py | +| P3 | Ujemny test checksum ćwiczył Manchester zamiast sumy | odwrócenie całej komórki | naprawione test_tpms_frame | +| P3 | Błędne offsety bitów w diagramie PROTOCOL.md | poprawne 72/96/104/112/120 | naprawione | ## Otwarte, wymagające sprzętu diff --git a/docs/HARDWARE.md b/docs/HARDWARE.md index c6568eb..1e01844 100644 --- a/docs/HARDWARE.md +++ b/docs/HARDWARE.md @@ -40,9 +40,9 @@ sprawdź konkretny klon, bo nazwy handlowe bywają używane dla różnych płyte | GPIO6 | MOSI/SI | SPI | | GPIO7 | CS/CSn/SS | SPI | | GPIO10 | GDO0 | diagnostyka biblioteki; GDO2 niepodłączony | -| GPIO3 | przycisk NO do GND | wewnętrzny pull-up; RTC GPIO wakeup, opcjonalny zewnętrzny 10 kΩ | +| GPIO3 | przycisk NO do GND | pull-up RTC włączany przez firmware przed deep sleep (pull-up cyfrowy nie działa w deep sleep); RTC GPIO wakeup, zalecany zewnętrzny 10 kΩ | | GPIO15 | wbudowana LED | aktywna HIGH, firmware steruje właściwą polaryzacją | -| GPIO1 | opcjonalny ADC zasilania przez dzielnik | `PIN_VBAT_ADC`, ADC1_CH0; nigdy 12 V wprost | +| GPIO1 | opcjonalny ADC zasilania przez dzielnik | `PIN_VBAT_ADC`, ADC1_CH0; dzielnik 1 MΩ/180 kΩ (`config.h`), zakres do ok. 16 V; nigdy 12 V wprost | | GPIO2 | opcjonalne ACC po zmianie `PIN_ACC` i zabezpieczeniu | nigdy 12 V wprost | | GPIO14 | opcjonalny detektor LF po zmianie `PIN_LF_TRIGGER` | aktywny LOW; RTC GPIO wakeup, domyślnie wyłączone | | GPIO0 | przycisk BOOT płytki | pin strapping; nie używać do CC1101 ani przycisku sterującego | diff --git a/docs/PROTOCOL.md b/docs/PROTOCOL.md index 22266b6..621528e 100644 --- a/docs/PROTOCOL.md +++ b/docs/PROTOCOL.md @@ -21,7 +21,7 @@ jedynie istnienie takiej klasy urządzenia, nie zgodność tego projektu. Dekoder wymaga dokładnie 120 bitów: 40 bitów synchronizacji i 80 bitów danych. ```text -0 40 64 72 80 88 +0 40 72 96 104 112 120 | 40 × sync (0) | flags 4 B | ID 3 B | P 1 B | T 1 B | sum 1 B | 4C 90 00 70 2F C8 71 68 49 65 ``` diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index 33b82e2..2e26c1f 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -27,7 +27,7 @@ rtl_433_tests commit `1aa8c29…`. Pełne SHA znajdują się w `PROTOCOL.md`. | Komenda | Wynik | |---|---| -| `pio test -e native` | **20/20 PASS** — ramka, cztery niezależne wektory, negatywne, NVS, fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart | +| `pio test -e native` | **24/24 PASS** — ramka, cztery niezależne wektory, negatywne, NVS, parsowanie konsoli (NaN/zakresy), fake clock/radio, Clone IDs, LEARN, SINGLE, ACC, restart | | `pio run -e esp32s2mini` | **PASS**, własne ostrzeżenia traktowane jako błędy (`-Werror`) | | `pio check -e native ... --fail-on-defect=low` | **PASS**, 0 defektów po poprawce inicjalizacji struktur | | `python3 tools/tpms_frame.py --self-test` | **PASS**, nagranie + 500 ramek | diff --git a/platformio.ini b/platformio.ini index 80ee3a5..13c47b2 100644 --- a/platformio.ini +++ b/platformio.ini @@ -33,9 +33,10 @@ build_flags = -DARDUINO_USB_CDC_ON_BOOT=1 [env:native] -; Przenosna logika: ramka, NVS i maszyna stanow (PIN_ACC wlaczony w testach). +; Przenosna logika: ramka, NVS, parsowanie konsoli i maszyna stanow +; (PIN_ACC wlaczony w testach). platform = native build_flags = -std=gnu++17 -Wall -Wextra -Werror -DPIN_ACC=2 -build_src_filter = -<*> + + + +build_src_filter = -<*> + + + + test_build_src = true test_framework = unity diff --git a/src/config.h b/src/config.h index 5029334..fcd5e38 100644 --- a/src/config.h +++ b/src/config.h @@ -32,8 +32,12 @@ #ifndef PIN_VBAT_ADC #define PIN_VBAT_ADC 1 #endif +/* Dzielnik mierzy zasilanie 12 V (prog LOWBATT 11,5 V). R2 = 180 kOhm + * daje pelny zakres ADC ok. 16,4 V przy pelnej skali 2,5 V (11 dB): + * 14,8 V ladowania daje 2,25 V na pinie, wiec odczyt nie nasyci sie. + * Wczesniejsze 270 kOhm nasycale ADC juz przy ok. 11,8 V. */ #define VBAT_DIVIDER_R1 1000000.0f -#define VBAT_DIVIDER_R2 270000.0f +#define VBAT_DIVIDER_R2 180000.0f #define VBAT_CAL 1.000f #define VBAT_SAMPLES 16 #define LOWBATT_THRESHOLD_MV 11500 diff --git a/src/console.cpp b/src/console.cpp index a03b63b..7014da0 100644 --- a/src/console.cpp +++ b/src/console.cpp @@ -1,12 +1,11 @@ /* Konsola szeregowa: konfiguracja zapisywana w NVS, bez rekompilacji. */ #include #include -#include -#include #include #include "app.h" #include "console.h" +#include "parse.h" #include "power.h" #include "settings_store.h" @@ -14,53 +13,6 @@ static char line[96]; static uint8_t line_len; static bool line_overflow; -static bool parse_u32(const char *text, uint32_t lo, uint32_t hi, - uint32_t *out, int base = 10) -{ - if (text == NULL || *text == '\0' || *text == '-') { - return false; - } - errno = 0; - char *end = NULL; - unsigned long value = strtoul(text, &end, base); - if (errno != 0 || end == text || *end != '\0' - || value < lo || value > hi) { - return false; - } - *out = (uint32_t)value; - return true; -} - -static bool parse_i32(const char *text, int32_t lo, int32_t hi, int32_t *out) -{ - if (text == NULL || *text == '\0') { - return false; - } - errno = 0; - char *end = NULL; - long value = strtol(text, &end, 10); - if (errno != 0 || end == text || *end != '\0' || value < lo || value > hi) { - return false; - } - *out = value; - return true; -} - -static bool parse_float(const char *text, float lo, float hi, float *out) -{ - if (text == NULL || *text == '\0') { - return false; - } - errno = 0; - char *end = NULL; - float value = strtof(text, &end); - if (errno != 0 || end == text || *end != '\0' || value < lo || value > hi) { - return false; - } - *out = value; - return true; -} - static bool parse_wheel(const char *text, uint8_t *wheel, bool allow_all = false) { if (allow_all && text != NULL && strcmp(text, "all") == 0) { diff --git a/src/parse.cpp b/src/parse.cpp new file mode 100644 index 0000000..a10271f --- /dev/null +++ b/src/parse.cpp @@ -0,0 +1,53 @@ +#include +#include + +#include "parse.h" + +bool parse_u32(const char *text, uint32_t lo, uint32_t hi, uint32_t *out, + int base) +{ + if (text == NULL || *text == '\0' || *text == '-') { + return false; + } + errno = 0; + char *end = NULL; + unsigned long value = strtoul(text, &end, base); + if (errno != 0 || end == text || *end != '\0' + || value < lo || value > hi) { + return false; + } + *out = (uint32_t)value; + return true; +} + +bool parse_i32(const char *text, int32_t lo, int32_t hi, int32_t *out) +{ + if (text == NULL || *text == '\0') { + return false; + } + errno = 0; + char *end = NULL; + long value = strtol(text, &end, 10); + if (errno != 0 || end == text || *end != '\0' || value < lo || value > hi) { + return false; + } + *out = value; + return true; +} + +bool parse_float(const char *text, float lo, float hi, float *out) +{ + if (text == NULL || *text == '\0') { + return false; + } + errno = 0; + char *end = NULL; + float value = strtof(text, &end); + /* Odwrocone porownanie odrzuca tez NaN (obie strony falszywe). */ + if (errno != 0 || end == text || *end != '\0' + || !(value >= lo && value <= hi)) { + return false; + } + *out = value; + return true; +} diff --git a/src/parse.h b/src/parse.h new file mode 100644 index 0000000..441c322 --- /dev/null +++ b/src/parse.h @@ -0,0 +1,22 @@ +/* Parsowanie argumentow konsoli; modul przenosny (testy native). */ +#ifndef TPMS_PARSE_H +#define TPMS_PARSE_H + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +bool parse_u32(const char *text, uint32_t lo, uint32_t hi, uint32_t *out, + int base = 10); +bool parse_i32(const char *text, int32_t lo, int32_t hi, int32_t *out); +/* Odrzuca NaN i nieskonczonosc; zakres domkniety [lo, hi]. */ +bool parse_float(const char *text, float lo, float hi, float *out); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/power.cpp b/src/power.cpp index 6a6ac6f..07e04d7 100644 --- a/src/power.cpp +++ b/src/power.cpp @@ -2,6 +2,7 @@ #include #include #include +#include #include #if SOC_BT_SUPPORTED #include @@ -74,6 +75,32 @@ void power_deep_sleep(uint32_t seconds) #if PIN_LF_TRIGGER >= 0 wake_mask |= 1ULL << PIN_LF_TRIGGER; #endif +#if SOC_RTCIO_INPUT_OUTPUT_SUPPORTED + /* Cyfrowe pull-up/pull-down (pinMode) nie dzialaja w deep sleep, gdy + * domena RTC_PERIPH jest wylaczona. Bez pociagniec RTC piny budzenia + * plywaja i EXT1 moze budzic losowo; konfigurujemy je tu i utrzymujemy + * mechanizmem HOLD (wg ESP-IDF sleep_modes dla EXT1). */ +#if PIN_BUTTON >= 0 + rtc_gpio_init((gpio_num_t)PIN_BUTTON); +#if BTN_ACTIVE_LEVEL == 0 + rtc_gpio_pulldown_dis((gpio_num_t)PIN_BUTTON); + rtc_gpio_pullup_en((gpio_num_t)PIN_BUTTON); +#else + rtc_gpio_pullup_dis((gpio_num_t)PIN_BUTTON); + rtc_gpio_pulldown_en((gpio_num_t)PIN_BUTTON); +#endif +#endif +#if PIN_LF_TRIGGER >= 0 + rtc_gpio_init((gpio_num_t)PIN_LF_TRIGGER); +#if LF_ACTIVE_LEVEL == 0 + rtc_gpio_pulldown_dis((gpio_num_t)PIN_LF_TRIGGER); + rtc_gpio_pullup_en((gpio_num_t)PIN_LF_TRIGGER); +#else + rtc_gpio_pullup_dis((gpio_num_t)PIN_LF_TRIGGER); + rtc_gpio_pulldown_en((gpio_num_t)PIN_LF_TRIGGER); +#endif +#endif +#endif /* SOC_RTCIO_INPUT_OUTPUT_SUPPORTED */ #if SOC_GPIO_SUPPORT_DEEPSLEEP_WAKEUP esp_deep_sleep_enable_gpio_wakeup(wake_mask, ESP_GPIO_WAKEUP_GPIO_LOW); #else diff --git a/test/test_parse/test_parse.cpp b/test/test_parse/test_parse.cpp new file mode 100644 index 0000000..60cc550 --- /dev/null +++ b/test/test_parse/test_parse.cpp @@ -0,0 +1,71 @@ +#include +#include +#include "parse.h" + +void setUp(void) {} +void tearDown(void) {} + +static void test_u32_ranges_and_bases(void) +{ + uint32_t value = 0u; + TEST_ASSERT_TRUE(parse_u32("260", 0u, 6375u, &value)); + TEST_ASSERT_EQUAL_UINT32(260u, value); + TEST_ASSERT_TRUE(parse_u32("2FC871", 1u, 0xFFFFFEu, &value, 16)); + TEST_ASSERT_EQUAL_HEX32(0x2FC871u, value); + TEST_ASSERT_FALSE(parse_u32("0", 1u, 10u, &value)); + TEST_ASSERT_FALSE(parse_u32("11", 1u, 10u, &value)); + TEST_ASSERT_FALSE(parse_u32("-1", 0u, 10u, &value)); + TEST_ASSERT_FALSE(parse_u32("1x", 0u, 10u, &value)); + TEST_ASSERT_FALSE(parse_u32("", 0u, 10u, &value)); + TEST_ASSERT_FALSE(parse_u32(NULL, 0u, 10u, &value)); +} + +static void test_i32_ranges(void) +{ + int32_t value = 0; + TEST_ASSERT_TRUE(parse_i32("-40", -40, 85, &value)); + TEST_ASSERT_EQUAL_INT32(-40, value); + TEST_ASSERT_TRUE(parse_i32("85", -40, 85, &value)); + TEST_ASSERT_EQUAL_INT32(85, value); + TEST_ASSERT_FALSE(parse_i32("-41", -40, 85, &value)); + TEST_ASSERT_FALSE(parse_i32("86", -40, 85, &value)); + TEST_ASSERT_FALSE(parse_i32("2.5", -40, 85, &value)); + TEST_ASSERT_FALSE(parse_i32(NULL, -40, 85, &value)); +} + +static void test_float_ranges(void) +{ + float value = 0.0f; + TEST_ASSERT_TRUE(parse_float("260.5", 0.0f, 637.5f, &value)); + TEST_ASSERT_FLOAT_WITHIN(0.001f, 260.5f, value); + TEST_ASSERT_TRUE(parse_float("0", 0.0f, 637.5f, &value)); + TEST_ASSERT_TRUE(parse_float("637.5", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("637.6", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("-0.1", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("260,5", 0.0f, 637.5f, &value)); +} + +static void test_float_rejects_nan_and_infinity(void) +{ + /* Regresja: NaN przechodzil stary test zakresu (obie strony falszywe), + * trafial do NVS jako cisnienie i blokowal zapis czestotliwosci RF. */ + float value = 0.0f; + TEST_ASSERT_FALSE(parse_float("nan", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("-nan", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("NaN", 0.0f, 637.5f, &value)); + TEST_ASSERT_FALSE(parse_float("inf", 433.05f, 434.79f, &value)); + TEST_ASSERT_FALSE(parse_float("-inf", 433.05f, 434.79f, &value)); + TEST_ASSERT_FALSE(parse_float("nan", -40.0f, 85.0f, &value)); +} + +int main(int argc, char **argv) +{ + (void)argc; + (void)argv; + UNITY_BEGIN(); + RUN_TEST(test_u32_ranges_and_bases); + RUN_TEST(test_i32_ranges); + RUN_TEST(test_float_ranges); + RUN_TEST(test_float_rejects_nan_and_infinity); + return UNITY_END(); +} diff --git a/test/test_tpms_frame/test_tpms_frame.cpp b/test/test_tpms_frame/test_tpms_frame.cpp index 2afaf81..bc639dc 100644 --- a/test/test_tpms_frame/test_tpms_frame.cpp +++ b/test/test_tpms_frame/test_tpms_frame.cpp @@ -94,9 +94,10 @@ static void test_manchester_polarity_and_negative_frames(void) TEST_ASSERT_FALSE(decode_strict(frame, sizeof(frame) - 1u, payload)); memcpy(damaged, frame, sizeof(frame)); - /* Zmien ostatnia komorke checksum z zachowaniem poprawnego Manchester. */ - damaged[28] ^= 0x40u; - damaged[28] ^= 0x10u; + /* Odwroc cala komorke Manchester (oba chipy) w bicie sumy kontrolnej: + * ramka pozostaje poprawnym Manchesterem, ale suma przestaje sie zgadzac, + * wiec odrzucenie nastepuje wlasnie na etapie checksum. */ + damaged[28] ^= 0x60u; TEST_ASSERT_FALSE(decode_strict(damaged, sizeof(damaged), payload)); } diff --git a/tools/package_release.sh b/tools/package_release.sh index 2f0aa6a..5260876 100644 --- a/tools/package_release.sh +++ b/tools/package_release.sh @@ -17,7 +17,7 @@ cp "$BUILD/bootloader.bin" "$BUILD/partitions.bin" "$BUILD/firmware.bin" \ "$BUILD/firmware.elf" "$OUT/" cp "$BOOT_APP0" "$OUT/boot_app0.bin" "$ESPTOOL" --chip esp32s2 merge-bin -o "$OUT/firmware-full.bin" \ - --flash-mode dio --flash-freq 40m --flash-size 4MB \ + --flash-mode dio --flash-freq 80m --flash-size 4MB \ 0x1000 "$OUT/bootloader.bin" 0x8000 "$OUT/partitions.bin" \ 0xe000 "$OUT/boot_app0.bin" 0x10000 "$OUT/firmware.bin" ( @@ -31,6 +31,7 @@ PlatformIO: 6.1.18 Platforma: espressif32 8.0.0, ESP32-S2-MINI ESP32-S2FN4R2 (lolin_s2_mini) CC1101: de6757ef633b3e626dae5c7835cdb66ab53f9a1d Adresy: 0x1000 bootloader, 0x8000 partitions, 0xe000 boot_app0, 0x10000 firmware +Flash: dio, 80 MHz, 4 MB (zgodne z board manifest lolin_s2_mini) Pelny obraz firmware-full.bin: flash od 0x0. EOF cat "$OUT/BUILD-INFO.txt" diff --git a/tools/tpms_frame.py b/tools/tpms_frame.py index 55e35f1..9b29213 100755 --- a/tools/tpms_frame.py +++ b/tools/tpms_frame.py @@ -38,6 +38,9 @@ def build_row(sensor_id: int, pressure_kpa: float, temp_c: float, raise ValueError("temperatura musi byc w zakresie -40..85 C") num = 9 * tc + 160 temp_f = (num + 2) // 5 if num >= 0 else -((-num + 2) // 5) + # Saturacja zgodna z tpms_frame.cpp: bez niej temperatura <= -19 C daje + # ujemny bajt i psuje ramke (roznica miedzy modelem Pythona a firmware). + temp_f = max(0, min(255, temp_f)) payload = [flags >> 24, (flags >> 16) & 255, (flags >> 8) & 255, flags & 255, sensor_id >> 16, (sensor_id >> 8) & 255, sensor_id & 255, press_byte, temp_f] @@ -76,6 +79,12 @@ def self_test() -> int: if got != expected: print(f"FAIL: nagranie gfile001: {got} != {expected}") return 1 + # Regresja: saturacja temperatury zgodna z firmware (zakres -40..85 C). + for tc, want in ((-40, 0), (-19, 0), (-18, 0), (23, 73), (85, 185)): + byte = decode_row(build_row(0x2FC871, 0, tc))["bytes"][8] + if byte != want: + print(f"FAIL: temperatura {tc} C: {byte} != {want}") + return 1 import random rng = random.Random(42) for _ in range(500):