Table of Contents

De SenseCAP M1-shield is bruikbare LoRaWAN-gatewayhardware, maar de bedrading verdient meer aandacht dan in een algemene Raspberry Pi HAT-handleiding. Deze gids bouwt voort op het onderzoek van Clockwork Bird uit 2023 en voegt fabrikantdocumentatie, inspectie van upstreamdrivers en actuele GPIO-richtlijnen toe. Je brengt de hardware in kaart, scheidt vastgestelde feiten van onvolledige pinoutinformatie en maakt een herhaalbaar opstartverslag.

Reikwijdte: Dit is een hardwaregids op basis van documentatie. De opdrachten en pinindelingen zijn voor dit artikel niet getest op een fysieke M1.

Belangrijkste punten

  • Identificeer beide printplaten: de M1-drager en de verwijderbare concentrator hebben aparte model- en revisiegegevens.
  • Controleer resetscripts: de standaardwaarden voor CoreCell botsen met signalen in de gepubliceerde M1-pinout.
  • Controleer de OS-interfaces: SPI-apparaatbestanden, GPIO-nummering en versies van GPIO-tools beantwoorden verschillende vragen.
  • Behoud de beveiligingschipconfiguratie: apparaatinfo lezen is iets anders dan sleutels configureren of genereren.
  • Bewijs het volledige pad: een gevonden concentrator bewijst geen succesvolle sensorgegevensoverdracht.

Voordat je begint

Moeilijkheidsgraad: gemiddeld. Reken ongeveer één tot twee uur voor inventarisatie, OS-voorbereiding en documentatiecontroles. Elektrische verificatie, driveraanpassingen en uitrol van de netwerkserver kosten extra tijd, vooral bij een onbekende printplaatrevisie.

OnderdeelDoel
M1-shield en concentratorNoteer de revisie van de drager en het volledige etiket van de module
Raspberry Pi 4Begin met de host uit het oorspronkelijke M1-ontwerp
Reserve-microSD-kaartBereid een afzonderlijk OS voor en bewaar de oorspronkelijke installatie
Passende voeding en antenneStem deze af op de assemblage en de RF-band van de module
SSH of lokale consoleLeg diagnostiek vast en pas configuratie aan
LoRaWAN-sensor en serverVerifieer na het opstarten van de hardware de daadwerkelijke aflevering van gegevens
Multimeter en hardware-ervaringLos ongedocumenteerde verbindingen op voordat je ze aanstuurt

Fotografeer beide zijden van de spanningsloze assemblage voordat je iets verwijdert. Noteer de richting van connectoren, schroeven, afstandhouders en antenne. Bewaar de oorspronkelijke kaart en configuratie totdat de vervangende installatie je acceptatiecontroles doorstaat.

Identificeer de drie lagen

De volledige M1, de dragershield en de concentrator zijn verschillende onderdelen. Seeed beschrijft de complete hotspot als een Raspberry Pi 4 met een WM1302/SX1302- of WM1303/SX1303-concentrator. Een vermelding met de titel “SenseCAP M1-shield” bewijst niet welke module bij de drager zit. Overzicht van Seeed Studio voor de M1

De drager verbindt voeding en randapparatuursignalen tussen de Pi en module. De concentrator verzorgt radio-ontvangst en -verzending. Een pakketforwarder draait op de host en wisselt ontvangen radiopakketten en geplande downlinks uit met een server. Overzicht van Semtechs SX1302 HAL

Een temperatuursensor op een plank stuurt bijvoorbeeld een uplink via radio. De concentrator ontvangt die, de host stuurt hem door en de netwerk- en applicatieservices verwerken hem. Een succesvolle Linux-start bewijst alleen dat het hostdeel werkt.

De foto van Clockwork Bird toont een M1 v1.1-drager met een module waarop WM1302-SPI-EU868 staat. Gebruik de foto om de labels op je eigen hardware te vinden. De serienummers identificeren de gefotografeerde apparatuur, niet de configuratiewaarden van een andere gateway.

Groene M1-drager met gelabelde WM1302 SPI EU868-module naast USB-C, knop, ventilatoraansluiting en antennekabel

M1 v1.1-hardware gefotografeerd door Clockwork Bird, ook gebruikt als omslag voor dit artikel · Clockwork Bird, 2023-05-03

Voeding en radioverbindingen

Behandel de USB-C-aansluiting van de M1 als voedingsingang. De fabrikant vermeldt 5 V gelijkspanning en 3 A voor de complete gateway en noemt USB-C de voedingsinterface. De term laadpoort suggereert een batterijfunctie die niet in die specificaties staat. Specificaties van de SenseCAP M1

Het blokschema van de leverancier scheidt de 5V-voeding van de gereguleerde 3,3V-rail van de module. Dit verschil is belangrijk bij probleemoplossing: een werkende Pi en een spanningsloze concentrator zijn afzonderlijke mogelijkheden. Zet geen 5 V op een signaalpin en neem niet aan dat twee voedingangen van elkaar geïsoleerd zijn.

SPI- en USB-modulevarianten vereisen verschillende hostverbindingen. De WM1302-documentatie van Seeed beschrijft directe SPI-toegang voor het SPI-model en een STM32L4-USB-brug voor het USB-model. De mini-PCIe-vorm beschrijft de fysieke vormfactor. De gedocumenteerde elektrische interfaces zijn SPI of USB. Een passende aansluiting in een laptop bewijst geen compatibiliteit. WM1302-documentatie van Seeed

Schakel de voeding uit voordat je de module plaatst en sluit een passende antenne aan. Stem radiohardware, antenne en het beoogde netwerkplan op elkaar af. Een andere configuratiebestandsnaam vervangt de RF-onderdelen van de module niet. De voedingsaansluiting van de M1 bewijst ook geen ondersteuning voor een USB-concentratorvariant.

Blokschema met Raspberry Pi 4 verbonden met de M1-shield via voeding, SPI, GPIO en I2C

Fabrikantschema van SenseCAP uit het oorspronkelijke artikel van Clockwork Bird, met het WM1302-ontwerp · Seeed Studio / SenseCAP, via Clockwork Bird

Lees de pinout zorgvuldig

Noteer BCM-GPIO-nummers en fysieke pinnummers in afzonderlijke kolommen. BCM GPIO17 zit bijvoorbeeld op fysieke pin 11 van de Pi-header. De randconnector van de module gebruikt een derde nummering. Het resetpinnummer daarvan is geen GPIO-nummer van de Raspberry Pi.

De tabel schrijft de verbindingen over uit de geannoteerde headerafbeelding van Clockwork Bird. Dit is een gemeenschapsreferentie, geen volledig schema van de fabrikant of meting van elke M1-revisie. De tekening noemt ook SX1262, terwijl het algemene resetscript van Semtech namen voor SX1261 gebruikt.

Signaal in de tekeningBCM / fysieke pinBetekenis
I2C SDA / SCLGPIO2 / 3, GPIO3 / 5Gedeelde beheerbus
SX1302-resetGPIO17 / 11Kandidaat voor reset van de concentrator
Gebruikers-ledGPIO22 / 15M1-aanduiding
SPI MOSI / MISOGPIO10 / 19, GPIO9 / 21SPI-datasignalen
SPI-klokGPIO11 / 23SPI-kloksignaal
SX1302-chipselectGPIO8 / 24SPI0 CE0
SX1262-resetGPIO5 / 29Kandidaat voor reset van de extra radio
SX1262-chipselectGPIO6 / 31GPIO6, anders dan SPI0 CE1
SX1262 BUSYGPIO18 / 12Statusuitgang van de extra radio
SX1262 IO1 / IO2GPIO23 / 16, GPIO24 / 18Extra signalen, verifieer vóór gebruik

De doorgestreepte GPS/UART-aanduidingen bewijzen niet dat een M1 GPS bevat. Laat GPS-configuratie weg tenzij je hardware die functie biedt. Het gepubliceerde diagram geeft ook geen uitsluitsel over de gebruikersknop en ventilatorregeling. Pinoutonderzoek van Clockwork Bird

Geannoteerde Raspberry Pi-headertekening met M1-led, concentratorreset, SPI-signalen en doorgestreepte GPS-verbindingen

Gemeenschapsreferentie zonder bevestiging voor alle printplaatrevisies, geen volledig M1-schema · Clockwork Bird, 2023-05-03

Tegenstrijdigheden in resetscripts oplossen

Een resetscript kiest elektrische uitgangen, niet alleen softwarevoorkeuren. Semtechs upstreambestand reset_lgw.sh is bedoeld voor het CoreCell-referentieontwerp. De standaardwaarden gebruiken GPIO23 voor reset van de concentrator, GPIO18 voor inschakeling van de voeding, GPIO22 voor een extra reset en GPIO13 voor een AD5338R-reset. Broncode van het Semtech-resetscript

De oudere installatie-instructies van Seeed wijzigen de twee resettoewijzingen naar GPIO17 en GPIO5, maar laten andere waarden uit het referentieontwerp staan. Vergelijk die waarden met de geannoteerde M1-afbeelding voordat je het voorbeeld volgt. WM1302-installatie-instructies van Seeed

ToewijzingTegenstrijdige aanwijzingVereiste beslissing
GPIO22 als extra resetM1-afbeelding noemt deze pin de gebruikers-ledVerwijder deze aanname voordat je de led inschakelt
GPIO18 als voedingenableM1-afbeelding noemt deze pin de extra BUSY-uitgangControleer verbinding en richting voordat je de pin aanstuurt
GPIO13 als DAC-resetAlgemeen script noemt een ander referentieontwerpStel vast of het circuit aanwezig is
Extra SPI-apparaatM1-afbeelding kiest GPIO6 in plaats van CE1Controleer chipselectverbinding en driverondersteuning

Afleiding: als GPIO18 volgens de tekening verbonden is met een uitgang van een extra radio, veroorzaakt configuratie als uitgang op de Pi kans op elektrische conflicten. Het verschil vraagt om verificatie, maar bewijst geen schade en ook geen universele M1-bedrading.

Schakel alle voeding uit en volg toegankelijke verbindingen tussen header en moduleconnector. Noteer de printplaatrevisie en beide eindpunten. Een continuïteitsmeting toont een verbinding aan. De componentdocumentatie bepaalt de signaalrichting en elektrische grenzen.

Gebruik het onderstaande moduleschema van de fabrikant om pinnummers van de randconnector niet te verwarren met Pi-headerpinnen. De aanduidingen voor de extra radio beschrijven de gepubliceerde module-referentie. Ze bewijzen niet dat elke revisie dezelfde chip of functies heeft. WM1302-pinout van Seeed

Seeed-tekening met beide zijden van de WM1302-randconnector en voeding, SPI, I2C en radiosignalen

De nummering van de moduleconnector wijkt af van de Raspberry Pi-header · Seeed Studio, WM1302-doc

Raspberry Pi OS voorbereiden

Leg de hostomgeving op je reserve-installatie vast:

cat /etc/os-release
uname -r
tr -d '\0' < /proc/device-tree/model

De OS-versie, kernel en Pi-model vormen het startpunt voor reproduceerbaarheid. Noteer deze gegevens voordat je resultaten met een oudere handleiding vergelijkt.

Installeer inspectie- en bouwtools:

sudo apt update
sudo apt install git build-essential i2c-tools gpiod
sudo raspi-config

Schakel in Interface Options SPI en I2C in en start daarna opnieuw op. SPI ondersteunt de concentratorverbinding. I2C ondersteunt de hieronder besproken beheeronderdelen. Neem geen niet-gerelateerde GPS-aanpassingen van andere HAT-handleidingen over.

Controleer de beschikbare interfaces:

ls -l /dev/spidev* /dev/i2c-*
i2cdetect -l
gpiodetect
gpioinfo
gpioset --version

Deze opdrachten tonen apparaatbestanden, adapters, GPIO-controllers, lijninformatie en de versie van de geïnstalleerde GPIO-tool. i2cdetect -l vermeldt adapters zonder apparaatadressen te scannen. Een bestand zoals /dev/spidev0.0 bewijst dat een SPI-interface beschikbaar is, niet dat een werkende concentrator communiceert. Handleiding van i2c-tools , GPIO-richtlijnen van Raspberry Pi

Houd rekening met GPIO-versies

Kopieer geen globale GPIO-nummers van een andere machine. Oude scripts schrijven via /sys/class/gpio, een interface die de kernel als verouderd documenteert. Nieuwe gebruikersprogramma’s horen de GPIO-character-device-interface te gebruiken met de juiste controller en lijnoffset. Linux GPIO-documentatie

Bekijk ook gpioset --help voordat je een script aanpast. Versie 1 en versie 2 verschillen in syntaxis en procesgedrag. De huidige tool houdt aangevraagde lijnen standaard vast. De overdraagbare interface garandeert hun toestand niet nadat het proces stopt. Documentatie van libgpiod gpioset

Raspberry Pi documenteert gedrag waarbij uitgangen in de kernel actief blijven en geeft opties om dat te wijzigen. Noteer de feitelijke kernelconfiguratie in plaats van aan te nemen dat elk Linux-systeem hetzelfde werkt. Andere nummering of een nieuwere GPIO-tool lost een verkeerde elektrische indeling niet op. GPIO-gebruiksgids van Raspberry Pi

De gebruikers-led testen

Controleer eerst dat GPIO22 met de led verbonden is en verwijder conflicterende gebruikers van die GPIO. Pas daarna de opstartconfiguratie aan:

sudoedit /boot/firmware/config.txt

Moderne Raspberry Pi OS-versies koppelen de opstartconfiguratie aan /boot/firmware/config.txt. Oudere images gebruiken /boot/config.txt, het pad uit het artikel van 2023. Maak een back-up van het actieve bestand voordat je het wijzigt. Documentatie van Raspberry Pi config.txt

Voeg de led-overlay toe onder een toepasselijk gedeelte voor je Pi, zoals [all]:

dtoverlay=gpio-led,gpio=22,label=lorawan,trigger=heartbeat

De parameter gpio gebruikt BCM-nummering. label geeft het Linux-ledapparaat een naam en trigger=heartbeat kiest de kernel-heartbeattrigger. Clockwork Bird meldt deze toewijzing voor de M1 en de overlayreferentie van Raspberry Pi documenteert de parameters. Oorspronkelijke ledwaarneming , Referentie voor de gpio-led-overlay

Controleer na de herstart de geregistreerde led:

ls -l /sys/class/leds/
cat /sys/class/leds/lorawan/trigger

Het verwachte resultaat is een lorawan-ledvermelding met heartbeat tussen vierkante haken. Een knipperende led toont deze GPIO-/driverroute aan. Ze rapporteert geen succesvolle LoRaWAN-registratie, radio-ontvangst of Helium-status.

I2C-apparaten onderzoeken

Een I2C-adres is een aanwijzing, geen apparaatidentiteit. Clockwork Bird zag antwoorden op 0x60 en 0x39 en las daarna ATECC608-informatie via de cryptobibliotheek. De identificatie van de temperatuursensor bleef in het oorspronkelijke artikel onzeker.

Begin met de adapterlijst uit het vorige onderdeel. Brede i2cdetect-scans sturen testtransacties in plaats van passief verkeer te observeren. De upstreamhandleiding waarschuwt voor verstoring. Scan een draaiende gateway of onbekende aangesloten apparaten niet routinematig. Probeergedrag van i2c-tools

WaarnemingOnderbouwde conclusieOpen vraag
Antwoord op 0x60Iets bevestigde de testaanvraagIs dit het verwachte beveiligingselement?
Antwoord op 0x39Iets bevestigde de testaanvraagWelk onderdeel en welke revisie antwoordden?
UU in een scanEen driver bezit het adres, daarom is scannen overgeslagenWelke driver bezit het?
Geen antwoordDe testaanvraag kreeg geen bevestigingVoeding, bus, eigenaarschap of apparaatprotocol?

Sterkere aanwijzing voor de temperatuursensor

STTS751 is op basis van de bronnen een kandidaat voor 0x39. De header van Semtechs temperatuursensordriver koppelt 0x39 expliciet aan STTS751-0DP3F. Dit versterkt de oorspronkelijke hypothese, maar identificeert niet elk printplaatonderdeel op dit adres. Header van de Semtech STTS751-driver

Nadat je een compatibel onderdeel hebt vastgesteld en zeker weet dat geen ander proces het gebruikt, lees je met deze opdrachten de identificatieregisters:

sudo i2cget 1 0x39 0xfd b
sudo i2cget 1 0x39 0xfe b

Hier selecteert 1 de geverifieerde bus, 0x39 het apparaat en vraagt b een SMBus-bytegegevenslezing aan. Bij een STTS751-0 is de gedocumenteerde product-ID op 0xFD 0x00 en de fabrikants-ID op 0xFE 0x53. Deze transacties selecteren registeradressen, maar schrijven geen configuratiewaarden. STTS751-datasheet, registerkaart en identificatieregisters

Vergelijk de waarden met de chipmarkering en documentatie. Een overeenkomend paar ondersteunt de identificatie. Bij een fout controleer je eerst bus en eigenaarschap voordat je de hardwareconfiguratie wijzigt. De sensor meet zijn lokale temperatuur, iets anders dan de CPU-temperatuur van de Pi.

Het beveiligingselement inspecteren

De ATECC608 is een afzonderlijk onderdeel voor authenticatie. Behandel de configuratie, het serienummer, de openbare sleutel en beschermde sleutelgegevens als verschillende concepten. Een leesbare openbare sleutel onthult de bijbehorende privésleutel niet.

Microchips CryptoAuthLib biedt de apparaatinterface. De repository cryptoauthtools bevat voorbeelden die de bibliotheek gebruiken. Bereid volgens de instructies van die projecten de native bibliotheek en Python-bindingen voor je doelsysteem voor voordat je een voorbeeld uitvoert. Een niet-gerelateerd Python-pakket installeren of één script kopiëren levert nog geen werkende I2C-backend op. Microchip CryptoAuthLib , Microchip cryptoauthtools

Voer vanuit een voorbereide map cryptoauthtools/python/examples de inspectieopdracht uit het oorspronkelijke artikel uit:

sudo python3 info.py -i i2c

Het argument -i i2c selecteert de interface. Gebruik in een virtuele omgeving de expliciete Python-interpreter daarvan en controleer of deze de bijbehorende native bibliotheek vindt. sudo python3 kiest bij veel installaties de systeeminterpreter, wat enkele importfouten verklaart.

De geïnspecteerde info.py leest revisiegegevens, serienummer, configuratie en vergrendelingsstatus. Bij een vergrendelde gegevenszone probeert het script de openbare sleutel uit slot 0 op te halen. Het voert de provisioningreeks uit het voorbeeld niet uit. Een mislukte uitlezing van de openbare sleutel uit slot 0 bewijst op zichzelf geen defect apparaat. Broncode van Microchips info.py

Uitvoer of bewerkingBetekenis
Configuratie vergrendeldConfiguratiebeperkingen gelden
Gegevenszone vergrendeldInterpreteer toegang aan de hand van de ingestelde slotbeleidsregels
Openbare sleutel getoondOpenbare informatie is opgehaald, geen export van een privésleutel
config.py uitvoerenProvisioningvoorbeeld met configuratie-, vergrendelings- en sleutelbewerkingen

Voer config.py niet uit om een inspectiefout te herstellen. De bron bevat configuratieschrijfbewerkingen, oproepen om zones te vergrendelen en sleutelgeneratie. De standaardroute voor sleutelgeneratie is ook van belang op een reeds geconfigureerd apparaat. Broncode van Microchips config.py

De provisioningprofielen van Microchip laten zien waarom een vergrendelde gegevenszone niet betekent dat elk slot dezelfde toegangsrechten heeft. Die profielen bewijzen niet wat de exacte M1-configuratie is. Behoud de bestaande apparaatconfiguratie en raadpleeg de documentatie van het juiste onderdeel voordat je hergebruik van sleutels plant. Geheugen- en slottoegangsbeleid van Microchip

Onzekerheden over ventilator en knop behandelen

Een ventilatoraansluiting met drie pinnen zegt niets over spanning, polariteit of regeling. Fotografeer de pinnummering en lees het label van de ventilator. Stel voeding en besturingssignalen vast voordat je een vervanging aansluit of een GPIO-overlay kiest.

Ook is de GPIO van de knop in het oorspronkelijke onderzoek onbekend. Zoek een driver of configuratie die bij je printplaatrevisie hoort en controleer daarna de verbinding met uitgeschakelde voeding. Wijs niet elke ogenschijnlijk ongebruikte GPIO als uitgang toe om de knop te vinden.

RandapparaatTe verzamelen bewijsAcceptatievoorwaarde
VentilatorvoedingNominale waarde van de ventilator, massa en voeding op de connectorGemeten voeding komt overeen met de specificatie van de ventilator
VentilatorregelingDriver/configuratie of getraceerd regelcircuitGedrag bij opstarten en hoge temperatuur is vastgelegd
GebruikersknopBedrading van contacten, GPIO-toewijzing, ingangspolariteitEén bewuste druk veroorzaakt het verwachte evenement

Een nieuwe OS-installatie herstelt niet automatisch het koelbeleid van het oorspronkelijke apparaat. Houd tijdens de eerste langdurige test de ventilatorwerking en temperaturen samen in de gaten. Behoud de luchtstroom in de behuizing en stop de test als de assemblage onvoldoende koelt.

Kies een gatewaystack

Scheid ondersteuning voor de printplaat van het serverprotocol. Een compatibele LoRaWAN-server herstelt geen verkeerde resetprocedure of RF-kalibratie. Kies eerst software die de concentrator, bedrading van de drager, het OS en de regionale configuratie ondersteunt.

SoftwarepadGeschikte rolControle voor uitrol
Semtech SX1302 HALOpstarten op bronniveau en diagnostische toolsResetprocedure van de printplaat en moduleconfiguratie
LoRa Basics StationGeauthenticeerde gatewayverbinding met een serverWerkende printplaatintegratie en servergegevens
ChirpStack ConcentratordAfzonderlijke concentratordienstOndersteund model, kalibratie en GPIO-indeling

ChirpStack vermeldt het SPI-model seeed_wm1302. Dit is bewijs voor moduleondersteuning, geen garantie voor een complete M1-image of ondersteuning van elke M1-revisie. Behandel de aparte installatie-instructies voor SenseCAP M2 niet als M1-firmware-instructies. Hardwareondersteuning van ChirpStack , Seeed-installatiedoel van ChirpStack

Voor The Things Stack beveelt de documentatie LoRa Basics Station aan boven de oudere Semtech UDP-forwarder. Station biedt TLS en tokenauthenticatie plus centrale configuratiefuncties. UDP-voorbeelden zijn nuttig om pakketforwarding te begrijpen, maar hun serveradresinstellingen bieden die bescherming niet. UDP-richtlijnen van The Things Stack , Documentatie van LoRa Basics Station

Upstreamtools voorbereiden

Bouw op de doel-Pi in een nieuwe werkmap:

git clone https://github.com/Lora-net/sx1302_hal.git
cd sx1302_hal
git rev-parse HEAD
make

Bewaar de commit-ID bij je bouwuitvoer. Een geslaagde build toont compilercompatibiliteit, maar de radio vereist nog steeds een geverifieerde resetimplementatie en juiste configuratie. De documentatie van Semtech beschrijft de functie van de HAL en hulpprogramma’s. Bouw- en tooldocumentatie van de SX1302 HAL

Controleer het resetbestand voordat je tools voor hardwaretoegang uitvoert:

sed -n '1,180p' tools/reset_lgw.sh

Kopieer dit bestand niet ongewijzigd naar de runtime-map. Semtech documenteert automatisch gebruik van het resetscript door programma’s voor hardwaretoegang, waaronder identificatietools. Controleer iedere toegewezen pin, signaalrichting, GPIO-API en toestand bij starten en afsluiten.

Volg na verificatie van de printplaat de instructies van de gekozen stack om de concentrator-EUI te lezen en de gateway te registreren. Behoud de kalibratie en RF-instellingen van de module wanneer je de serverconfiguratie toevoegt. In Semtech UDP-configuratie staat gateway_ID voor de EUI. De Gateway ID in de console van The Things Stack is de leesbare registratie-ID. Gatewayconfiguratie van The Things Stack

Sensorgegevensoverdracht bewijzen

Gebruik opeenvolgend bewijs om de eerste falende laag te vinden. Een gateway met de status online heeft verbinding met een server. Je acceptatietest vereist ook een bekende sensor, een passend frequentieplan en een gedecodeerde payload van de toepassing.

De volgende volgorde is een voorgesteld testplan, geen gemeten M1-resultaat:

ControlepuntBewijs om op te slaanBetekenis
Host gereedOS, kernel, voeding en interface-inventarisLinux-voorbereiding is afgerond
Concentrator reageertEUI en geslaagd initialisatielogCommunicatie tussen host en concentrator werkt
Radio ontvangtVerwacht sensorpakket en ontvangstmetadataHet ingestelde ontvangstpad werkt
Server accepteertGatewaygebeurtenis gekoppeld aan de sensorDoorsturen en serverroutering werken
Toepassing decodeertVerwachte meting en tijdstempelHet toepassingspad werkt
Herstel na herstartDezelfde controles na herstartDe opstartconfiguratie is herhaalbaar

Controleer bij een OTAA-sensor ook de activeringsuitwisseling en daaropvolgende uplink. OTAA betekent activering via de ether, de aanmeldprocedure die een sessie opzet. Een ontvangen aanmeldverzoek bewijst geen geslaagde aanmelding of downlinkpad. Activeringsdocumentatie van The Things Stack

Diagnosevoorbeeld: de gateway verbindt met de server en meldt zijn EUI, maar je sensor verschijnt niet. Controleer eerst de zendconfiguratie van de sensor, gekozen ontvangstkanalen, antennepad en radiologs. De ATECC608 opnieuw programmeren verhelpt in dit scenario het ontbrekende bewijs niet.

Tweede diagnose: een sensorpakket verschijnt lokaal, maar bereikt de toepassing niet. Vergelijk de pakkettijd met gateway- en servergebeurtenissen en controleer daarna routering, apparaatregistratie en decodering. Een RF-pakket in een log is onvoldoende reden om de decoder van de payload de schuld te geven zolang de server het evenement niet heeft geaccepteerd.

Problemen per symptoom oplossen

SymptoomControleer eerstVolgende actie
Geen SPI-apparaatbestandActieve opstartconfiguratie en interface-instellingenSchakel de bedoelde interface in en start opnieuw op
SPI bestaat, radio werkt nietVoeding, plaatsing, resetreeks en chipselectVerifieer het elektrische pad voordat je serverinstellingen wijzigt
GPIO-exportfoutAannames over oude sysfs en geïnstalleerde kernelGebruik een gecontroleerde implementatie voor de GPIO-API
GPIO al in gebruikGebruiker die gpioinfo toontLos eigenaarschap op voordat je opnieuw probeert
Led werkt niet na installatieToepassing van overlay en conflicten op GPIO22Controleer geregistreerde ledapparaten en resetscript
I2C-apparaat ontbreektBusnummer, voeding en bestaand eigenaarschapOnderzoek dit zonder herhaalde brede scans
Import van cryptobibliotheek misluktInterpreter, bindingen en pad naar native bibliotheekHerstel de softwareomgeving
Uitlezen openbare sleutel misluktSlotbeleid en eerdere succesvolle uitlezingenControleer de configuratie zonder provisioning
Ventilator draait nietGeverifieerde voeding en koelregelingHerstel de koeling voor langdurige tests
Uplinks komen aan, aanmelding misluktDownlinkpad en regionale/apparaatinstellingenVolg het aanmeldantwoord en de ontvangstvensters

Behandel iedere correctie als één experiment. Bewaar de vorige configuratie, wijzig één variabele, herhaal dezelfde controle en noteer of het verwachte bewijs verscheen.

Maak een hardwareverslag

Gebruik deze sjabloon voor een reproduceerbare overdracht:

Revisie van carrier en foto’s:
Model concentrator, interface en RF-band:
Hostmodel / OS / kernelversie / versie GPIO-tool:
Voeding / antenne / koelopstelling:
Geverifieerde pinmapping en bewijs:
Onopgeloste verbindingen en uitgesloten functies:
Softwarerepository en commit:
Resetimplementatie en GPIO-eigenaarschap:
Gateway-EUI / server / frequentieplan:
Sensoractivering en bewijs van gedecodeerde uplink:
Herstelresultaat na opnieuw opstarten:
Locatie van de oorspronkelijke kaart en rollbackprocedure:

Beslisoefening: je kunt een goedkope losse drager zonder modulelabel kopen of een duurdere assemblage met leesbare labels en gedocumenteerde werking. Bepaal welke bij je project past nadat je de ontbrekende Pi, concentrator, antenne, voeding en verificatietijd aan de vergelijking hebt toegevoegd. De betere keuze volgt uit de totale kosten en het vereiste bewijs voor de beoogde dienst, niet alleen uit de geadverteerde prijs van de drager.

Verwachte redenering: een leerproject kan onopgeloste bedrading verdragen als je meetapparatuur en tijd hebt. Een gateway voor operationele sensoren vereist herhaalbare starts, koeling, softwareondersteuning en aangetoonde gegevensoverdracht. Noteer welke onopgeloste voorwaarde je uitrol zou stoppen.

Volgende stappen

Begin met het hardwareverslag en los de verschillen tussen resetscripts op. Start daarna één bekende sensor op en bewaar bewijs tot en met decodering in de toepassing voordat je meer apparaten toevoegt.

Acceptatieverslag: bewaar de printplaatrevisie, het modulelabel, de radioband, voedingsmeting, actieve SPI-interface, GPIO-lijnnamen, resetreeks, concentratorlog, serververbinding en één gedecodeerde uplink. Markeer elke waarde als waargenomen, gedocumenteerd of nog aangenomen. Een gestart proces bewijst geen RF-prestaties of gegevensoverdracht naar de toepassing.

Als je meshberichten wilt versturen, vergelijk dan eerst de protocolrollen in onze gids voor Meshtastic, MeshCore en Reticulum . Gebruik van dezelfde LoRa-radiotechniek bewijst geen firmwarecompatibiliteit. Raadpleeg voor een berichtentoepassing de hardwaredocumentatie van MeshtasticD en behandel deze LoRaWAN-procedure niet als een conversie naar Meshtastic.

Bronnen en beeldcredits

Onderzoek gecontroleerd op 12 september 2026. Ongedateerde documentatie- en repositorylinks verwijzen naar de versies die voor dit artikel zijn bekeken. Lokale afbeeldingen behouden hun oorspronkelijke labels en toegeschreven herkomst.

UitgeverBron en datum
Clockwork BirdSenseCAP M1 Raspberry Pi Shield , 2023-05-03. Foto van de printplaat, geannoteerde header en gereproduceerd blokschema van de fabrikant
Seeed Studio / SenseCAPM1-overzicht en specificaties , ongedateerd. Oorspronkelijke toeschrijving van het blokschema
Seeed StudioWM1302-documentatie en modulepinout , repository
SemtechSX1302/SX1303 HAL , inclusief gekoppelde broncode voor resetscript en temperatuursensordriver
Raspberry PiOpstartconfiguratie , GPIO-gebruiksgids en overlayreferentie
Linux / libgpiodVerouderde GPIO-sysfs-interface en handleiding voor gpioset , die laatste gedateerd augustus 2026
i2c-toolsHandleiding voor i2cdetect , broncode v4.3
STMicroelectronicsSTTS751-datasheet , revisie 7
MicrochipCryptoAuthLib , cryptoauthtools en documentatie over slottoegangsbeleid
ChirpStackHardwareondersteuning voor Concentratord en Seeed-installatiedoel
The Things IndustriesUDP-forwarder , LoRa Basics Station en apparaatactivering
MeshtasticMeshtasticD-documentatie , ongedateerd