Skip to content

Voorkom vastlopende OpenTherm-framedelay bij klokoverloop - #12

Merged
jeroen85 merged 1 commit into
mainfrom
codex/hil-opentherm-delay-wrap
Oct 23, 2026
Merged

jeroen85 merged 1 commit into
mainfrom
codex/hil-opentherm-delay-wrap

Conversation

@jeroen85

@jeroen85 jeroen85 commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Een ontvangen OpenTherm-frame kon rond de overloop van de 32-bits CPU-cycleteller de framedelay te vroeg beëindigen of in DELAY blijven hangen. Bij 240 MHz loopt die teller ongeveer elke 17,896 seconden rond. De wachttijd gebruikt voortaan een 64-bits monotone microsecondenklok en geeft READY vrij zodra de volledige 100 ms verstreken zijn.

Wijziging

  • OpenTherm.cpp en OpenTherm.h: gebruik esp_timer_get_time() en uint64_t voor de framedelay; vergelijk met >=. De oude herinitialisatie bij een deadlinewaarde van nul vervalt. Begin/end/reset wissen de deadline. De deadline wordt vóór de responsecallback gezet, zodat callbacktijd meetelt en een callback die TX start zijn bestaande toestandsovergang behoudt.
  • tests/opentherm_frame_delay_test.py: compileer de echte productiebody van process() en reset_receive_state_() met deterministische klokken. Hardware-RX/TX, pariteitscontrole en callbacks worden gestubd.
  • .github/workflows/ci.yml: voer de regressie uit in de bestaande host-testjob.

De diff bevat alleen deze vier bestanden: 240 toevoegingen en 10 verwijderingen. De RMT-/ISR-klok, framedecodering en bestaande éénseconde-timeout veranderen niet.

Validatie

  • python3 tests/opentherm_frame_delay_test.py: acht scenario’s geslaagd, ieder voor master en slave: normale 100ms-grens, late wrap, voortijdige wrap, nuldeadline, lange schedulerpauze, callbacktijd, callback die TX start en reset/hergebruik.
  • Dezelfde regressie tegen de ongewijzigde OpenTherm.cpp/.h uit basiscommit a12b06e28d2ecf3ce2a8a6c2a452ad6083b77022: zeven van acht scenario’s falen; alleen callback-tx slaagt. Dit zijn scenarioresultaten; een oude assert beëindigt een scenario bij de eerste falende rol.
  • Vers uitgevoerd met Apple Clang 17, C++17 en -Wall -Wextra -Werror. Op deze Mac waren expliciete SDK/libc++-includes nodig; de eerste poging met de standaard compiler kon <cassert> niet vinden. De Ubuntu-CI-opdracht blijft de canonieke opdracht hierboven.
  • Linux-CI op 971f1105: beide jobs groen — generated ODU-contract, bestaande hosttests, de acht OpenTherm-klokscenario’s, SSE-lifecyclefoutinjectie, validatie van de boiler-only-config en compilatie van de combined-simulatorfirmware. GitHub heeft voor deze PR mergecommit b1cb6a6ab1ff73b1280775d23a720c68d680e6e2 met de actuele doelbranch gemaakt; de PR is conflictvrij.
  • Het lokale buildmanifest bevestigt daarnaast de eerder gebouwde, hieronder beschreven combined-simulatorimage. Tijdens het voorbereiden van deze PR is geen nieuwe lokale firmwarebuild of OTA uitgevoerd.

De hostfixture test de productie-toestandsmachine, niet de echte RMT-capture, pariteitsfouten, ISR-interleavings of fysieke begin/end/OTA-teardown. Beide software-rollen zijn getest; dit is geen volledige fysieke foutinjectiedekking.

HIL-provenance

Het fysieke campagnebewijs hoort bij basis a12b06e28d2ecf3ce2a8a6c2a452ad6083b77022 plus exact de patch die is vastgelegd als 971f1105a6085c778c5a73fc6092125dfb2bb712. De image is vóór die commit gebouwd uit dezelfde bronwijziging.

Gegeven Waarde
Simulatorversie v0.6.0-quality-delay-wrap
Contract openquatt-modbus-opentherm-v2
Config hash 0xf73ef106
OTA-grootte 956880 bytes
OTA SHA256 eeb2ae90520eeb6aea10834840071c1b91e68797f6f77ee1ee4efe9e3b75e9c9
ELF SHA256 2bc184ed505eb6b6d05a70a5f64fa76302f952e44893b276394da8fbba8b7171

In het aangeleverde fysieke baseline-bootvenster 23:44–23:50 UTC stegen de thermostaat/master-tellers van req=1536/rsp=1483 naar req=1890/rsp=1837, met maximaal 1020 ms responseleeftijd en een stabiele historische invalid=6. Na een verse simulatorstart werd req=24/rsp=23/invalid=0 gemeten. Dit toont voortgaande fysieke OT-uitwisseling; het bewijst niet dat iedere fout- of lifecyclegrens is afgedekt en vormt geen geheugenmargekwalificatie. Deze campagnemetingen zijn afzonderlijk van de buildmanifeststatus vastgelegd: het kwalificatieveld van dat manifest beschrijft nog het eerdere buildmoment (“compiled; not flashed or physically qualified”).

Audit en integratiegrens

De volledige vierbestandendiff is koud beoordeeld op wrap/nuldeadline, callback/TX-overgangen, reset/begin/end, RMT/ISR-toegang, master/slave en regressie-/CI-afbakening. De nieuwe 64-bits deadline wordt niet vanuit de ISR gelezen of geschreven. Er zijn bij deze bronreview geen nieuwe blokkerende bevindingen gevonden.

Basis a12b06e is al opgenomen in main via PR #10. De bekeken actuele main-tip ec8d2de8bf757cbcb9858c4712a9b0df696bdc0b bevat drie latere commits ten opzichte van die basis, waaronder profielgebonden ODU-buitenbegrenzing/registers en de simulatorversie v0.7.0. Die veranderingen raken veertien andere paden en overlappen geen van de vier fixbestanden. Hun ODU-gedrag is niet met de hierboven genoemde image fysiek getest. De HIL-bronbranch is daarom voor deze voorbereiding niet gerebased. De groene PR-CI bevestigt inmiddels de buildintegratie met de huidige doelbranch; fysiek ODU-gedrag van die drie latere commits blijft buiten het hierboven gemeten bewijs.

@jeroen85
jeroen85 marked this pull request as ready for review October 23, 2026 17:56
@jeroen85
jeroen85 merged commit e61e8ab into main Oct 23, 2026
2 checks passed
@jeroen85
jeroen85 deleted the codex/hil-opentherm-delay-wrap branch October 23, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant