Pular para o conteúdo principal

Introdução ao Ripple

O que é o Ripple?​

Ripple UI é um firmware com tela sensível ao toque para o L2 Pro. Ele permite adicionar contatos, enviar e receber mensagens, visualizar mapas e registrar suas trilhas de GPS diretamente no dispositivo, sem usar um telefone para essas tarefas.

Como o Ripple se relaciona com o MeshCore?​

MeshCore gerencia a comunicação em malha. Ripple UI permite usá-lo diretamente na tela sensível ao toque do L2 Pro.

NomeFinalidade
MeshCoreComunicação em malha LoRa
Firmware Ripple UIOperação autônoma com tela sensível ao toque
Firmware MeshCore CompanionOperação por meio de um telefone ou outro cliente

Grave o Ripple UI diretamente; não é necessário instalar o Companion antes.

nota

O firmware atualizado usa perfis MeshCore e não oferece mais Ripple na tela New Network.

Para quem é o Ripple?​

  • Usuários que desejam conversar diretamente no dispositivo sem manter um telefone conectado.

  • Usuários ao ar livre que desejam mapas offline e um registro da própria rota.

  • Usuários que desejam alternar entre diferentes perfis de rede MeshCore.

  • Usuários avançados que precisam gerenciar repetidores MeshCore, Room Servers ou nós de sensores. Alguns recursos de gerenciamento exigem um código de desbloqueio pago.

Recursos​

  • Mensagens autônomas: Envie mensagens diretas e em grupo pela tela sensível ao toque.

  • Vários perfis de rede: Mantenha configurações de rádio, identidades, contatos e preferências separados.

  • Tela inicial personalizável: Adicione atalhos para contatos, canais e configurações.

  • Mapas: Carregue mapas a partir de um microSD, arraste para mover e toque nos botões para aplicar zoom.

  • Trilhas de GPS: Registre sua posição e carimbos de data e hora e, em seguida, visualize sua rota no mapa.

  • Capturas de tela: Pressione e segure o canto superior esquerdo da tela para capturar a visualização atual.

  • Administração remota: Desbloqueie recursos de gerenciamento de nós com a autorização do nó de destino.

Gravar o firmware​

Se o seu dispositivo já tiver a versão do Ripple UI descrita aqui, pule para Configuração inicial.

Duas variantes de firmware estão disponíveis:

  • Ripple GUI: dados no cartão SD (-SD): Armazena configuração e dados em um cartão microSD. Insira um cartão formatado em FAT32 de 32 GB ou menos antes de usar.

  • Ripple GUI (Interno): Armazena configuração e dados na memória flash interna do dispositivo.

Etapa 1: Abra o gravador web

Visite o Wio Tracker L2 Web Flasher e selecione o firmware Ripple UI e a variante de armazenamento para o L2. Use um navegador de desktop que ofereça suporte a acesso serial, como Chrome ou Edge.

Selecione Seeed Studio Wio Tracker L2 Pro, escolha uma variante Ripple GUI e selecione a versão do firmware. A captura de tela abaixo mostra a v12.3.

Selecione o L2 Pro, a variante Ripple GUI e a versão do firmware no gravador web

Etapa 2: Entre manualmente no modo de download

Mantenha pressionado o botão U/B enquanto conecta o cabo de dados USB e, em seguida, pressione RST para entrar no modo de download de firmware.

Entrando no modo de download usando os botões U/B e RST

Etapa 3: Selecione a porta e grave

Clique em Flash!, selecione seu dispositivo na caixa de diálogo de porta serial e conecte. Siga as instruções na tela para concluir a gravação.

atenção

A opção Erase device mostrada acima apaga dados e configurações na memória flash interna, incluindo o estado de desbloqueio. Faça backup de dados importantes e mantenha seu Unlock Code antes de apagar.

Etapa 4: Reinicie

Após a conclusão da gravação, pressione RST para iniciar o Ripple UI.

dica

Se você não conseguir prosseguir após clicar em Flash, confirme se o dispositivo está no modo de download. Verifique também o cabo de dados USB, as permissões seriais do navegador e se outro aplicativo está usando a porta.

Configuração inicial​

Siga os tutoriais de tela sensível ao toque e botões na primeira inicialização.

Telas de inicialização do Seeed Studio e MeshCore Ripple UI

Botões de hardware​

Ripple UI combina entrada por tela sensível ao toque com dois botões de hardware:

  • Tela ligar/desligar (botão superior): Pressione para ativar a tela ou desligá-la. Desligar a tela não desliga o dispositivo.
  • ENTER (botão lateral U/B): Pressione para confirmar uma seleção, salvar alterações ou enviar uma entrada quando solicitado.

Botões de hardware do L2 Pro: botão superior para ligar/desligar a tela e botão lateral U/B para ENTER

Criar um perfil de rede​

  1. Conclua os tutoriais de tela sensível ao toque e do botão Select exibidos na primeira inicialização.

  2. Escolha um preset de rádio apropriado para sua região ou insira a frequência, o fator de espalhamento (SF) e outros parâmetros usados pela sua rede local.

  3. Dê um nome ao perfil usando letras e números, sem espaços.

  4. Salve o perfil. Se solicitado, reinicie o dispositivo para aplicar as configurações.

Para um teste com dois dispositivos, use configurações de rádio correspondentes em ambos os dispositivos. Selecionar o mesmo preset é a opção mais simples. Com configurações personalizadas, verifique também a largura de banda, a taxa de codificação e outros parâmetros, em vez de corresponder apenas frequência e SF.

Defina seu nome​

  1. Toque em L à esquerda, abra o perfil de rede atual e selecione Identity.

  2. Altere o nome padrão para algo reconhecível, como micha ou michb. Os nomes podem conter até 31 caracteres.

Abra o perfil de rede, selecione Identity e altere o nome do dispositivo

Explore a interface​

Toque em G, L ou M no lado esquerdo da tela para alternar entre as três telas iniciais.

G é uma tela inicial personalizável com uma grade de 3 × 4.

  • Pressione e segure uma célula vazia para adicionar um atalho para um contato, canal de grupo ou configuração.

  • Pressione e segure um atalho existente para removê-lo.

Tela inicial Grid do Ripple UI

Barra de título e menu do sistema​

ÁreaFunção
Toque no lado esquerdo da barra de títuloAbre Switch To para alterar perfis de rede
Pressione e segure o canto superior esquerdoCaptura uma captura de tela
Meio da barra de títuloAbre alternâncias rápidas
Lado direito da barra de títuloAbre informações de GPS
Menu inferior esquerdo na tela inicialAbre as configurações do sistema, incluindo Display, Wi-Fi, Networks e Timezone

Fazer uma captura de tela​

Pressione e segure o canto superior esquerdo da tela para capturar a visualização atual. Você pode usar capturas de tela para compartilhar configurações ou relatar um problema.

Pressionando e segurando o canto superior esquerdo para fazer uma captura de tela

As capturas de tela são arquivos BMP com nomes de arquivo contendo data e hora, como mostrado abaixo.

Capturas de tela BMP com nomes de arquivo contendo data e hora

Envie sua primeira mensagem​

Torne seus dispositivos detectáveis​

  1. Configure ambos os dispositivos com configurações de rádio MeshCore correspondentes.

  2. Dê a cada dispositivo um nome de Identity diferente.

  3. Defina Advert como On para permitir anúncios de identidade.

  4. Abra Discover na página L e aguarde os nós próximos aparecerem.

Para enviar um anúncio de identidade imediatamente, abra o menu Discover:

Menu Discover com Scan Local, Send ID Local e Send ID Broadcast

OpçãoFunção
Send ID LocalEnvia um anúncio de identidade de zero salto para dispositivos próximos
Send ID BroadcastTransmite sua identidade para a malha
Scan LocalSolicita respostas de nós próximos que oferecem suporte a respostas de descoberta; comumente usado para descobrir repetidores

Scan Local não lista todos os dispositivos. Um nó deve estar dentro do alcance e configurado para responder.

Adicionar contatos​

  1. Selecione o nó de destino em Discover.

  2. Abra o menu no canto superior direito e selecione Add to Contacts.

  3. Volte para L e confirme que o contato está listado.

  4. Repita no outro dispositivo.

Descubra nós próximos, adicione um nó aos contatos e visualize-o na lista de contatos

Enviar uma mensagem direta​

  1. Abra o contato.

  2. Toque no campo de entrada e digite uma mensagem.

  3. Pressione ENTER para enviar e aguarde o reconhecimento.

  4. Abra a conversa no outro dispositivo e responda.

Mensagens diretas aguardam um reconhecimento (ACK) do destinatário. Se o envio falhar, verifique as configurações de rádio e a distância, depois tente novamente. Se a rota anterior não puder mais ser usada, selecione Flood (reset) em Path para encontrar uma nova rota.

Mapas e trilhas de GPS​

Preparar mapas offline​

  1. Prepare um cartão microSD formatado em FAT32 de 32 GB ou menos.

  2. Salve os blocos de mapa raster usando esta estrutura de pastas no cartão:


/tiles/{zoom}/{x}/{y}.png

  1. Insira o cartão, ligue o dispositivo e abra M. O dispositivo precisará ser reiniciado se o cartão SD for montado ou desmontado.

  2. Desloque o mapa até uma área coberta pelos seus blocos e selecione um nível de zoom disponível.

zoom é o nível de zoom; x e y são coordenadas dos blocos. Dispositivos bloqueados renderizam apenas níveis de zoom 1–9. Níveis de zoom mais detalhados exigem um código de desbloqueio.

Baixar mapas via Wi-Fi (desbloqueio necessário)​

  1. Desbloqueie o dispositivo usando as instruções abaixo.

  2. Abra Wi-Fi no menu do sistema da tela inicial.

  3. Insira o nome e a senha da sua rede e ative o download de mapas.

  4. Pressione ENTER para salvar e reinicie quando solicitado.

  5. Confirme que o menu Wi-Fi mostra um indicador de conexão laranja.

  6. Abra o mapa e desloque ou aplique zoom até a área desejada. Os blocos são baixados sob demanda e armazenados em cache no cartão SD.

Definir a localização usada em anúncios​

Configuração de localização do anúncioLocalização usada
GPSA posição obtida pelo GPS do dispositivo
ManualUma posição fixa selecionada com Advert Loc no mapa

Para usar um ponto selecionado no mapa, primeiro defina Advert Location como Manual. No modo GPS, os anúncios continuam usando a posição do GPS.

Desbloquear recursos premium​

Você pode testar a troca de mensagens básica antes de comprar um código de desbloqueio. Desbloqueie o dispositivo quando precisar de mapas detalhados, downloads de mapas via Wi-Fi, trilhas mais longas ou recursos avançados de administração.

Encontrar o número de série do seu dispositivo​

Encontre e abra Unlock nos menus do dispositivo. Anote o Serial number exibido nessa tela. Use esse número de série completo para sua compra, em vez dos últimos caracteres de um endereço MAC ou de um PIN de Pair Device.

Obter um código de desbloqueio​

Abra a página de código de desbloqueio do Ripple Ultra do Scott, siga as instruções de compra e forneça o número de série exibido no seu dispositivo. As licenças são emitidas por dispositivo; insira apenas um número de série de dispositivo para cada licença.

Se o seu dispositivo veio com um código de desbloqueio aplicável, prossiga para a próxima etapa.

Inserir o código no seu dispositivo​

  1. Quando você receber o código de desbloqueio para o seu número de série, abra Unlock novamente.

  2. Insira o código completo e envie.

  3. Após a ativação bem-sucedida, a opção Unlock desaparece.

  4. Abra o recurso premium que você deseja usar e confirme que ele está disponível.

Guarde o código junto com o número de série do dispositivo. Em nosso teste, apagar a flash com erase_flash e reinstalar o firmware exigiu inserir novamente o código de desbloqueio do dispositivo.

Recursos premium​

  • Telemetria automática: Solicita telemetria quando você abre uma conversa com um caminho direto. Mostra localização, direção e distância se o outro nó permitir telemetria de GPS.

  • Room Admin CLI: Acesse a linha de comando do Room Server com sua senha de administrador.

  • Repeater Admin: Verifique o status do repetidor e gerencie o nó remotamente.

  • Sensor Admin: Acesse comandos de sensor, telemetria e gerenciamento de permissões.

  • Zoom de mapa mais detalhado: Exiba blocos de mapa acima do nível de zoom 9.

  • Download via Wi-Fi: Baixe blocos de mapa sob demanda e armazene-os em cache no cartão SD.

  • Trilhas de GPS mais longas: Registre mais do que os 64 pontos de GPS permitidos em dispositivos bloqueados.

Uso avançado​

Criar e alternar perfis de rede​

  1. Abra o menu do sistema na tela inicial e selecione Networks.

  2. Selecione New Network, configure as configurações de rádio e nomeie o perfil.

  3. Salve e reinicie se solicitado.

  4. Toque no lado esquerdo da barra de título e selecione um perfil em Switch To.

Criando um perfil de rede MeshCore em Networks

Cada perfil tem sua própria identidade, contatos e preferências. Abrir um contato pertencente a outro perfil pode solicitar que você alterne de perfil. Esse aviso não indica que o dispositivo detectou qual rede o outro nó está usando no momento.

FAQ​

Código de status SX1262​

Esta tela mostra o código de retorno RadioLib da inicialização do rádio LoRa. 0 significa que a inicialização foi bem-sucedida. A tela é destinada a diagnósticos de rádio.

Código de inicialização SX1262=0 indica sucesso

Descobrir outro dispositivo​

  • Confirme que ambos os dispositivos usam perfis MeshCore compatíveis com configurações de rádio correspondentes.

  • Ative Advert no outro dispositivo ou peça para ele enviar Send ID Local.

  • Comece com um teste de curta distância em uma área aberta.

  • Scan Local lista apenas nós que respondem a solicitações de descoberta; ele não substitui anúncios de identidade de todos os dispositivos.

Por que o mapa está em branco​

Verifique o formato do cartão SD, os caminhos dos blocos e se existem blocos para a área exibida. Em um dispositivo bloqueado, verifique também se o nível de zoom está entre 1–9. Uma posição de GPS válida não significa que os blocos de mapa foram baixados.

Recursos​

Suporte técnico e discussão sobre o produto​

Loading Comments...