ninlight-w600/sdk/PATCHES.md

Änderungen am WinnerMicro W600 SDK

Quelle: qcx-w600-firmware/qconnex_sdk/ext/WM_SDK_WM600 (QConnex-Stand 2025). Kopiert wurden nur Include, Platform (ohne Boot/armcc), Src/OS, Src/Network, Src/App/{OTA,httpclient,dhcpserver,dnsserver}, Lib/GNU, Bin/secboot.img, Tools/GNU/link_w600_2m.ld (→ ld/) und wm_tool.c (→ tools/).

1. Platform/Common/fwup/wm_fwup.c: wolfSSL-SHA256 durch nl_sha256_* ersetzt, die QConnex-RSA-Prüfung Check_OTA_Image() durch den Hook nl_fwup_verify_tail() (src/sys/nl_fwup_hook.h). Das Image-Format (Header + Payload + 512-Byte-Endblock) bleibt unverändert. Die starke Definition des Hooks liegt seit Plan 3 in src/sys/nl_ota.c (Trailer-Prüfung über nl_trailer_verify()); die bisherige weak-Variante src/sys/fwup_hook_default.c ist entfallen.
2. Src/OS/RTOS/include/FreeRTOSConfig.h: configGENERATE_RUN_TIME_STATS 0, QConnex-Debug-Hooks entfernt.
3. undefined reference beim Linken auf EarlyInit und pre_gpio_config (von sdk/Platform/Sys/wm_main.c als extern-Hooks erwartet, aber nur von der App bereitgestellt): minimale Stubs in src/sys/sdk_stubs.c angelegt (leere Funktionskörper). In der alten Firmware (qconnex_sdk/src/qc_main.c) war pre_gpio_config() bereits ein No-Op; EarlyInit() rief dort nur in die QConnex-Hardwareschicht (QCXH_EarlyInit()), die ninlight nicht verwendet. Board-spezifische Frühinitialisierung (falls nötig) folgt in einem späteren Plan.
4. Platform/Sys/wm_main.c: vApplicationIdleHook() hat bisher jedes Mal tls_watchdog_clr() aufgerufen, wenn der Idle-Task lief - also immer dann, wenn kein anderer Task rechenbereit war. Ein Task-Deadlock (z.B. ein Task, der nl_app_lock() hält und nie freigibt) hätte den Watchdog damit nie ausgelöst, weil der Idle-Task munter weiter gefüttert hätte. Der tls_watchdog_clr()- Aufruf wurde entfernt; wfi bleibt. Der einzige verbleibende tls_watchdog_clr()-Aufruf im SDK ist in Platform/Common/fwup/wm_fwup.c (Firmware-Update-Task) - das ist unkritisch, da er nur während eines laufenden OTA-Updates feuert und den app_task-Heartbeat in src/app_main.c nicht ersetzt (der Watchdog wird sonst ausschließlich dort über den s_light_beat-Heartbeat des light_task gefüttert). Getestet mit dem Konsolenkommando wdtest (src/sys/nl_console_cmd.c, src/sys/nl_console.c): es hält nl_app_lock() für immer, wodurch light_task und app_task blockieren und der Watchdog den Chip zurücksetzen muss.
5. Platform/Drivers/internalflash/wm_internal_fls.c: Semaphor s_fls2_lock serialisiert den Flash-Pfad oberhalb von 1 MB (Pin-Umschaltung via tls_spifls_cs/ck/di/do_switch war ungeschützt). T1 (Plan 2 final review): tls_fls_init() ignorierte den Rückgabewert von tls_os_sem_create(&s_fls2_lock, 1) stillschweigend - jetzt eine printf()-Meldung (TLS_DBGPRT_ERR ist in diesem Build wegkompiliert), falls das Anlegen fehlschlägt (dann bliebe der Bereich oberhalb von 1 MB unprotokolliert ungeschützt).