Table of Contents

Der SenseCAP M1 Shield eignet sich als LoRaWAN-Gateway-Hardware, doch seine Verdrahtung erfordert mehr Prüfung als eine allgemeine Raspberry-Pi-HAT-Anleitung. Dieser Leitfaden erweitert Clockwork Birds Untersuchung von 2023 um Herstellerunterlagen, eine Prüfung des Upstream-Treibers und aktuelle GPIO-Hinweise. Du identifizierst die Hardware, trennst gesicherte Fakten von unvollständigen Pinout-Angaben und erstellst ein wiederholbares Inbetriebnahmeprotokoll.

Umfang: Dies ist ein dokumentationsbasierter Hardwareleitfaden. Befehle und Board-Zuordnungen wurden für diesen Artikel nicht an einem physischen M1 getestet.

Wichtigste Erkenntnisse

  • Identifiziere beide Boards: Trägerplatine und entfernbarer Konzentrator haben eigene Modell- und Revisionsangaben.
  • Prüfe Reset-Skripte: CoreCell-Standardwerte widersprechen Signalen im veröffentlichten M1-Pinout.
  • Prüfe OS-Schnittstellen: SPI-Gerätedateien, GPIO-Nummerierung und Werkzeugversionen beantworten verschiedene Fragen.
  • Erhalte die Provisionierung des Secure Elements: Geräteinformationen auszulesen unterscheidet sich vom Konfigurieren oder Erzeugen von Schlüsseln.
  • Belege den vollständigen Pfad: Ein erkannter Konzentrator beweist keine erfolgreiche Sensordatenübertragung.

Vor dem Start

Schwierigkeitsgrad: mittel. Plane etwa ein bis zwei Stunden für Inventarisierung, OS-Vorbereitung und Dokumentationsprüfungen ein. Elektrische Verifikation, Treiberanpassungen und Serverbereitstellung erfordern zusätzliche Arbeit, besonders bei einer unbekannten Board-Revision.

GegenstandZweck
M1 Shield und KonzentratorTrägerrevision und vollständige Modulbeschriftung ablesen
Raspberry Pi 4Mit dem Host aus dem ursprünglichen M1-Design beginnen
Ersatz-microSD-KarteSeparates OS vorbereiten und ursprüngliche Installation erhalten
Passendes Netzteil und AntenneHardwareaufbau und RF-Band des Moduls berücksichtigen
SSH oder lokale KonsoleDiagnosedaten erfassen und Konfiguration bearbeiten
LoRaWAN-Sensor und -ServerAnwendungsauslieferung nach der Inbetriebnahme verifizieren
Messgerät und HardwarekenntnisseNicht dokumentierte Verbindungen vor dem Ansteuern untersuchen

Fotografiere beide Seiten der stromlosen Baugruppe, bevor du etwas entfernst. Notiere Steckerausrichtung, Schrauben, Abstandshalter und Antennenführung. Bewahre Originalkarte und Konfiguration auf, bis die Ersatzinstallation die Abnahmekriterien erfüllt.

Die drei Ebenen identifizieren

Der komplette M1, sein Träger-Shield und sein Konzentrator sind verschiedene Komponenten. Seeed beschreibt den Hotspot als Raspberry Pi 4 mit einem WM1302/SX1302- oder WM1303/SX1303-Konzentrator. Ein Angebot mit dem Titel „SenseCAP M1 Shield“ belegt nicht, welches Teil mit der Trägerplatine geliefert wird. Seeeds M1-Übersicht

Der Träger verbindet Stromversorgung und Peripheriesignale zwischen Pi und Modul. Der Konzentrator übernimmt Funkempfang und -übertragung. Ein Packet Forwarder läuft auf dem Host und tauscht empfangene Funkpakete sowie geplante Downlinks mit einem Server aus. Semtechs SX1302-HAL-Übersicht

Ein Temperatursensor sendet zum Beispiel ein Uplink-Paket per Funk. Der Konzentrator empfängt es, der Host leitet es weiter und Netzwerk- sowie Anwendungsdienste verarbeiten es. Ein erfolgreicher Linux-Start bestätigt nur den Host-Teil dieser Kette.

Clockwork Birds Foto zeigt eine M1-Trägerplatine v1.1 mit einem als WM1302-SPI-EU868 beschrifteten Modul. Nutze das Foto, um Beschriftungen deiner eigenen Hardware zu finden. Seriennummern identifizieren das fotografierte Gerät, nicht die Konfiguration eines anderen Gateways.

Grüne M1-Trägerplatine mit beschriftetem WM1302-SPI-EU868-Modul neben USB-C, Taste, Lüfteranschluss und Antennenkabel

M1-v1.1-Hardware von Clockwork Bird, auch für das Titelbild verwendet · Clockwork Bird, 2023-05-03

Stromversorgung und Funkverbindungen

Behandle den USB-C-Anschluss des M1 als Stromeingang. Der Hersteller nennt für das komplette Gateway 5 V DC und 3 A und führt USB-C als Stromversorgungsanschluss auf. Die Bezeichnung Ladeanschluss deutet eine Akkufunktion an, die diese Spezifikation nicht nennt. SenseCAP-M1-Spezifikationen

Das Blockdiagramm trennt die 5-V-Versorgung von der geregelten 3,3-V-Schiene des Moduls. Ein laufender Pi bei gleichzeitig stromlosem Konzentrator ist möglich. Lege niemals 5 V an einen Signalpin an und gehe nicht von isolierten Stromeingängen aus.

SPI- und USB-Modulvarianten benötigen unterschiedliche Hostverbindungen. Seeeds WM1302-Dokumentation beschreibt direkten SPI-Zugriff für das SPI-Modell und eine STM32L4-USB-Brücke für das USB-Modell. Mini-PCIe beschreibt den Formfaktor; die dokumentierten elektrischen Schnittstellen sind SPI oder USB. Ein mechanisch passender Laptop-Steckplatz belegt keine Kompatibilität. Seeeds WM1302-Dokumentation

Setze das Modul bei getrennter Stromversorgung ein und schließe eine geeignete Antenne an. Stimme Funkhardware, Antenne und Netzwerkplan aufeinander ab. Eine Konfigurationsänderung ersetzt keine Funkkomponenten. Der M1-Stromanschluss belegt auch keine Unterstützung einer USB-Konzentratorvariante.

Blockdiagramm mit Raspberry Pi 4 und M1 Shield, verbunden über Stromversorgung, SPI, GPIO und I2C

SenseCAP-Herstellerdiagramm aus Clockwork Birds Originalartikel zum WM1302-Design · Seeed Studio / SenseCAP, via Clockwork Bird

Pinout sorgfältig prüfen

Führe BCM-GPIO-Nummern und physische Header-Pinnummern getrennt auf. BCM GPIO17 liegt beispielsweise am physischen Pin 11 des Pi-Headers. Der Modulstecker verwendet eine dritte Nummerierung. Seine Reset-Pinnummer ist keine Raspberry-Pi-GPIO-Nummer.

Die Tabelle überträgt Verbindungen aus Clockwork Birds annotierter Headergrafik. Sie ist eine Community-Referenz, kein vollständiger Hersteller-Schaltplan und keine Messung jeder M1-Revision. Die Grafik nennt SX1262, während Semtechs allgemeines Reset-Skript SX1261 aufführt.

Signal in der GrafikBCM / physischer PinInterpretation
I2C SDA / SCLGPIO2 / 3, GPIO3 / 5Gemeinsamer Verwaltungsbus
SX1302-ResetGPIO17 / 11Möglicher Konzentrator-Reset
Benutzer-LEDGPIO22 / 15M1-Markierung
SPI MOSI / MISOGPIO10 / 19, GPIO9 / 21SPI-Datensignale
SPI-TaktGPIO11 / 23SPI-Taktsignal
SX1302-Chip-SelectGPIO8 / 24SPI0 CE0
SX1262-ResetGPIO5 / 29Möglicher Zusatzfunk-Reset
SX1262-Chip-SelectGPIO6 / 31GPIO6, verschieden von SPI0 CE1
SX1262 BUSYGPIO18 / 12Statusausgang des Zusatzfunks
SX1262 IO1 / IO2GPIO23 / 16, GPIO24 / 18Zusätzliche Signale, vor Nutzung prüfen

Durchgestrichene GPS-/UART-Markierungen belegen keinen GPS-fähigen M1. Lasse GPS-Einrichtung weg, sofern deine Hardware sie nicht unterstützt. Die Grafik klärt auch Benutzertaste und Lüftersteuerung nicht. Clockwork Birds Pinout-Untersuchung

Annotierte Raspberry-Pi-Headerzeichnung mit M1-LED, Konzentrator-Reset, SPI-Signalen und durchgestrichenen GPS-Verbindungen

Community-Referenz ohne vollständige Abdeckung der Board-Revisionen, kein vollständiger M1-Schaltplan · Clockwork Bird, 2023-05-03

Konflikte in Reset-Skripten auflösen

Ein Reset-Skript wählt elektrische Ausgänge, nicht nur Softwarepräferenzen. Semtechs Upstream-Resetdatei reset_lgw.sh zielt auf das CoreCell-Referenzdesign. Zu den Standardwerten gehören GPIO23 für Konzentrator-Reset, GPIO18 für Stromfreigabe, GPIO22 für Zusatz-Reset und GPIO13 für den Reset eines AD5338R. Semtech-Reset-Skript

Seeeds ältere Einrichtung ändert die beiden Reset-Zuordnungen auf GPIO17 und GPIO5, lässt aber die übrigen Referenzwerte bestehen. Vergleiche sie mit der M1-Grafik, bevor du das Beispiel verwendest. Seeed-WM1302-Einrichtung

ZuordnungWidersprüchlicher BelegErforderliche Entscheidung
GPIO22 als Zusatz-ResetM1-Grafik bezeichnet ihn als Benutzer-LEDAnnahme vor LED-Aktivierung entfernen
GPIO18 als StromfreigabeM1-Grafik bezeichnet ihn als BUSY-AusgangNetz und Richtung vor Ansteuerung prüfen
GPIO13 als DAC-ResetAllgemeines Skript nennt ein anderes ReferenzdesignPrüfen, ob die Schaltung vorhanden ist
Zusätzliches SPI-GerätM1-Grafik verwendet GPIO6 statt CE1Chip-Select und Treiberunterstützung prüfen

Ableitung: Falls GPIO18 wie abgebildet mit einem Ausgang des Zusatzfunkmoduls verbunden ist, entsteht beim Konfigurieren des Pi-Pins als Ausgang ein Risiko elektrischer Konflikte. Die widersprüchlichen Angaben begründen eine Prüfung, aber keinen Schadensnachweis und kein universelles Pinout für alle Revisionen.

Verfolge zugängliche Verbindungen zwischen Header und Modulstecker bei ausgeschalteter Stromversorgung. Notiere Revision und Endpunkte. Eine Durchgangsmessung belegt eine Verbindung; Bauteilunterlagen erklären Signalrichtung und Grenzwerte.

Nutze das Herstellerdiagramm, um Modulstecker-Pins nicht mit Pi-Header-Pins zu verwechseln. Die Zusatzfunksignale beschreiben die veröffentlichte Modulreferenz, nicht identische Chips oder Funktionen jeder Revision. Seeed-WM1302-Modul-Pinout

Seeed-Diagramm mit beiden Seiten des WM1302-Modulsteckers für Strom, SPI, I2C und Zusatzfunksignale

Die Nummerierung des Modulsteckers unterscheidet sich von der Raspberry-Pi-Headernummerierung · Seeed Studio, WM1302-doc

Raspberry Pi OS vorbereiten

Erfasse die Hostumgebung auf deiner Ersatzinstallation:

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

OS-Version, Kernel und Pi-Modell bilden die reproduzierbare Ausgangsbasis. Notiere sie vor dem Vergleich mit älteren Tutorials.

Installiere Prüf- und Build-Werkzeuge:

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

Aktiviere unter Interface Options SPI und I2C und starte neu. SPI dient dem Konzentratorpfad; I2C unterstützt Verwaltungsgeräte. Übernimm keine unnötigen GPS-Änderungen für serielle Schnittstellen aus anderen HAT-Anleitungen.

Prüfe verfügbare Schnittstellen:

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

Diese Befehle listen Gerätedateien, Adapter, GPIO-Controller, Leitungsinformationen und die Werkzeugversion auf. i2cdetect -l listet Adapter, ohne Geräteadressen abzufragen. Eine Datei wie /dev/spidev0.0 belegt eine Schnittstelle, aber keine Kommunikation mit einem funktionierenden Konzentrator. i2c-tools-Handbuch , Raspberry-Pi-GPIO-Leitfaden

GPIO-Versionen berücksichtigen

Übernimm keine globalen GPIO-Nummern eines anderen Computers. Ältere Skripte schreiben über /sys/class/gpio, eine vom Kernel als veraltet markierte Schnittstelle. Neue Userspace-Integrationen sollten die GPIO-Character-Device-Schnittstelle mit korrektem Controller und Leitungsindex verwenden. Linux-GPIO-Dokumentation

Prüfe gpioset –help vor einer Skriptanpassung. Version 1 und 2 unterscheiden sich in Syntax und Prozessverhalten. Das aktuelle Werkzeug hält Leitungen standardmäßig reserviert; sein portabler Vertrag garantiert den Zustand nach Prozessende nicht. libgpiod-gpioset-Dokumentation

Raspberry Pi dokumentiert Kernelverhalten, bei dem Ausgänge ihren Zustand beibehalten können. Erfasse die echte Kernelkonfiguration, statt identisches Verhalten auf allen Linux-Systemen anzunehmen. Neuere Nummerierung oder ein anderes GPIO-Werkzeug behebt keine falsche elektrische Zuordnung. Raspberry-Pi-GPIO-Leitfaden

Benutzer-LED testen

Nachdem du GPIO22 der LED zugeordnet und widersprüchliche GPIO-Verwender entfernt hast, bearbeite die Boot-Konfiguration:

sudoedit /boot/firmware/config.txt

Aktuelle Raspberry-Pi-OS-Versionen mounten die Boot-Konfiguration unter /boot/firmware/config.txt. Ältere Images nutzen /boot/config.txt, den Pfad im Artikel von 2023. Sichere die aktive Datei. Raspberry-Pi-config.txt-Dokumentation

Füge das LED-Overlay in einem für deinen Pi geltenden Abschnitt wie [all] hinzu:

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

gpio verwendet BCM-Nummerierung. label benennt das Linux-LED-Gerät, und trigger=heartbeat weist den Kernel-Heartbeat-Trigger zu. Clockwork Bird berichtet diese M1-Zuordnung; Raspberry Pi dokumentiert die Parameter. Ursprüngliche LED-Beobachtung , gpio-led-Overlay-Referenz

Prüfe nach dem Neustart die registrierte LED:

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

Erwartet wird ein lorawan-Eintrag mit heartbeat in eckigen Klammern. Eine blinkende LED belegt diesen GPIO-/Treiberpfad. Sie meldet weder LoRaWAN-Registrierung noch Funkempfang oder Helium-Status.

I2C-Geräte untersuchen

Eine I2C-Adresse ist ein Hinweis, keine Geräteidentität. Clockwork Bird beobachtete Antworten an 0x60 und 0x39 und las danach ATECC608-Informationen über die Kryptobibliothek aus. Die Identifizierung des Temperatursensors blieb vorläufig.

Beginne mit der Adapterliste. Breite i2cdetect-Scans senden Prüftransaktionen, statt den Bus passiv zu beobachten. Das Upstream-Handbuch warnt vor Störungen. Scanne laufende Gateways und unbekannte Geräte nicht routinemäßig. i2c-tools-Abfrageverhalten

BeobachtungBelegte SchlussfolgerungOffene Frage
Antwort an 0x60Ein Gerät bestätigte die AbfrageIst es das erwartete Secure Element?
Antwort an 0x39Ein Gerät bestätigte die AbfrageWelche Komponente und Revision antworteten?
UU im ScanEin Treiber besitzt die Adresse; Abfrage übersprungenWelcher Treiber hat sie belegt?
Keine AntwortKeine Bestätigung empfangenStrom, Bus, Belegung oder Geräteprotokoll?

Besserer Hinweis auf den Temperatursensor

STTS751 ist ein belegter Kandidat für 0x39. Semtechs Temperaturtreiber-Header ordnet diese Adresse ausdrücklich STTS751-0DP3F zu. Das stärkt die Hypothese, identifiziert aber nicht jedes Board. Semtech-STTS751-Treiberheader

Nach Identifizierung eines kompatiblen Bauteils und Prüfung der Belegung kannst du Identifikationsregister auslesen:

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

1 wählt den geprüften Bus, 0x39 das Gerät und b einen SMBus-Byte-Datenzugriff. Beim STTS751-0 ist die Produkt-ID an 0xFD 0x00; die Hersteller-ID an 0xFE lautet 0x53. Die Transaktionen lesen Register, schreiben aber keine Konfigurationswerte. STTS751-Datenblatt

Vergleiche die Werte mit Bauteilmarkierung und Dokumentation. Ein passendes Paar stärkt die Identifizierung. Bei Fehlern prüfst du Bus und Belegung, bevor du die Konfiguration änderst. Der Sensor misst lokale Temperatur, nicht die CPU-Temperatur des Pi.

Secure Element untersuchen

Der ATECC608 ist eine separate Authentifizierungskomponente. Konfiguration, Seriennummer, öffentlicher Schlüssel und geschütztes Schlüsselmaterial sind unterschiedliche Dinge. Ein lesbarer öffentlicher Schlüssel gibt den privaten Schlüssel nicht preis.

Microchips CryptoAuthLib stellt die Geräteschnittstelle bereit. Das Repository cryptoauthtools enthält Beispiele. Bereite native Bibliothek und Python-Bindings nach den Projektanleitungen für dein System vor. Eine beliebige Python-Bibliothek oder ein kopiertes Skript belegt kein funktionierendes I2C-Backend. Microchip CryptoAuthLib , Microchip cryptoauthtools

Im vorbereiteten Verzeichnis cryptoauthtools/python/examples lautet der Inspektionsbefehl:

sudo python3 info.py -i i2c

-i i2c wählt die Schnittstelle. Bei einer virtuellen Umgebung verwende ihren Python-Interpreter und stelle sicher, dass er die native Bibliothek findet. sudo python3 wählt oft den Systeminterpreter, was Importfehler erklärt.

Die geprüfte Datei info.py liest Revision, Seriennummer, Konfiguration und Sperrstatus. Bei gesperrtem Datenbereich versucht sie, den öffentlichen Schlüssel aus Slot 0 zu lesen. Sie führt nicht die Provisionierung des Beispiels aus. Ein fehlgeschlagener Slot-0-Schlüsselabruf allein belegt kein defektes Gerät. Microchip-info.py-Quellcode

Ausgabe oder VorgangBedeutung
Konfiguration gesperrtKonfigurationseinschränkungen gelten
Datenbereich gesperrtZugriff anhand der Slot-Richtlinien beurteilen
Öffentlicher Schlüssel angezeigtÖffentliche Information gelesen, kein privater Schlüssel exportiert
config.py ausgeführtProvisionierungsbeispiel mit Änderungen, Sperren und Schlüsselerzeugung

Führe config.py nicht aus, um einen Inspektionsfehler zu beheben. Der Quellcode enthält Konfigurationsschreibvorgänge, Zonensperren und Schlüsselerzeugung. Auch der Standardschlüsselerzeugungspfad ist bei einem bereits konfigurierten Gerät relevant. Microchip-config.py-Quellcode

Microchips Provisionierungsprofile zeigen, dass ein gesperrter Datenbereich nicht bedeutet, alle Slots hätten dieselben Zugriffsrechte. Sie belegen nicht die M1-Konfiguration. Erhalte die bestehende Konfiguration und prüfe die passenden Bauteilunterlagen, bevor du eine Schlüsselweiterverwendung planst. Microchip-Speicher- und Slot-Zugriffsrichtlinien

Unbekanntes zu Lüfter und Taste klären

Ein dreipoliger Lüfteranschluss belegt weder Spannung noch Polarität oder Steuerungsmethode. Fotografiere Pinnummerierung und Lüfterbeschriftung. Kläre Versorgungs- und Steuerleitungen, bevor du Ersatz anschließt oder ein GPIO-Overlay auswählst.

Auch die GPIO-Leitung der Taste ist unbekannt. Suche nach einem Treiber oder einer Konfiguration für deine Board-Revision und prüfe die Verbindung bei ausgeschaltetem Gerät. Weise nicht jeden scheinbar freien GPIO als Ausgang zu, um die Taste zu finden.

PeripheriegerätZu erfassender NachweisAbnahmekriterium
LüfterversorgungLüfterangabe, Masse und Versorgung am AnschlussMesswert entspricht der Spezifikation
LüftersteuerungTreiber, Konfiguration oder nachverfolgte SchaltungDefiniertes Verhalten beim Start und bei Hitze
BenutzertasteVerdrahtung, GPIO-Zuordnung und EingangslogikEin Tastendruck erzeugt das erwartete Ereignis

Ein frisches OS übernimmt nicht automatisch die Kühlungssteuerung des ursprünglichen Geräts. Beobachte Lüfter und Temperaturen während eines längeren Tests. Erhalte den Luftstrom und brich bei unzureichender Kühlung ab.

Gateway-Stack auswählen

Trenne Board-Unterstützung vom Serverprotokoll. Ein kompatibler LoRaWAN-Server behebt weder eine falsche Reset-Routine noch RF-Kalibrierung. Wähle Software, die Konzentrator, Trägerverdrahtung, OS und regionale Konfiguration unterstützt.

SoftwarepfadNützliche RolleVor Bereitstellung prüfen
Semtech SX1302 HALQuelltextbasierte Inbetriebnahme und DiagnosetoolsBoard-Reset-Routine und Modulkonfiguration
LoRa Basics StationAuthentifizierte GatewayverbindungBoard-Integration und Serverzugangsdaten
ChirpStack ConcentratordDedizierter Konzentrator-DienstModell, Kalibrierung und GPIO-Zuordnung

ChirpStack listet das SPI-Modell seeed_wm1302. Dies belegt Modulunterstützung, kein vollständiges M1-Image und keine Unterstützung jeder Revision. Verwechsle SenseCAP-M2-Anleitungen nicht mit M1-Firmwareanleitungen. ChirpStack-Hardwareunterstützung , Seeed-Installationsziel

Für The Things Stack empfiehlt die Dokumentation LoRa Basics Station statt des älteren Semtech-UDP-Forwarders. Station bietet TLS, Token-Authentifizierung und zentrale Konfiguration. UDP-Beispiele erklären Paketweiterleitung, bieten diesen Schutz aber nicht. The-Things-Stack-UDP-Hinweise , LoRa-Basics-Station-Dokumentation

Upstream-Werkzeuge vorbereiten

Baue auf dem Ziel-Pi in einem neuen Arbeitsverzeichnis:

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

Speichere die Commit-ID mit den Build-Ausgaben. Ein erfolgreicher Build belegt Compilerkompatibilität; das Funkmodul braucht weiterhin eine verifizierte Reset-Implementierung und korrekte Konfiguration. SX1302-HAL-Build- und Werkzeugdokumentation

Prüfe das Reset-Skript vor Hardwarewerkzeugen:

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

Kopiere es nicht unverändert in das Laufzeitverzeichnis. Semtech dokumentiert, dass Hardwarewerkzeuge einschließlich Identifikationsprogramme Reset-Skripte automatisch verwenden. Prüfe jeden Pin, Signalrichtung, GPIO-API und Zustand beim Starten und Beenden.

Nach der Board-Verifikation liest du laut Stack-Anleitung die Konzentrator-EUI aus und registrierst das Gateway. Erhalte Modulkalibrierung und RF-Einstellungen. In Semtech UDP ist gateway_ID die EUI; die Gateway-ID in der The-Things-Stack-Konsole ist eine menschenlesbare Kennung. The-Things-Stack-Gatewaykonfiguration

Sensordatenübertragung nachweisen

Nutze gestufte Nachweise, um die erste fehlerhafte Ebene zu finden. Ein online markiertes Gateway belegt eine Serververbindung. Die Abnahme braucht zusätzlich einen bekannten Sensor, passenden Frequenzplan und dekodierte Nutzlast. Dies ist ein Testvorschlag, keine M1-Messung:

PrüfpunktZu speichernder NachweisBedeutung
Host bereitOS, Kernel, Stromversorgung und SchnittstelleninventarLinux-Vorbereitung abgeschlossen
Konzentrator antwortetEUI und erfolgreiche InitialisierungHost-Kommunikation funktioniert
FunkempfangSensorpaket und EmpfangsmetadatenEmpfangspfad funktioniert
Server nimmt anGatewayereignis zum SensorWeiterleitung und Routing funktionieren
Anwendung dekodiertErwarteter Messwert und ZeitstempelAnwendungspfad funktioniert
NeustartwiederherstellungDieselben Prüfungen nach NeustartStartkonfiguration reproduzierbar

Bei einem OTAA-Sensor prüfst du zusätzlich Aktivierungsaustausch und anschließenden Uplink. OTAA bedeutet Over-the-Air Activation, das Verfahren zum Einrichten einer Sitzung. Eine empfangene Join-Anfrage belegt weder erfolgreichen Beitritt noch Downlink. The-Things-Stack-Aktivierungsdokumentation

Beispieldiagnose: Das Gateway verbindet sich mit dem Server und meldet die EUI, aber der Sensor erscheint nicht. Prüfe Sendeeinstellungen, Empfangskanäle, Antennenpfad und Funkprotokolle. Eine Neuprogrammierung des ATECC608 behebt den fehlenden Nachweis nicht.

Zweite Diagnose: Ein Sensorpaket erscheint lokal, erreicht aber nicht die Anwendung. Vergleiche Zeitstempel mit Gateway- und Serverereignissen; prüfe Routing, Registrierung und Dekodierung. Ein Funkpaket im Protokoll reicht nicht, um den Decoder verantwortlich zu machen, bevor der Server das Ereignis annimmt.

Fehlersuche nach Symptom

SymptomZuerst prüfenNächster Schritt
Keine SPI-GerätedateiBoot-Konfiguration und SchnittstelleneinstellungenSchnittstelle aktivieren und neu starten
SPI vorhanden, Funk fällt ausStrom, Sitz, Reset-Sequenz, Chip-SelectElektrischen Pfad vor Serveränderungen prüfen
GPIO-ExportfehlerAlte sysfs-Annahmen und KernelGeprüfte GPIO-API-Implementierung verwenden
GPIO bereits belegtVerbraucher in gpioinfoBelegung vor erneutem Versuch klären
LED fällt nach Einrichtung ausOverlay und GPIO22-KonflikteLED-Geräte und Reset-Skript prüfen
I2C-Gerät fehltBusnummer, Strom, BelegungOhne wiederholte breite Scans untersuchen
Kryptobibliothek importiert nichtInterpreter, Bindings, native BibliothekSoftwareumgebung reparieren
Öffentlicher Schlüssel nicht lesbarSlot-Rechte und erfolgreiche frühere LesevorgängeKonfiguration prüfen, nicht provisionieren
Lüfter läuft nichtVersorgung und KühlungssteuerungKühlung vor Dauerlast wiederherstellen
Uplinks kommen an, Join scheitertDownlinkpfad und FunkplanJoin-Antwort und Empfangsfenster verfolgen

Behandle jede Korrektur als einzelnes Experiment. Sichere die vorherige Konfiguration, ändere eine Variable, wiederhole dieselbe Prüfung und notiere, ob der erwartete Nachweis erschien.

Hardwareprotokoll erstellen

Nutze diese Vorlage für eine reproduzierbare Übergabe:

Trägerrevision und Fotos:
Konzentrator-Modell, Schnittstelle und RF-Band:
Host-Modell / OS / Kernel / GPIO-Werkzeugversion:
Stromversorgung / Antenne / Kühlung:
Verifizierte Pinbelegung und Nachweis:
Ungeklärte Leitungen und ausgeschlossene Funktionen:
Software-Repository und Commit:
Reset-Implementierung und GPIO-Belegung:
Gateway-EUI / Server / Frequenzplan:
Sensoraktivierung und dekodierter Uplink-Nachweis:
Ergebnis nach Neustart:
Aufbewahrungsort der Originalkarte und Rollback-Verfahren:

Entscheidungsübung: Du hast eine günstige Trägerplatine ohne Modulbeschriftung und eine teurere Baugruppe mit lesbaren Kennzeichnungen und dokumentiertem Betrieb. Vergleiche Kosten für fehlenden Pi, Konzentrator, Antenne, Netzteil und Prüfzeit. Entscheidend sind Gesamtkosten und Nachweise für deinen Dienst, nicht nur der beworbene Trägerpreis.

Erwartete Begründung: Ein Lernprojekt toleriert ungeklärte Verdrahtung, wenn Messgeräte und Zeit verfügbar sind. Ein Gateway für produktive Sensoren braucht reproduzierbaren Start, Kühlung, Softwareunterstützung und nachgewiesene Übertragung. Notiere, welcher ungeklärte Zustand die Bereitstellung verhindert.

Nächste Schritte

Vervollständige zuerst das Hardwareprotokoll und kläre Reset-Skript-Konflikte. Nimm danach einen bekannten Sensor in Betrieb und sichere Nachweise bis zur Dekodierung in der Anwendung, bevor du weitere Geräte hinzufügst.

Abnahmeprotokoll: Speichere Board-Revision, Modulbeschriftung, Funkband, gemessene Versorgung, aktives SPI-Gerät, GPIO-Leitungsnamen, Reset-Sequenz, Konzentratorprotokoll, Serververbindung und einen dekodierten Uplink. Kennzeichne jeden Wert als beobachtet, dokumentiert oder angenommen. Ein gestarteter Prozess beweist weder RF-Leistung noch Anwendungsauslieferung.

Wenn du Mesh-Nachrichten senden willst, vergleiche die Protokollrollen in unserem Leitfaden zu Meshtastic, MeshCore und Reticulum . Gemeinsame LoRa-Funktechnik belegt keine Firmwarekompatibilität. Für Messaging nutze die Dokumentation unterstützter MeshtasticD-Hardware , nicht dieses LoRaWAN-Verfahren.

Quellen und Bildnachweise

Recherche geprüft am 12. September 2026. Undatierte Dokumentation und Repository-Links beziehen sich auf geprüfte Versionen. Lokale Abbildungen behalten ihre ursprünglichen Beschriftungen und Herkunftsnachweise.

HerausgeberQuelle und Datum
Clockwork BirdSenseCAP M1 Raspberry Pi Shield , 03.05.2023. Board-Foto, Headerzeichnung und Hersteller-Blockdiagramm
Seeed Studio / SenseCAPM1-Übersicht und Spezifikationen , undatiert. Ursprung des Blockdiagramms
Seeed StudioWM1302-Dokumentation und Modul-Pinout , Repository
SemtechSX1302/SX1303 HAL , einschließlich Reset-Skript und Temperaturtreiber
Raspberry PiBoot-Konfiguration , GPIO-Leitfaden und Overlay-Referenz
Linux / libgpiodVeraltete GPIO-sysfs-Schnittstelle und gpioset-Handbuch , August 2026
i2c-toolsi2cdetect-Handbuch , Quellcode v4.3
STMicroelectronicsSTTS751-Datenblatt , Revision 7
MicrochipCryptoAuthLib , cryptoauthtools und Slot-Zugriffsrichtlinien
ChirpStackConcentratord-Hardwareunterstützung und Seeed-Installationsziel
The Things IndustriesUDP-Forwarder , LoRa Basics Station und Geräteaktivierung
MeshtasticMeshtasticD-Dokumentation , undatiert