Ga naar inhoud

Wijzigingen in v1.17.1

RELEASE · DIFF · PIN · STAND VAN DE DOCUMENTATIE

MeshCore v1.17.1 verscheen op 14 augustus 2026. Deze pagina zet op een rij wat er verandert ten opzichte van de commit waarop deze documentatie tot nu toe was gepind, welke hoofdstukken al opnieuw zijn getoetst en welke nog niet. Wat hier staat is afgeleid uit de broncode zelf; de officiële release notes zijn als index gebruikt, niet als bewijs.

Opmerking

Let op de woordkeuze bij UIColor. De officiële release-tabel noemt dit "een nieuw kleurenschema op de companion-UI". Dat dekt de lading niet: een schema is een vastgelegde verzameling kleuren, terwijl UIColor een lijst van negen rollen zónder waarden is, die elke schermdriver apart invult. Deze documentatie gebruikt de term kleurenschema er daarom niet voor.

Opmerking

Bron. Deze pagina is geverifieerd tegen de firmware zelf: MeshCore v1.17.1, commit d929643, 14 augustus 2026, vergeleken met de vorige pin 03b6ef4 van 28 juli 2026. De vergelijking is te reproduceren met tools/diff-impact.py en twee checkouts. De officiële aankondigingen staan op blog.meshcore.io.

Wat er gepind is

De tags companion-v1.17.1, repeater-v1.17.1 en room-server-v1.17.1 wijzen alle drie naar dezelfde commit, d929643. In die commit staat FIRMWARE_VERSION op v1.17.1.

De vorige pin 03b6ef4 was geen release maar een momentopname van main van 28 juli 2026, waarin FIRMWARE_VERSION nog v1.16.0 aangaf. De tag companion-v1.16.0 wijst naar een oudere commit, 07a3ca9 van 6 juni 2026. Wat deze documentatie tot nu toe "v1.16.0" noemde, lag dus tussen de releases v1.16.0 en v1.17.0 in. Een deel van wat de release notes van v1.17.0 opsommen, zat daardoor al in de gepinde tekst.

Wat er nieuw is

De vergelijking 03b6ef4 → d929643 omvat 366 bestanden, met 12.026 toegevoegde en 1.783 verwijderde regels. Per onderwerp, met het bewijs in de broncode:

Onderwerp Bewijs Hoofdstuk
Configuratie in JSON, in /prefs.json src/helpers/ConfigSerializer.{h,cpp} nieuw; src/helpers/CommonCLI.cpp r.30–47 CLI-referentie
cad — hardwarematige CAD vóór het zenden, via get/set src/helpers/CommonCLI.cpp r.470, r.818 Radio
radio.fem.rxgain en radio.fem.txgain, in te stellen en op te vragen src/helpers/CommonCLI.cpp r.544, r.566, r.847, r.853 Radio
extra.sf, op te vragen in elke build maar alleen in te stellen in LR2021-builds schrijven staat achter USE_LR2021 op src/helpers/CommonCLI.cpp r.779, met de setter op r.780 en de getter op r.976 Radio
radio.rxgain niet langer achter een buildoptie; room server past hem nu ook toe src/helpers/CommonCLI.cpp r.535; examples/simple_room_server/MyMesh.cpp r.727 Radio
eth.status en Ethernet-ondersteuning (RAK13800, CH390, serieel) src/helpers/ethernet/, nrf52/EthernetCLI.h nieuw Ethernet
Naam in de advert afgekapt op een UTF-8-codepointgrens src/helpers/AdvertDataHelpers.cpp r.21, UTF8Helpers.h nieuw Systeem
room.post — een room server plaatst zelf een bericht examples/simple_room_server/MyMesh.cpp r.977 Requests en CLI
LR2021-radio src/helpers/radiolib/CustomLR2021.h nieuw De LR2021
Tot vier seriële interfaces naast elkaar op de companion src/helpers/MultiSerialInterface.h nieuw De drie transporten
Hardwarecrypto (CC310) op nRF52, voor elke nRF52-build nRFCrypto in vier bestanden, in 03b6ef4 nog nergens Private & Public Key Encryptie
Kleur als rol op de companion-UI: negen rollen die elke schermdriver zelf invult UIColor in 32 bestanden, in 03b6ef4 nog nergens Het scherm
Routeringsbeleid in een eigen bestand: drie hoplimieten, vier antwoordroutes, drie antwoordscopes src/helpers/RoutingPolicy.h nieuw, 68 regels; ingesloten door examples/simple_repeater/MyMesh.h r.37 en examples/simple_room_server/MyMesh.h r.24 Regio's en Scopes
Schermdriver NV3001B, de enige die de UI-coördinaten opschaalt src/helpers/ui/NV3001BDisplay.{h,cpp} nieuw; variants/heltec_rc32/ Het scherm
Trilling via een DRV2605-aanstuurchip, naast de bestaande pinaansturing src/helpers/ui/DRV2605Vibration.h nieuw; GenericVibration.h bestond al Terugkoppeling
Negen nieuwe varianten: heltec_tower_v2, heltec_rc32, heltec_v4_r8, meshnology_w12, meshtracker_x1, nibble_zero_connect, station_g3_esp32, thinknode_m7, thinknode_m9 nieuwe mappen onder variants/ gedeeltelijk: vijf staan in Nodematrix, heltec_rc32 in ESP32 en Het scherm; heltec_v4_r8, meshnology_w12 en nibble_zero_connect nog niet

Twee dingen uit de release notes van v1.17.0 zaten al ín de vorige pin en zijn dus geen wijziging voor deze documentatie: get pwrmgt.bootreason en de ST7735-schermdriver.

Wat er vervallen is

Niets in de commandoregel. Tussen beide commits telt de firmware 40 commando's in CommonCLI.cpp, in beide gevallen dezelfde 40. Het aantal instellingen onder get/set gaat van 80 naar 88; alle 80 oude bestaan nog.

De vergelijking verwijdert drie bestanden, geen daarvan een functie van een node:

Bestand Wat ermee gebeurde
.vscode/extensions.json ontwikkelbestand, geen firmware
variants/minewsemi_me25ls01/NullDisplayDriver.h verplaatst naar de gedeelde src/helpers/ui/NullDisplayDriver.cpp
variants/wio-e5-mini/NullDisplayDriver.h idem

Binnen deze documentatie is de pagina Na de gepinde commit uit de inhoudsopgave gehaald. Die beschreef de commando's die alleen op main bestonden — cad, radio.fem.rxgain, radio.fem.txgain, extra.sf en eth.status. Ze horen alle vijf bij v1.17.1 en staan nu op Radio en Ethernet. Het bestand cli/after-pinned-commit.md staat nog wel in beide taalbomen, zonder verwijzing vanuit een README en zonder plek in het menu; het verwijderen ervan wacht op een uitdrukkelijke opdracht.

Wat nog op de oude pin staat

Waarschuwing

De documentatie draagt op dit moment twee pins. Alleen de hoofdstukken in de tabel hieronder zijn tegen d929643 getoetst. Alle andere hoofdstukken noemen in hun eigen Bron.-blok nog 03b6ef4 en zijn dus niet opnieuw gecontroleerd. Ga bij elk hoofdstuk af op het bronblok bovenaan die pagina, niet op deze pagina.

Drieëntwintig hoofdstukken per taal noemen d929643 in hun bronblok. Te herhalen met grep -rl d929643 docs/nl --include='*.md'.

Sectie Hoofdstukken op d929643
CLI-referentie CLI-referentie, Radio, Systeem, Ethernet
Techniek Private & Public Key Encryptie°, Regio's en Scopes°, Requests en CLI
Hardware De LoRa-transceiver, De LR2021, Het scherm, Terugkoppeling
Platform MeshCore Platforms, De vier platformfamilies, Nodematrix en de vier pinbezettingen
Ontwerp Node Het klassenmodel, Compile-time configuratie, Platformrealisatie°
Ontwerp Companion De drie transporten
Project deze pagina

° Gedeeltelijk: het bronblok van dat hoofdstuk zegt welke secties tegen d929643 zijn getoetst en welke tekst nog op de oude pin staat.

Nog niet hertoetst, gemeten met tools/diff-impact.py: 87 van de 119 hoofdstukken per taal noemen in hun bronblok minstens één bestand dat tussen 03b6ef4 en d929643 is gewijzigd. Negentien daarvan staan in de tabel hierboven; de overige 68 staan nog op de oude pin. Een gewijzigd bronbestand is geen bewijs dat de tekst fout is, maar het is wel de lijst die nagelopen moet worden. De zwaartepunten zijn nu Direct Messages, de overige cli/-hoofdstukken en de companion/-sectie.

Bronnen