Table of Contents

La shield SenseCAP M1 és útil com a maquinari de passarel·la LoRaWAN, però el seu cablejat exigeix més comprovacions que un tutorial genèric de Raspberry Pi HAT. Aquesta guia amplia la investigació de Clockwork Bird de 2023 amb documentació del fabricant, una revisió d’un controlador upstream i recomanacions GPIO actuals. Identificaràs el maquinari, separaràs els fets confirmats de les dades incompletes del pinout i crearàs un registre de posada en servei reproduïble.

Abast: Aquesta és una guia de maquinari basada en documentació. Les ordres i els mapes de la placa no s’han provat en un M1 físic per a aquest article.

Punts principals

  • Identifica les dues plaques: el suport M1 i el concentrador extraïble tenen models i revisions propis.
  • Revisa els scripts de reinici: els valors per defecte de CoreCell entren en conflicte amb senyals del pinout M1 publicat.
  • Comprova les interfícies del sistema: els fitxers de dispositiu SPI, la numeració GPIO i les versions de les eines GPIO responen preguntes diferents.
  • Preserva el provisionament de l’element segur: llegir informació del dispositiu no és el mateix que configurar-lo o generar claus.
  • Valida el recorregut complet: detectar un concentrador no demostra que s’entreguin les dades del sensor.

Abans de començar

Dificultat: intermèdia. Reserva aproximadament d’una a dues hores per inventariar, preparar el sistema i revisar la documentació. La verificació elèctrica, l’adaptació del controlador i el desplegament del servidor de xarxa requereixen més feina, especialment si desconeixes la revisió de la placa.

ElementFinalitat
Shield M1 i concentradorLlegeix la revisió del suport i l’etiqueta completa del mòdul
Raspberry Pi 4Comença amb l’amfitrió utilitzat en el disseny M1 original
Targeta microSD de recanviPrepara un altre sistema sense perdre la instal·lació original
Font d’alimentació i antena adequadesAjusta-les al conjunt i a la banda RF del mòdul
SSH o consola localRegistra els diagnòstics i edita la configuració
Sensor i servidor LoRaWANVerifica el lliurament real a l’aplicació després d’iniciar el maquinari
Multímetre i experiència amb maquinariResol les connexions no documentades abans d’accionar-les

Fotografia les dues cares del conjunt desconnectat abans de treure cap peça. Anota l’orientació dels connectors, els cargols, els separadors i el recorregut de l’antena. Mantén disponibles la targeta i la configuració originals fins que la instal·lació nova superi les proves d’acceptació.

Identifica les tres capes

El M1 complet, el suport shield i el concentrador són components diferents. Seeed descriu el hotspot muntat com un Raspberry Pi 4 amb un concentrador WM1302/SX1302 o WM1303/SX1303. Un anunci titulat «SenseCAP M1 shield» no indica quin d’aquests components acompanya el suport. Visió general del M1 de Seeed Studio

El suport connecta l’alimentació i els senyals perifèrics entre el Pi i el mòdul. El concentrador gestiona la recepció i la transmissió de ràdio. Un reenviador de paquets a l’amfitrió intercanvia amb un servidor els paquets de ràdio rebuts i els enllaços descendents programats. Visió general del SX1302 HAL de Semtech

Per exemple, un sensor de temperatura de prestatgeria envia un enllaç ascendent per ràdio. El concentrador el rep, l’amfitrió el reenvia i els serveis de xarxa i aplicació el processen. Que Linux s’iniciï només demostra la part de l’amfitrió d’aquesta cadena.

La fotografia de Clockwork Bird mostra un suport M1 v1.1 amb un mòdul etiquetat explícitament WM1302-SPI-EU868. Fes-la servir per localitzar les etiquetes del teu maquinari. Els números de sèrie identifiquen l’equip fotografiat, no la configuració d’una altra passarel·la.

Suport M1 verd amb un mòdul WM1302 SPI EU868 etiquetat, al costat d'USB-C, un botó, el connector del ventilador i el cable de l'antena

Maquinari M1 v1.1 fotografiat per Clockwork Bird, també utilitzat a la portada d’aquest article · Clockwork Bird, 2023-05-03

Connexions d’alimentació i ràdio

Tracta el connector USB-C del M1 com una entrada d’alimentació. El fabricant especifica 5 V CC, 3 A per a tota la passarel·la i identifica USB-C com la interfície d’alimentació. Anomenar-lo port de càrrega suggereix una bateria absent d’aquestes especificacions. Especificacions del SenseCAP M1

El diagrama de blocs del fabricant separa la font de 5 V del rail regulat de 3,3 V del mòdul. Aquesta diferència és important en el diagnòstic: el Pi pot funcionar mentre el concentrador no rep alimentació. No injectis 5 V en un pin de senyal ni pressuposis que les dues entrades d’alimentació estan aïllades entre si.

Les variants SPI i USB del mòdul requereixen connexions diferents amb l’amfitrió. La documentació WM1302 de Seeed descriu accés SPI directe per al model SPI i un pont USB STM32L4 per al model USB. La forma mini-PCIe descriu el format del mòdul, mentre que les interfícies elèctriques documentades són SPI o USB. Encaixar en una presa de portàtil no demostra compatibilitat. Documentació WM1302 de Seeed

Abans d’alimentar el conjunt, instal·la el mòdul amb l’alimentació desconnectada i connecta una antena adequada. Ajusta el maquinari RF, l’antena i el pla regional previst. Canviar el nom d’un fitxer de configuració no modifica els components RF, i la presa d’alimentació M1 no demostra compatibilitat amb una variant USB del concentrador.

Diagrama de blocs que connecta el Raspberry Pi 4 amb la shield M1 mitjançant alimentació, SPI, GPIO i I2C

Diagrama del fabricant SenseCAP reproduït a l’article original de Clockwork Bird, que mostra el disseny WM1302 · Seeed Studio / SenseCAP, via Clockwork Bird

Llegeix atentament el pinout

Anota per separat els números GPIO BCM i els pins físics del connector. Per exemple, BCM GPIO17 correspon al pin físic 11 del connector Pi. El connector de vora del mòdul afegeix un tercer sistema de numeració, de manera que el seu número de pin de reinici no és un número GPIO de Raspberry Pi.

La taula següent transcriu les connexions de la imatge anotada de Clockwork Bird. És una referència comunitària, no un esquema complet del fabricant ni una mesura de totes les revisions M1. El dibuix també utilitza etiquetes SX1262, mentre que el script genèric de reinici Semtech fa servir noms SX1261.

Senyal del dibuixBCM / pin físicInterpretació
I2C SDA / SCLGPIO2 / 3, GPIO3 / 5Bus de gestió compartit
Reinici SX1302GPIO17 / 11Candidat a reinici del concentrador
LED d’usuariGPIO22 / 15Anotació M1
SPI MOSI / MISOGPIO10 / 19, GPIO9 / 21Senyals de dades SPI
Rellotge SPIGPIO11 / 23Senyal de rellotge SPI
Selecció SX1302GPIO8 / 24SPI0 CE0
Reinici SX1262GPIO5 / 29Candidat a reinici de la ràdio auxiliar
Selecció SX1262GPIO6 / 31GPIO6, diferent de SPI0 CE1
SX1262 BUSYGPIO18 / 12Sortida d’estat de la ràdio auxiliar
SX1262 IO1 / IO2GPIO23 / 16, GPIO24 / 18Senyals auxiliars que cal verificar abans d’utilitzar

Les anotacions GPS/UART ratllades no demostren que el M1 tingui GPS. No afegeixis configuració GPS si el teu maquinari no en té. El diagrama publicat tampoc no resol el botó d’usuari ni el control del ventilador. Investigació del pinout de Clockwork Bird

Dibuix anotat del connector Raspberry Pi amb el LED M1, el reinici del concentrador, els senyals SPI i les connexions GPS ratllades

Referència anotada per la comunitat amb cobertura incompleta de revisions, no és un esquema M1 complet · Clockwork Bird, 2023-05-03

Resol els conflictes dels scripts de reinici

Un script de reinici selecciona sortides elèctriques, no només preferències de programari. El reset_lgw.sh upstream de Semtech s’adreça al disseny de referència CoreCell. Els valors per defecte inclouen GPIO23 per al reinici del concentrador, GPIO18 per habilitar l’alimentació, GPIO22 per al reinici auxiliar i GPIO13 per al reinici de l’AD5338R. Codi font del script de reinici Semtech

Les instruccions antigues de configuració de Seeed canvien les dues assignacions de reinici a GPIO17 i GPIO5, però conserven les altres entrades del disseny de referència. Compara els valors amb la imatge M1 anotada abans de seguir l’exemple. Instruccions de configuració WM1302 de Seeed

AssignacióEvidència contradictòriaDecisió necessària
GPIO22 com a reinici auxiliarLa imatge M1 l’identifica com a LED d’usuariElimina aquesta suposició abans d’activar el LED
GPIO18 com a activació d’alimentacióLa imatge M1 l’identifica com a BUSY auxiliarVerifica la xarxa i la direcció abans d’accionar-lo
GPIO13 com a reinici del DACL’script genèric anomena un altre disseny de referènciaDetermina si el circuit existeix
Dispositiu SPI auxiliarLa imatge M1 selecciona GPIO6 en lloc de CE1Confirma l’encaminament de selecció i el suport del controlador

Inferència: si GPIO18 està connectat a una sortida de ràdio auxiliar tal com es dibuixa, configurar el costat Pi com a sortida crea risc de contenció elèctrica. La discrepància exigeix verificació, però no demostra que hi hagi danys ni que tots els M1 tinguin el mateix cablejat.

Desconnecta totes les fonts d’alimentació i traça les connexions accessibles entre el connector i el mòdul. Anota la revisió de la placa i els dos extrems. La continuïtat demostra connexió, mentre que la documentació del component n’estableix la direcció del senyal i els límits elèctrics.

Fes servir el diagrama del mòdul de sota per no confondre els pins del connector de vora amb els del Pi. Les etiquetes de ràdio auxiliar descriuen la referència publicada del mòdul, no demostren el mateix silici ni les mateixes funcions en totes les revisions. Pinout del mòdul WM1302 de Seeed

Diagrama de Seeed amb les dues cares del connector de vora WM1302 i els senyals d'alimentació, SPI, I2C i ràdio auxiliar

La numeració del connector de vora del mòdul és diferent de la numeració del connector Raspberry Pi · Seeed Studio, WM1302-doc

Prepara Raspberry Pi OS

Registra l’entorn de l’amfitrió a la instal·lació de recanvi:

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

La versió del sistema, el kernel i el model Pi constitueixen el punt de partida reproduïble. Anota’ls abans de comparar resultats amb un tutorial antic.

Instal·la eines d’inspecció i compilació:

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

A Interface Options, activa SPI i I2C i reinicia. SPI serveix per al recorregut del concentrador, mentre que I2C serveix per als dispositius de gestió descrits més endavant. No importis canvis de port sèrie GPS sense relació d’un tutorial d’un altre HAT.

Inspecciona les interfícies exposades:

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

Aquestes ordres mostren nodes de dispositiu, adaptadors, controladors GPIO, línies i la versió de l’eina GPIO instal·lada. i2cdetect -l enumera adaptadors sense escanejar adreces. El fitxer /dev/spidev0.0 demostra que hi ha una interfície SPI exposada, no que es comuniqui amb un concentrador funcional. Manual i2c-tools , Recomanacions GPIO de Raspberry Pi

Tingues en compte les versions GPIO

No copiïs números GPIO globals d’una altra màquina. Els scripts antics escriuen a través de /sys/class/gpio, una interfície que la documentació del kernel considera obsoleta. Les integracions noves a l’espai d’usuari han d’utilitzar la interfície GPIO character device amb el controlador i el desplaçament de línia correctes. Documentació Linux GPIO

Consulta també gpioset --help abans d’adaptar un script. La sintaxi i el comportament dels processos són diferents entre les versions 1 i 2. L’eina actual manté per defecte les línies sol·licitades, però el contracte portable no garanteix l’estat després que el procés acabi. Documentació gpioset de libgpiod

Raspberry Pi documenta un comportament de persistència de sortides al seu kernel i opcions per canviar-lo. Registra la configuració real del kernel en lloc de suposar que tots els Linux es comporten igual. Una numeració nova o una eina GPIO més recent no corregeix un mapa elèctric incorrecte. Guia d’ús GPIO de Raspberry Pi

Prova el LED d’usuari

Després de comprovar que GPIO22 pertany al LED i d’eliminar els usos GPIO en conflicte, edita la configuració d’arrencada:

sudoedit /boot/firmware/config.txt

Les versions modernes de Raspberry Pi OS munten la configuració d’arrencada a /boot/firmware/config.txt. Les imatges antigues fan servir /boot/config.txt, el camí de l’article de 2023. Fes una còpia de seguretat del fitxer actiu abans d’editar-lo. Documentació config.txt de Raspberry Pi

Afegeix l’overlay LED en una secció aplicable al teu Pi, com ara [all]:

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

El paràmetre gpio utilitza numeració BCM. label assigna un nom al dispositiu LED Linux, i trigger=heartbeat tria el trigger heartbeat del kernel. Clockwork Bird indica aquesta assignació per al M1, i la referència d’overlays de Raspberry Pi documenta aquests paràmetres. Observació original del LED , Referència de l’overlay gpio-led

Després de reiniciar, inspecciona el LED registrat:

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

El resultat esperat és una entrada LED lorawan amb heartbeat seleccionat entre claudàtors. El parpelleig demostra que funciona el recorregut GPIO/controlador. No indica registre LoRaWAN, recepció de ràdio ni estat Helium.

Investiga els dispositius I2C

Una adreça I2C és una pista, no la identitat d’un dispositiu. Clockwork Bird va observar respostes a 0x60 i 0x39, i després va llegir informació ATECC608 amb la biblioteca criptogràfica. La identificació del sensor de temperatura continuava sent provisional a l’article original.

Comença amb la llista d’adaptadors de la secció anterior. Les exploracions àmplies de i2cdetect envien transaccions de prova, no observen passivament el trànsit; el manual upstream adverteix que poden provocar interrupcions. Evita escanejar de rutina una passarel·la en funcionament o dispositius connectats desconeguts. Comportament de prova d’i2c-tools

ObservacióConclusió fonamentadaPregunta no resolta
Resposta a 0x60Alguna cosa ha reconegut la provaÉs l’element segur esperat?
Resposta a 0x39Alguna cosa ha reconegut la provaQuin component i revisió han respost?
UU a l’escaneigUn controlador ocupa l’adreça i s’ha omès la provaQuin controlador la té?
Sense respostaLa prova no ha rebut confirmacióAlimentació, bus, propietari o protocol?

Aprofundeix en la pista del sensor de temperatura

STTS751 és un candidat per a 0x39 amb suport documental. La capçalera del controlador de temperatura de Semtech associa explícitament 0x39 amb STTS751-0DP3F. Això reforça la hipòtesi original, però no identifica tots els components instal·lats a aquesta adreça. Capçalera del controlador STTS751 de Semtech

Després d’identificar un component compatible i comprovar que cap altre procés l’ocupa, llegeix els registres d’identificació:

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

Aquí, 1 selecciona el bus verificat, 0x39 el dispositiu i b demana una lectura SMBus byte-data. Per a l’STTS751-0, l’ID de producte documentat a 0xFD és 0x00, i l’ID del fabricant a 0xFE és 0x53. Aquestes transaccions seleccionen adreces de registre, però no escriuen valors de configuració. Full tècnic STTS751, mapa i registres d’identificació

Compara les lectures amb el marcatge del xip i la documentació. Una parella coincident reforça la identificació; si hi ha un error, comprova el bus i el propietari abans de canviar la configuració. El sensor mesura la temperatura local, diferent de la del processador Pi.

Inspecciona l’element segur

L’ATECC608 és un component d’autenticació independent. Tracta la configuració, el número de sèrie, la clau pública i el material de clau protegit com a conceptes separats. Llegir una clau pública no revela la clau privada corresponent.

La CryptoAuthLib de Microchip proporciona la interfície del dispositiu. El repositori cryptoauthtools conté exemples basats en la biblioteca. Prepara la biblioteca nativa i les bindings Python per al sistema objectiu seguint les instruccions dels projectes abans d’executar un exemple. Instal·lar un paquet Python sense relació o copiar un únic script no demostra que el backend I2C funcioni. CryptoAuthLib de Microchip , cryptoauthtools de Microchip

Des d’un directori cryptoauthtools/python/examples preparat, executa l’ordre d’inspecció de l’article original:

sudo python3 info.py -i i2c

L’argument -i i2c selecciona la interfície. En un entorn virtual, utilitza explícitament el seu intèrpret Python i comprova que localitzi la biblioteca nativa corresponent. En moltes instal·lacions, sudo python3 selecciona l’intèrpret del sistema, cosa que explica alguns errors d’importació de mòduls.

El info.py revisat llegeix dades de revisió, el número de sèrie, la configuració i l’estat dels bloquejos. Si la zona de dades està bloquejada, intenta recuperar la clau pública de l’slot 0. No executa la seqüència de provisionament de l’exemple. Un error aïllat en la lectura d’aquesta clau no demostra que el dispositiu estigui espatllat. Codi font info.py de Microchip

Sortida o operacióSignificat
Configuració bloquejadaHi ha restriccions de configuració actives
Zona de dades bloquejadaInterpreta l’accés segons les polítiques configurades dels slots
Clau pública mostradaS’han recuperat dades públiques, no s’ha exportat una clau privada
Execució de config.pyExemple de provisionament amb escriptura de configuració, bloqueig i generació de claus

No executis config.py per corregir un error d’inspecció. El codi inclou escriptures de configuració, ordres per bloquejar zones i generació de claus. La ruta de generació predeterminada també és important en dispositius ja configurats. Codi font config.py de Microchip

Els perfils de provisionament documentats per Microchip mostren per què bloquejar la zona de dades no implica que tots els slots tinguin els mateixos permisos. Aquests perfils no estableixen la configuració exacta del M1. Conserva la configuració existent i consulta la documentació del component corresponent abans de planificar la reutilització de claus. Polítiques Microchip de memòria i accés als slots

Investiga les incògnites del ventilador i el botó

Una presa de ventilador de tres pins no n’estableix la tensió, la polaritat ni el mètode de control. Fotografia la numeració i llegeix l’etiqueta del ventilador. Confirma les connexions d’alimentació i control abans de connectar-ne un de recanvi o triar un overlay GPIO.

La investigació original tampoc identifica el GPIO del botó. Busca un controlador o una configuració associats a la revisió de la placa i verifica la connectivitat sense alimentació. No configuris totes les GPIO aparentment lliures com a sortides per trobar el botó.

PerifèricEvidència que cal recollirCriteri d’acceptació
Alimentació del ventiladorPotència nominal, terra i alimentació del connectorLa font mesurada coincideix amb les especificacions del ventilador
Control del ventiladorControlador/configuració o circuit de control traçatComportament definit a l’inici i amb temperatura elevada
Botó d’usuariCablejat dels contactes, mapa GPIO, polaritat d’entradaUna sola pulsació intencionada genera l’esdeveniment esperat

Una instal·lació nova del sistema no reprodueix automàticament la política de refrigeració del dispositiu original. A la primera prova prolongada, observa alhora el ventilador i les temperatures. Mantén el flux d’aire de la carcassa i atura la prova si el conjunt perd la refrigeració necessària.

Tria una pila de passarel·la

Separa el suport de la placa del protocol del servidor. Un servidor LoRaWAN compatible no corregeix una rutina de reinici incorrecta ni un calibratge RF inadequat. Tria primer programari compatible amb el concentrador, el cablejat del suport, el sistema i la configuració regional.

Opció de programariFunció útilComprovació abans del desplegament
Semtech SX1302 HALArrencada a nivell de codi font i eines de diagnòsticRutina de reinici de placa i configuració del mòdul
LoRa Basics StationConnexió autenticada entre passarel·la i servidorIntegració funcional de la placa i credencials del servidor
ChirpStack ConcentratordServei dedicat al concentradorModel compatible, calibratge i mapa GPIO

ChirpStack llista el model SPI seeed_wm1302. Això demostra compatibilitat amb el mòdul, no l’existència d’una imatge M1 completa ni el suport de totes les revisions M1. No tractis les instruccions d’instal·lació de SenseCAP M2 com a instruccions de firmware M1. Compatibilitat de maquinari ChirpStack , Objectiu d’instal·lació Seeed ChirpStack

Per a The Things Stack, la documentació recomana LoRa Basics Station en lloc del reenviador UDP Semtech antic. Station ofereix TLS i autenticació amb token, a més de funcions de configuració centralitzada. Els exemples UDP ajuden a entendre el reenviament de paquets, però la configuració de l’adreça del servidor no aporta aquestes proteccions. Recomanacions UDP de The Things Stack , Documentació LoRa Basics Station

Prepara les eines upstream

Compila al Pi objectiu en un directori de treball nou:

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

Desa l’identificador del commit amb la sortida de compilació. Una compilació correcta demostra compatibilitat amb el compilador, però la ràdio també necessita una implementació de reinici verificada i una configuració correcta. La documentació Semtech explica la funció del HAL i les eines auxiliars. Documentació de compilació i eines SX1302 HAL

Revisa el fitxer de reinici abans d’executar eines d’accés al maquinari:

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

No copiïs aquest fitxer sense canvis al directori d’execució. Semtech documenta l’ús automàtic del script de reinici pels seus programes d’accés al maquinari, incloses les eines d’identificació. La revisió ha d’incloure cada pin assignat, direcció del senyal, API GPIO i estat d’inici i aturada.

Després de verificar la placa, segueix les instruccions de la pila triada per llegir l’EUI del concentrador i registrar la passarel·la. Conserva el calibratge del mòdul i la configuració RF en afegir els paràmetres del servidor. A la configuració UDP Semtech, gateway_ID representa l’EUI; el Gateway ID de la consola The Things Stack és l’identificador llegible emprat en el registre. Configuració de passarel·la The Things Stack

Demostra el lliurament del sensor

Fes servir proves per etapes per trobar la primera capa que falla. Que una passarel·la aparegui en línia demostra una connexió amb el servidor. La prova d’acceptació també necessita un sensor conegut, un pla de freqüència coincident i una càrrega útil d’aplicació descodificada.

La seqüència següent és un pla de prova proposat, no resultats mesurats en un M1:

Punt de controlEvidència que cal desarSignificat
Amfitrió preparatSistema, kernel, alimentació i inventari d’interfíciesPreparació Linux completada
El concentrador responEUI i registre d’inicialització correctaLa comunicació amfitrió-concentrador funciona
Recepció de ràdioPaquet de sensor esperat i metadades de recepcióFunciona el recorregut de recepció configurat
El servidor acceptaEsdeveniment de passarel·la associat al sensorFuncionen el reenviament i l’encaminament del servidor
Descodificació de l’aplicacióMesura i marca de temps esperadesFunciona el recorregut de l’aplicació
Recuperació després de reiniciarLes mateixes comprovacions després de reiniciarLa configuració d’inici és reproduïble

Per a un sensor OTAA, confirma també l’intercanvi d’activació i l’enllaç ascendent posterior. OTAA vol dir activació over-the-air, el procediment d’unió que estableix una sessió. Rebre una petició d’unió no demostra que la unió o el recorregut descendent hagin funcionat. Documentació d’activació The Things Stack

Diagnòstic pràctic: la passarel·la es connecta al servidor i comunica l’EUI, però el sensor no apareix. Prioritza la configuració de transmissió del sensor, els canals de recepció seleccionats, el recorregut de l’antena i els registres de ràdio. Reprogramar l’ATECC608 no resoldria la falta d’evidència en aquest cas.

Segon diagnòstic: el paquet del sensor apareix localment, però no arriba a l’aplicació. Correlaciona l’hora del paquet amb els esdeveniments de la passarel·la i del servidor; després revisa l’encaminament, el registre del dispositiu i la descodificació. Un paquet RF al registre no és prou evidència per culpar el descodificador abans que el servidor accepti l’esdeveniment.

Resol problemes segons el símptoma

SímptomaComprova primerAcció següent
No hi ha fitxer de dispositiu SPIConfiguració d’arrencada activa i opcions d’interfícieActiva la interfície prevista i reinicia
Hi ha SPI, però falla la ràdioAlimentació, encaix, seqüència de reinici i selecció de xipVerifica el recorregut elèctric abans de canviar el servidor
Error d’exportació GPIOSupòsits sysfs antics i kernel instal·latUtilitza una implementació revisada per a l’API GPIO
GPIO ja en úsConsumidor que mostra gpioinfoResol la propietat abans de tornar-ho a provar
El LED falla després de configurar-loAplicació de l’overlay i conflictes GPIO22Inspecciona els dispositius LED registrats i el script de reinici
Falta un dispositiu I2CNúmero de bus, alimentació i propietari actualInvestiga sense repetir exploracions àmplies
Error en importar la biblioteca criptogràficaIntèrpret, bindings i ruta de la biblioteca nativaCorregeix l’entorn de programari
Falla la lectura de la clau públicaPolítica del slot i lectures anteriors correctesRevisa la configuració sense fer provisionament
El ventilador no giraAlimentació verificada i control de refrigeracióRestableix la refrigeració abans de proves llargues
Arriben uplinks, falla la unióRecorregut descendent i ajustos regionals/del dispositiuTraça la resposta d’unió i les finestres de recepció

Tracta cada correcció com un experiment únic. Desa la configuració anterior, canvia una variable, repeteix la mateixa comprovació i registra si apareix l’evidència esperada.

Crea el registre del maquinari

Fes servir aquesta plantilla per convertir la investigació en un traspàs reproduïble:

Revisió del suport i fotografies:
Model del concentrador, interfície i banda RF:
Model de l'amfitrió / sistema / kernel / versió de l'eina GPIO:
Font / antena / disposició de refrigeració:
Mapa de pins verificat i evidències:
Xarxes no resoltes i funcions excloses:
Repositori del programari i commit:
Implementació de reinici i propietari GPIO:
EUI de la passarel·la / servidor / pla de freqüències:
Activació del sensor i evidència d'uplink descodificat:
Resultat de recuperació després de reiniciar:
Ubicació de la targeta original i procediment de rollback:

Exercici de decisió: tens un suport nu econòmic sense etiqueta de mòdul i un conjunt més car amb etiquetes llegibles i funcionament documentat. Decideix què s’ajusta al projecte després d’afegir al comparatiu el Pi, el concentrador, l’antena, la font i el temps de verificació. La millor opció depèn del cost total i de les proves que exigeix el servei previst, no només del preu del suport.

Raonament esperat: un projecte d’aprenentatge tolera cablejat no resolt si tens instruments de mesura i temps. Una passarel·la per a sensors operatius necessita inici reproduïble, refrigeració, suport de programari i lliurament demostrat. Anota quina condició no resolta aturaria el desplegament.

Passos següents

Comença completant el registre del maquinari i resolent les discrepàncies del script de reinici. Després, posa en marxa un sensor conegut i desa proves fins a la descodificació de l’aplicació abans d’afegir més dispositius.

Registre d’acceptació: desa la revisió de la placa, l’etiqueta del mòdul, la banda de ràdio, la mesura de la font, el dispositiu SPI actiu, els noms de les línies GPIO, la seqüència de reinici, el registre del concentrador, la connexió al servidor i un uplink descodificat. Marca cada valor com a observat, documentat o encara suposat. No tractis l’inici d’un procés com a prova del rendiment RF o del lliurament a l’aplicació.

Si el teu objectiu és la missatgeria mesh, compara primer els rols dels protocols a la nostra guia Meshtastic, MeshCore i Reticulum . Compartir tecnologia de ràdio LoRa no demostra compatibilitat del firmware. Per desplegar missatgeria, consulta la documentació del maquinari compatible amb MeshtasticD en lloc de tractar aquest procediment LoRaWAN com una conversió a Meshtastic.

Fonts i crèdits de les imatges

Recerca verificada el 12 de setembre de 2026. Els enllaços sense data a documentació i repositoris fan referència a les versions revisades per a aquest article. Les figures locals conserven les etiquetes i l’atribució originals.

EditorFont i data
Clockwork BirdSenseCAP M1 Raspberry Pi Shield , 2023-05-03. Fotografia de la placa, connector anotat i diagrama de blocs del fabricant reproduït
Seeed Studio / SenseCAPVisió general i especificacions M1 , sense data. Atribució del diagrama original
Seeed StudioDocumentació WM1302 i pinout del mòdul , repositori
SemtechSX1302/SX1303 HAL , incloses les fonts enllaçades del script de reinici i del controlador de temperatura
Raspberry PiConfiguració d’arrencada , guia d’ús GPIO i referència d’overlays
Linux / libgpiodInterfície GPIO sysfs obsoleta i manual gpioset , aquest darrer d’agost de 2026
i2c-toolsManual i2cdetect , font v4.3
STMicroelectronicsFull tècnic STTS751 , revisió 7
MicrochipCryptoAuthLib , cryptoauthtools i documentació de polítiques d’accés als slots
ChirpStackSuport de maquinari Concentratord i objectiu d’instal·lació Seeed
The Things IndustriesReenviador UDP , LoRa Basics Station i activació de dispositius
MeshtasticDocumentació MeshtasticD , sense data