Table of Contents

O shield SenseCAP M1 é útil como hardware de gateway LoRaWAN, mas sua fiação exige mais análise do que um tutorial genérico de HAT Raspberry Pi oferece. Este guia amplia a investigação de Clockwork Bird de 2023 com documentação do fabricante, análise de um driver upstream e orientações atuais de GPIO. Você identificará o hardware, separará fatos confirmados de evidências incompletas de pinagem e criará um registro de inicialização reproduzível.

Escopo: Este é um guia de hardware baseado em documentação. Os comandos e mapas da placa não foram testados em um M1 físico para este artigo.

Principais pontos

  • Identifique as duas placas: O carrier M1 e o concentrador removível têm modelos e revisões próprios.
  • Audite os scripts de reset: Os padrões CoreCell entram em conflito com sinais do pinout M1 publicado.
  • Confira as interfaces do sistema: Arquivos de dispositivo SPI, numeração GPIO e versões de ferramentas GPIO respondem a perguntas diferentes.
  • Preserve o provisionamento do elemento seguro: Ler informações do dispositivo não equivale a configurá-lo ou gerar chaves.
  • Comprove o caminho completo: Detectar um concentrador não comprova a entrega dos dados do sensor.

Antes de começar

Dificuldade: intermediária. Reserve cerca de uma a duas horas para inventário, preparação do sistema e verificações documentais. A verificação elétrica, a adaptação do driver e a implantação do servidor de rede exigem trabalho separado, principalmente se a revisão da placa for desconhecida.

ItemObjetivo
Shield M1 e concentradorLer a revisão do carrier e o rótulo completo do módulo
Raspberry Pi 4Começar com o host usado no projeto M1 original
Cartão microSD reservaPreparar outro sistema sem perder a instalação original
Fonte e antena adequadasCompatibilizar o conjunto e a banda RF do módulo
SSH ou console localRegistrar diagnósticos e editar a configuração
Sensor e servidor LoRaWANVerificar a entrega real ao aplicativo após iniciar o hardware
Multímetro e experiência com hardwareResolver conexões não documentadas antes de acioná-las

Fotografe os dois lados do conjunto desligado antes de remover qualquer peça. Registre orientação dos conectores, parafusos, espaçadores e trajeto da antena. Mantenha o cartão e a configuração originais disponíveis até que a nova instalação passe pelos testes de aceitação.

Identifique as três camadas

O M1 completo, o carrier shield e o concentrador são componentes distintos. A documentação da Seeed descreve o hotspot montado com um Raspberry Pi 4 e um concentrador WM1302/SX1302 ou WM1303/SX1303. Um anúncio chamado “SenseCAP M1 shield” não informa qual desses componentes acompanha o carrier. Visão geral do M1 pela Seeed Studio

O carrier conecta alimentação e sinais periféricos entre o Pi e o módulo. O concentrador cuida da recepção e transmissão de rádio. Um encaminhador de pacotes executado no host troca os pacotes de rádio recebidos e os downlinks agendados com um servidor. Visão geral do SX1302 HAL pela Semtech

Por exemplo, um sensor de temperatura de prateleira envia um uplink por rádio. O concentrador o recebe, o host o encaminha e os serviços de rede e aplicação o processam. Uma inicialização correta do Linux comprova apenas a parte do host nessa cadeia.

A foto de Clockwork Bird mostra um carrier M1 v1.1 com um módulo identificado como WM1302-SPI-EU868. Use a foto para localizar os rótulos no seu hardware. Os números de série identificam o equipamento fotografado, não os valores de configuração de outro gateway.

Carrier M1 verde com módulo WM1302 SPI EU868 identificado, perto de USB-C, botão, conector de ventilador e cabo de antena

Hardware M1 v1.1 fotografado por Clockwork Bird, também usado na capa deste artigo · Clockwork Bird, 2023-05-03

Conexões de alimentação e rádio

Trate o conector USB-C do M1 como entrada de alimentação. O fabricante especifica 5 V CC, 3 A para o gateway completo e identifica USB-C como interface da fonte. Chamá-lo de porta de carga sugere uma bateria que essas especificações não mencionam. Especificações do SenseCAP M1

O diagrama de blocos do fabricante separa a fonte de 5 V do trilho regulado de 3,3 V do módulo. Essa diferença importa no diagnóstico: o Pi pode estar ligado enquanto o concentrador fica sem alimentação. Não injete 5 V em um pino de sinal nem presuma que as duas entradas de energia são isoladas.

As versões SPI e USB do módulo exigem conexões diferentes ao host. A documentação WM1302 da Seeed descreve acesso SPI direto para a versão SPI e uma ponte USB STM32L4 para a versão USB. O formato mini-PCIe descreve a forma do módulo, enquanto as interfaces elétricas documentadas são SPI ou USB. Encaixar em um soquete de laptop não comprova compatibilidade. Documentação WM1302 da Seeed

Antes de energizar o conjunto, instale o módulo com a alimentação desligada e conecte uma antena adequada. Combine hardware RF, antena e plano regional pretendido. Alterar o nome de um arquivo de configuração não muda os componentes RF; o conector de alimentação M1 também não comprova suporte a uma variante USB do concentrador.

Diagrama de blocos que conecta Raspberry Pi 4 ao shield M1 por alimentação, SPI, GPIO e I2C

Diagrama do fabricante SenseCAP reproduzido no artigo original de Clockwork Bird, mostrando o projeto WM1302 · Seeed Studio / SenseCAP, via Clockwork Bird

Leia o pinout com atenção

Registre números GPIO BCM e pinos físicos do conector em colunas separadas. Por exemplo, o BCM GPIO17 fica no pino físico 11 do conector Pi. O conector de borda do módulo usa um terceiro sistema de numeração, portanto seu número de pino de reset não é um número GPIO do Raspberry Pi.

A tabela abaixo transcreve as conexões da imagem anotada de Clockwork Bird. Ela é uma referência comunitária, não um esquema completo do fabricante nem uma medição de todas as revisões M1. O desenho também usa rótulos SX1262, enquanto o script genérico de reset da Semtech usa nomes SX1261.

Sinal no desenhoBCM / pino físicoInterpretação
I2C SDA / SCLGPIO2 / 3, GPIO3 / 5Barramento de gerenciamento compartilhado
Reset SX1302GPIO17 / 11Candidato a reset do concentrador
LED do usuárioGPIO22 / 15Anotação M1
SPI MOSI / MISOGPIO10 / 19, GPIO9 / 21Sinais de dados SPI
Clock SPIGPIO11 / 23Sinal de clock SPI
Seleção SX1302GPIO8 / 24SPI0 CE0
Reset SX1262GPIO5 / 29Candidato a reset do rádio auxiliar
Seleção SX1262GPIO6 / 31GPIO6, diferente de SPI0 CE1
SX1262 BUSYGPIO18 / 12Saída de status do rádio auxiliar
SX1262 IO1 / IO2GPIO23 / 16, GPIO24 / 18Sinais auxiliares a verificar antes de usar

As anotações GPS/UART riscadas não comprovam que o M1 tenha GPS. Não inclua configurações de GPS sem esse hardware. O diagrama publicado também não esclarece o botão de usuário nem o controle do ventilador. Investigação do pinout por Clockwork Bird

Desenho anotado do conector Raspberry Pi com LED M1, reset do concentrador, sinais SPI e conexões GPS riscadas

Referência comunitária anotada com cobertura incompleta das revisões, não é um esquema M1 completo · Clockwork Bird, 2023-05-03

Resolva conflitos dos scripts de reset

Um script de reset seleciona saídas elétricas, não meras preferências de software. O reset_lgw.sh upstream da Semtech destina-se ao projeto de referência CoreCell. Os padrões incluem GPIO23 para reset do concentrador, GPIO18 para habilitar a alimentação, GPIO22 para reset auxiliar e GPIO13 para reset do AD5338R. Fonte do script de reset da Semtech

As instruções antigas da Seeed alteram as duas atribuições de reset para GPIO17 e GPIO5, mas mantêm outras entradas do projeto de referência. Compare esses valores com a imagem M1 anotada antes de seguir o exemplo. Instruções de configuração WM1302 da Seeed

AtribuiçãoEvidência conflitanteDecisão necessária
GPIO22 como reset auxiliarA imagem M1 o identifica como LED de usuárioRemova essa suposição antes de ativar o LED
GPIO18 como habilitação de alimentaçãoA imagem M1 o identifica como BUSY auxiliarVerifique a rede e a direção antes de acioná-lo
GPIO13 como reset do DACO script genérico nomeia outro projeto de referênciaDetermine se o circuito existe
Dispositivo SPI auxiliarA imagem M1 seleciona GPIO6 em vez de CE1Confirme o roteamento da seleção e o suporte do driver

Inferência: Se GPIO18 estiver conectado à saída de um rádio auxiliar como desenhado, configurá-lo como saída no lado do Pi cria risco de contenção elétrica. A divergência exige verificação, mas não comprova dano nem um mapa de fiação universal para todos os M1.

Desconecte toda a alimentação e rastreie conexões acessíveis entre o conector e o módulo. Registre a revisão da placa e as duas pontas. A continuidade comprova conexão; a documentação do componente esclarece direção e limites elétricos do sinal.

Use o diagrama do módulo abaixo para não confundir pinos do conector de borda com os do Pi. Os rótulos do rádio auxiliar descrevem a referência publicada do módulo, não provam o mesmo silício ou recursos em todas as revisões. Pinout do módulo WM1302 da Seeed

Diagrama Seeed que identifica os dois lados do conector de borda WM1302 com alimentação, SPI, I2C e sinais de rádio auxiliares

A numeração do conector de borda do módulo difere da numeração do conector Raspberry Pi · Seeed Studio, WM1302-doc

Prepare o Raspberry Pi OS

Registre o ambiente do host na instalação reserva:

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

A versão do sistema, o kernel e o modelo Pi formam o ponto de partida reproduzível. Registre-os antes de comparar resultados com um tutorial antigo.

Instale ferramentas de inspeção e compilação:

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

Em Interface Options, habilite SPI e I2C e reinicie. SPI atende ao caminho do concentrador, e I2C aos dispositivos de gerenciamento descritos adiante. Não copie alterações de porta serial GPS sem relação com este hardware de outro tutorial de HAT.

Inspecione as interfaces expostas:

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

Esses comandos listam nós de dispositivo, adaptadores, controladores GPIO, linhas e versão da ferramenta GPIO instalada. i2cdetect -l lista adaptadores sem varrer endereços. O arquivo /dev/spidev0.0 comprova que a interface SPI está exposta, não que se comunica com um concentrador funcional. Manual i2c-tools , Orientações GPIO do Raspberry Pi

Considere as versões de GPIO

Não copie números GPIO globais de outra máquina. Scripts antigos usam /sys/class/gpio, uma interface declarada obsoleta pela documentação do kernel. Novas integrações em espaço de usuário devem usar a interface GPIO character device com o controlador e o deslocamento de linha corretos. Documentação Linux GPIO

Confira também gpioset --help antes de adaptar um script. A sintaxe e o comportamento dos processos diferem entre as versões 1 e 2. A ferramenta atual mantém as linhas solicitadas por padrão, mas o contrato portátil não garante o estado depois que o processo termina. Documentação gpioset do libgpiod

O Raspberry Pi documenta um comportamento de persistência de saída no kernel e opções para alterá-lo. Registre a configuração real do kernel, sem supor que todo Linux se comporta igual. Uma numeração nova ou ferramenta GPIO recente não corrige um mapa elétrico incorreto. Guia de uso GPIO do Raspberry Pi

Teste o LED do usuário

Após confirmar que GPIO22 pertence ao LED e remover usuários GPIO conflitantes, edite a configuração de inicialização:

sudoedit /boot/firmware/config.txt

Versões modernas do Raspberry Pi OS montam a configuração de inicialização em /boot/firmware/config.txt. Imagens antigas usam /boot/config.txt, o caminho citado no artigo de 2023. Faça uma cópia do arquivo ativo antes de editá-lo. Documentação config.txt do Raspberry Pi

Adicione o overlay LED a uma seção aplicável ao Pi, como [all]:

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

O parâmetro gpio usa a numeração BCM. label nomeia o dispositivo LED Linux e trigger=heartbeat seleciona o gatilho heartbeat do kernel. Clockwork Bird relata essa atribuição para o M1, e a referência de overlays do Raspberry Pi documenta esses parâmetros. Observação original do LED , Referência do overlay gpio-led

Após reiniciar, inspecione o LED registrado:

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

O resultado esperado é uma entrada LED lorawan com heartbeat selecionado entre colchetes. O LED piscando demonstra o caminho GPIO/driver. Não indica registro LoRaWAN, recepção de rádio nem estado Helium.

Investigue dispositivos I2C

Um endereço I2C é uma pista, não uma identidade do dispositivo. Clockwork Bird observou respostas em 0x60 e 0x39, depois leu informações ATECC608 pela biblioteca criptográfica. A identificação do sensor de temperatura permaneceu provisória no artigo original.

Comece pela lista de adaptadores da seção anterior. Varreduras amplas do i2cdetect enviam transações de sondagem, não observam passivamente o tráfego, e o manual upstream alerta para interrupções. Evite sondagens rotineiras em um gateway ativo ou dispositivos conectados desconhecidos. Comportamento de sondagem do i2c-tools

ObservaçãoConclusão sustentadaQuestão em aberto
Resposta em 0x60Algo reconheceu a sondagemÉ o elemento seguro esperado?
Resposta em 0x39Algo reconheceu a sondagemQual componente e revisão responderam?
UU na varreduraUm driver possui o endereço e a sondagem foi ignoradaQual driver o possui?
Sem respostaA sondagem não recebeu confirmaçãoAlimentação, barramento, proprietário ou protocolo?

Reforce a hipótese do sensor de temperatura

STTS751 é um candidato a 0x39 respaldado por fontes. O cabeçalho do driver de temperatura Semtech associa explicitamente 0x39 ao STTS751-0DP3F. Isso reforça a hipótese original, sem identificar todos os componentes ligados a esse endereço. Cabeçalho do driver STTS751 Semtech

Após identificar um componente compatível e garantir que nenhum outro processo o utiliza, leia os registros de identificação:

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

Aqui, 1 seleciona o barramento verificado, 0x39 o dispositivo e b solicita leitura SMBus de byte de dados. Para STTS751-0, o ID do produto documentado em 0xFD é 0x00, e o ID do fabricante em 0xFE é 0x53. As transações selecionam endereços de registro, mas não gravam valores de configuração. Datasheet STTS751, mapa e registros de identificação

Compare as leituras com a marcação do chip e sua documentação. Um par correspondente aumenta a evidência de identificação; em caso de erro, verifique barramento e proprietário antes de alterar a configuração. O sensor mede sua temperatura local, diferente da temperatura da CPU do Pi.

Inspecione o elemento seguro

O ATECC608 é um componente de autenticação separado. Trate configuração, número de série, chave pública e material de chave protegido como conceitos distintos. Ler uma chave pública não revela a chave privada correspondente.

A CryptoAuthLib da Microchip oferece a interface do dispositivo. O repositório cryptoauthtools contém exemplos baseados na biblioteca. Prepare a biblioteca nativa e os bindings Python para seu sistema seguindo as instruções desses projetos antes de executar um exemplo. Instalar um pacote Python sem relação ou copiar um script isolado não comprova que o backend I2C funciona. CryptoAuthLib da Microchip , cryptoauthtools da Microchip

Em um diretório cryptoauthtools/python/examples preparado, execute o comando de inspeção do artigo original:

sudo python3 info.py -i i2c

O argumento -i i2c seleciona a interface. Em um ambiente virtual, use o interpretador Python explícito e confirme que ele localiza a biblioteca nativa correspondente. Em muitas instalações, sudo python3 seleciona o interpretador do sistema, o que explica algumas falhas de importação.

O info.py revisado lê informações de revisão, número de série, configuração e estado de bloqueio. Se a zona de dados estiver bloqueada, tenta obter a chave pública do slot 0. Não executa a sequência de provisionamento do exemplo. Uma falha isolada ao ler a chave pública do slot 0 não comprova defeito no dispositivo. Fonte do info.py da Microchip

Saída ou operaçãoSignificado
Configuração bloqueadaRestrições de configuração estão ativas
Zona de dados bloqueadaInterprete o acesso conforme as políticas dos slots configuradas
Chave pública exibidaInformações públicas foram obtidas, não houve exportação de chave privada
Execução de config.pyExemplo de provisionamento com escrita, bloqueio e geração de chaves

Não execute config.py para corrigir um erro de inspeção. O código inclui gravações de configuração, chamadas para bloquear zonas e geração de chaves. O caminho padrão de geração de chave também importa em um dispositivo já configurado. Fonte do config.py da Microchip

Os perfis de provisionamento documentados pela Microchip mostram por que uma zona de dados bloqueada não significa que todos os slots tenham permissões iguais. Esses perfis não estabelecem a configuração exata do M1. Preserve a configuração existente e consulte a documentação da peça correspondente antes de planejar uma reutilização de chaves. Políticas de memória e acesso a slots da Microchip

Investigue dúvidas sobre ventilador e botão

Um conector de ventilador de três pinos não informa tensão, polaridade nem método de controle. Fotografe a numeração dos pinos e leia o rótulo do ventilador. Confirme alimentação e controle antes de conectar um substituto ou escolher um overlay GPIO.

A investigação original também não identifica o GPIO do botão. Procure um driver ou uma configuração vinculada à revisão da placa e verifique a conectividade com a alimentação desligada. Não configure todas as GPIOs aparentemente livres como saídas para encontrar o botão.

PeriféricoEvidência a coletarCritério de aceitação
Alimentação do ventiladorEspecificação do ventilador, terra e alimentação do conectorA fonte medida corresponde à especificação do ventilador
Controle do ventiladorDriver/configuração ou circuito de controle rastreadoComportamento definido na inicialização e em temperatura elevada
Botão de usuárioFiação dos contatos, mapa GPIO, polaridade de entradaUm toque intencional produz o evento esperado

Uma nova instalação do sistema operacional não reproduz automaticamente a política de refrigeração do equipamento original. No primeiro teste prolongado, observe ventilador e temperaturas juntos. Preserve o fluxo de ar do gabinete e interrompa o teste se o conjunto perder o resfriamento necessário.

Escolha uma pilha de gateway

Separe o suporte da placa do protocolo do servidor. Um servidor LoRaWAN compatível não corrige uma rotina de reset errada nem uma calibração RF inadequada. Primeiro escolha software compatível com o concentrador, a fiação do carrier, o sistema e a configuração regional.

Opção de softwareFunção útilVerificar antes da implantação
Semtech SX1302 HALInicialização no nível do código-fonte e ferramentas de diagnósticoRotina de reset da placa e configuração do módulo
LoRa Basics StationConexão autenticada do gateway a um servidorIntegração funcional da placa e credenciais do servidor
ChirpStack ConcentratordServiço dedicado ao concentradorModelo compatível, calibração e mapa GPIO

O ChirpStack lista o modelo SPI seeed_wm1302. Isso comprova suporte ao módulo, não uma imagem M1 completa nem suporte a todas as revisões. Não trate as instruções separadas de instalação SenseCAP M2 como firmware M1. Suporte de hardware ChirpStack , Alvo de instalação Seeed no ChirpStack

Para o The Things Stack, a documentação recomenda LoRa Basics Station em vez do encaminhador UDP Semtech legado. Station oferece TLS e autenticação por token, além de funções de configuração centralizada. Exemplos UDP ajudam a entender o encaminhamento de pacotes, mas seus parâmetros de servidor não fornecem essas proteções. Orientações UDP do The Things Stack , Documentação LoRa Basics Station

Prepare as ferramentas upstream

Compile no Pi alvo em um novo diretório de trabalho:

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

Salve o identificador do commit com a saída do build. Uma compilação concluída comprova compatibilidade com o compilador, mas o rádio ainda exige uma rotina de reset verificada e configuração correta. A documentação Semtech explica a função do HAL e das ferramentas auxiliares. Documentação de build e ferramentas SX1302 HAL

Revise o arquivo de reset antes de executar ferramentas de acesso ao hardware:

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

Não copie esse arquivo sem alterações para o diretório de execução. A Semtech documenta que seus programas de acesso ao hardware, inclusive ferramentas de identificação, usam o script de reset automaticamente. Revise cada pino atribuído, sentido do sinal, API GPIO e estado de inicialização/encerramento.

Depois de verificar a placa, siga as instruções da pilha escolhida para ler o EUI do concentrador e registrar o gateway. Preserve a calibração do módulo e as configurações RF ao adicionar os dados do servidor. Na configuração UDP Semtech, gateway_ID representa o EUI; o Gateway ID do console The Things Stack é o identificador legível usado no registro. Configuração de gateway The Things Stack

Comprove a entrega do sensor

Use evidências por etapas para localizar a primeira camada que falha. Um gateway indicado como online comprova conexão ao servidor. O teste de aceitação também precisa de um sensor conhecido, plano de frequência correspondente e payload de aplicação decodificado.

A sequência abaixo é um plano de teste proposto, não resultados medidos em um M1:

EtapaEvidência a salvarSignificado
Host prontoSistema, kernel, alimentação e inventário de interfacesPreparação Linux concluída
Concentrador respondeEUI e log de inicialização bem-sucedidaComunicação host-concentrador funciona
Recepção de rádioPacote esperado do sensor e metadados de recepçãoCaminho de recepção configurado funciona
Servidor aceitaEvento de gateway associado ao sensorEncaminhamento e roteamento do servidor funcionam
Aplicação decodificaMedição esperada e registro de data e horaCaminho da aplicação funciona
Recuperação após reinícioAs mesmas verificações após reiniciarConfiguração de inicialização é reproduzível

Para um sensor OTAA, confirme também a troca de ativação e o uplink seguinte. OTAA significa ativação over-the-air, o processo de ingresso que estabelece uma sessão. Receber uma solicitação de ingresso não comprova ingresso concluído nem caminho de downlink. Documentação de ativação The Things Stack

Diagnóstico prático: o gateway conecta ao servidor e informa seu EUI, mas o sensor não aparece. Priorize a configuração de transmissão do sensor, os canais de recepção selecionados, o trajeto da antena e os logs de rádio. Reprogramar o ATECC608 não resolveria a falta de evidências nesse cenário.

Segundo diagnóstico: um pacote do sensor aparece localmente, mas não chega à aplicação. Correlacione o horário do pacote com eventos do gateway e do servidor, depois examine roteamento, registro do dispositivo e decodificação. Um pacote RF no log não basta para culpar o decodificador antes que o servidor aceite o evento.

Solucione problemas por sintoma

SintomaVerifique primeiroPróxima ação
Arquivo de dispositivo SPI ausenteConfiguração de boot ativa e opções de interfaceAtive a interface pretendida e reinicie
SPI existe, rádio falhaAlimentação, encaixe, sequência de reset e seleção do chipVerifique o caminho elétrico antes de mudar o servidor
Erro de exportação GPIOPremissas antigas de sysfs e kernel instaladoUse uma implementação revisada para a API GPIO
GPIO ocupadoConsumidor mostrado por gpioinfoResolva a propriedade antes de tentar novamente
LED falha após configuraçãoAplicação do overlay e conflitos GPIO22Examine LEDs registrados e script de reset
Dispositivo I2C ausenteNúmero do barramento, alimentação e propriedade existenteInvestigue sem repetir varreduras amplas
Falha ao importar biblioteca criptográficaInterpretador, bindings e caminho da biblioteca nativaCorrija o ambiente de software
Falha ao ler chave públicaPolítica do slot e leituras anteriores bem-sucedidasExamine a configuração sem provisionar
Ventilador não funcionaAlimentação verificada e controle de refrigeraçãoRestaure a refrigeração antes de testes prolongados
Uplinks chegam, ingresso falhaCaminho downlink e configurações regionais/do dispositivoRastreie a resposta de ingresso e as janelas de recepção

Trate cada correção como um experimento. Salve a configuração anterior, altere uma variável, repita o mesmo teste e registre se a evidência esperada apareceu.

Crie seu registro de hardware

Use este modelo para transformar a investigação em um repasse reproduzível:

Revisão do carrier e fotos:
Modelo do concentrador, interface e banda RF:
Modelo do host / sistema / kernel / versão da ferramenta GPIO:
Fonte / antena / arranjo de refrigeração:
Mapa de pinos verificado e evidências:
Redes não resolvidas e recursos excluídos:
Repositório do software e commit:
Implementação do reset e propriedade GPIO:
EUI do gateway / servidor / plano de frequência:
Ativação do sensor e evidência do uplink decodificado:
Resultado da recuperação após reinício:
Local do cartão original e procedimento de rollback:

Exercício de decisão: você tem um carrier simples barato sem rótulo do módulo e um conjunto mais caro com rótulos legíveis e funcionamento documentado. Decida qual atende ao projeto após incluir o Pi, concentrador, antena, fonte e tempo de verificação necessários. A melhor escolha considera o custo total e as evidências exigidas pelo serviço, não apenas o preço anunciado do carrier.

Raciocínio esperado: um projeto de aprendizagem tolera fiação não resolvida se houver instrumentos e tempo. Um gateway para sensores operacionais exige inicialização repetível, refrigeração, suporte de software e entrega demonstrada. Registre qual condição não resolvida interromperia a implantação.

Próximas etapas

Comece completando o registro de hardware e resolvendo as divergências do script de reset. Em seguida, coloque um sensor conhecido em operação e salve evidências até a decodificação pela aplicação antes de adicionar mais dispositivos.

Registro de aceitação: salve a revisão da placa, rótulo do módulo, banda de rádio, medida de alimentação, dispositivo SPI ativo, nomes das linhas GPIO, sequência de reset, log do concentrador, conexão ao servidor e um uplink decodificado. Marque cada valor como observado, documentado ou ainda presumido. Não trate a inicialização de um processo como prova de desempenho RF ou entrega à aplicação.

Se seu objetivo for mensagens mesh, compare primeiro os papéis dos protocolos em nosso guia Meshtastic, MeshCore e Reticulum . Compartilhar a tecnologia de rádio LoRa não comprova compatibilidade de firmware. Para uma implantação de mensagens, consulte a documentação de hardware compatível com MeshtasticD em vez de tratar este procedimento LoRaWAN como conversão para Meshtastic.

Fontes e créditos das imagens

Pesquisa verificada em 12 de setembro de 2026. Links sem data para documentos e repositórios referem-se às versões analisadas para este artigo. Figuras locais mantêm seus rótulos e atribuições originais.

EditorFonte e data
Clockwork BirdSenseCAP M1 Raspberry Pi Shield , 2023-05-03. Foto da placa, conector anotado e diagrama de blocos do fabricante reproduzido
Seeed Studio / SenseCAPVisão geral e especificações do M1 , sem data. Atribuição do diagrama original
Seeed StudioDocumentação WM1302 e pinout do módulo , repositório
SemtechSX1302/SX1303 HAL , com fontes vinculadas do script de reset e driver de temperatura
Raspberry PiConfiguração de boot , guia de uso GPIO e referência de overlays
Linux / libgpiodInterface GPIO sysfs obsoleta e manual gpioset , este último de agosto de 2026
i2c-toolsManual i2cdetect , fonte v4.3
STMicroelectronicsDatasheet STTS751 , revisão 7
MicrochipCryptoAuthLib , cryptoauthtools e documentação da política de acesso aos slots
ChirpStackSuporte de hardware Concentratord e alvo de instalação Seeed
The Things IndustriesEncaminhador UDP , LoRa Basics Station e ativação de dispositivos
MeshtasticDocumentação MeshtasticD , sem data