{"id":20113633,"url":"https://github.com/elcereza/pkt_fwd_raspbian","last_synced_at":"2025-07-03T18:32:48.458Z","repository":{"id":159855091,"uuid":"625709858","full_name":"elcereza/pkt_fwd_raspbian","owner":"elcereza","description":"Pacote de instalação automática do Packet forwarder para Raspbian","archived":false,"fork":false,"pushed_at":"2024-09-25T22:27:25.000Z","size":195,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-11-13T18:32:06.872Z","etag":null,"topics":["iot","lorawan","lorawan-application","lorawan-device","lorawan-gateway","mqtt","raspberry-pi"],"latest_commit_sha":null,"homepage":"https://elcereza.com/gateway-lorawan-da-radioenge-tutorial-completo/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elcereza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-09T23:45:20.000Z","updated_at":"2024-09-26T09:08:11.000Z","dependencies_parsed_at":"2024-02-17T00:27:15.482Z","dependency_job_id":"c9f749e5-0eb7-4e69-aba6-0adc3c544761","html_url":"https://github.com/elcereza/pkt_fwd_raspbian","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elcereza%2Fpkt_fwd_raspbian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elcereza%2Fpkt_fwd_raspbian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elcereza%2Fpkt_fwd_raspbian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elcereza%2Fpkt_fwd_raspbian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elcereza","download_url":"https://codeload.github.com/elcereza/pkt_fwd_raspbian/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233699721,"owners_count":18716264,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iot","lorawan","lorawan-application","lorawan-device","lorawan-gateway","mqtt","raspberry-pi"],"created_at":"2024-11-13T18:25:10.004Z","updated_at":"2025-01-13T06:08:32.513Z","avatar_url":"https://github.com/elcereza.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Instalação do Gateway LoRaWAN da Radioenge no Raspbian\n\nSe você ainda não possui o Gateway LoRaWAN da Radioenge nem o módulo, poderá adquiri-los nos links abaixo:\n- **Gateway LoRaWAN da Radioenge (COM GPS)**: [Mercado Livre](https://mercadolivre.com/sec/2bjyVGK)\n- **Gateway LoRaWAN da Radioenge (SEM GPS)**: [Mercado Livre](https://mercadolivre.com/sec/1qDmBH6)\n- **Módulo LoRaWAN Radioenge**: [Mercado Livre](https://tago.io?fpr=elcereza) ou [Amazon](https://amzn.to/3SwzZdC)\n\nRecomendações:\n- [Tutorial Completo do Gateway LoRaWAN da Radioenge](https://elcereza.com/gateway-lorawan-da-radioenge-tutorial-completo)\n- [Módulo LoRaWAN da Radioenge Tutorial Completo](https://elcereza.com/modulo-lorawan-da-radioenge-tutorial-completo/)\n- [The Things Network Primeiros Passos](https://elcereza.com/the-things-network-primeiros-passos/)\n- [Plataforma para IoT TagoIO](https://tago.io?fpr=elcereza)\n\n---\n\nEste guia rápido irá te mostrar como instalar e configurar o gateway LoRaWAN da Radioenge em uma Raspberry Pi com Raspbian. O processo inclui clonagem do repositório, configuração de permissões, execução do script de instalação e ajustes das configurações de localização no arquivo `global_conf.json`.\n\n## Requisitos\n\n- Raspberry Pi 3 ou equivalente com Raspbian instalado;\n- Acesso à internet na Raspberry Pi;\n- Conexão física ao gateway LoRaWAN da Radioenge;\n- Conta na The Things Network.\n\n## Passos de Instalação\n\n### 1. Clonar o repositório com o pacote de instalação:\n\nAbra o terminal e execute o comando abaixo para clonar o repositório que contém os arquivos necessários para configurar o gateway LoRaWAN:\n\n```bash\nsudo git clone https://github.com/elcereza/pkt_fwd_raspbian\n```\n\n### 2. Acessar o diretório clonado:\nApós clonar o repositório, entre no diretório `pkt_fwd_raspbian`:\n\n```bash\ncd pkt_fwd_raspbian\n```\n\n### 3. Ajustar permissões do script de instalação:\nTorne o script `install.sh` executável e ajuste as permissões para o usuário pi:\n\n```bash\nsudo chmod +x install.sh\nsudo chown pi:pi install.sh\n```\n### 4. Executar o script de instalação:\nInicie o processo de instalação executando o script `install.sh`:\n\n```bash\nsudo ./install.sh\n```\nEste script irá configurar os componentes necessários para o funcionamento do gateway LoRaWAN.\n\n### 5. Parar o serviço elcereza antes de editar as configurações:\nAntes de modificar o arquivo de configuração, pare o `serviço elcereza` para garantir que as alterações sejam aplicadas corretamente:\n\n```bash\nsudo systemctl stop elcereza.service\n```\n\n### 6. Editar o arquivo global_conf.json:\n#### 6.1. Obter o MAC Address da rede Wi-Fi:\nO Gateway ID é derivado do `MAC Address` da interface de rede da Raspberry Pi. Para obter o MAC Address da rede Wi-Fi, use o seguinte comando:\n```bash\nifconfig wlan0 | grep ether\n```\nA saída será algo semelhante a:\n```bash\nether b8:27:eb:12:34:56  txqueuelen 1000  (Ethernet)\n```\nO MAC Address neste exemplo é `b8:27:eb:12:34:56`. Para criar o Gateway ID, siga as etapas abaixo:\n\nPegue os 3 primeiros bytes do MAC Address `(b8:27:eb)`.\nAdicione o valor fixo `656C` após os 3 primeiros bytes.\nPegue os 3 últimos bytes do MAC Address `(12:34:56)`.\nO resultado será: `b827eb656c123456`.\n\n#### 6.2. Modificar o arquivo global_conf.json:\nAgora que você tem o `Gateway ID`, abra o arquivo `global_conf.json` para editar o Gateway ID, `latitude (lat)` e `longitude (long)` conforme a localização física do seu gateway `(se não tiver GPS)`. Caso sua versão de gateway tenha o GPS, desabilite o `fake_gps`.\n\nPara editar o arquivo, use um editor de texto como o nano:\n\n```bash\nsudo nano /elcereza/LoRaWAN/global_conf.json\n```\nAjuste os campos de acordo com seu Gateway ID e localização:\n\n```json\n\"gateway_conf\": {\n    \"gateway_ID\": \"b827eb656c123456\",\n    \"server_address\": \"au1.cloud.thethings.network\",\n    \"serv_port_up\": 1700,\n    \"serv_port_down\": 1700,\n    \"serv_enabled\": true,\n    \"ref_latitude\": X.XXXXX,\n    \"ref_longitude\": Y.YYYYY,\n    \"ref_altitude\": Z\n}\n```\n`gateway_ID`: Insira o Gateway ID gerado com base no MAC Address da sua Raspberry Pi.\n`ref_latitude`: Insira a latitude da localização do gateway.\n`ref_longitude`: Insira a longitude da localização do gateway.\n`ref_altitude`: Insira a altitude da localização (em metros, opcional).\nSalve o arquivo (`Ctrl + O`, depois `pressione Enter`) e feche o editor (`Ctrl + X`).\n\n### 7. Reiniciar o serviço elcereza:\nApós salvar as alterações no arquivo de configuração, `reinicie o serviço elcereza`:\n\n```bash\nsudo systemctl start elcereza.service\n```\n`Verifique se o LED verde no gateway acende`, indicando que ele está em funcionamento.\n\n### 8. Verificar o status do serviço elcereza:\nPara confirmar que o serviço foi iniciado corretamente, use o comando abaixo para verificar o status:\n\n```bash\nsudo systemctl status elcereza.service\n```\nSe o serviço estiver rodando corretamente, a saída deve exibir algo semelhante a `active (running)`.\n\n#### 8.1 Troubleshooting\nCaso o LED verde não acenda, verifique os logs do serviço para diagnosticar possíveis problemas:\n```bash\nsudo journalctl -u elcereza.service\n```\nCertifique-se de que o gateway está conectado corretamente à Raspberry Pi e que todas as dependências foram instaladas corretamente durante a execução do `install.sh`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felcereza%2Fpkt_fwd_raspbian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felcereza%2Fpkt_fwd_raspbian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felcereza%2Fpkt_fwd_raspbian/lists"}