Perguntas frequentes

Windows: portas seriais e adaptadores USB-serial, Bluetooth LE, dispositivos USB HID e TCP. Android: adaptadores USB-serial via USB-OTG, Bluetooth LE e TCP. O aparelho Demo embutido responde como uma placa real, então dá para testar tudo sem hardware.

Abra Aparelhos e conecte ao Demo. Ele devolve o que você envia e responde a alguns comandos. Na tela Cenários, toque em Carregar o cenário de demonstração e em Executar para ver um teste completo passou/falhou.

Não nesta versão. O LinkJig conversa com módulos Bluetooth LE (HM-10, ESP32, nRF e similares). O Bluetooth clássico serial está planejado.

Ainda não. O LinkJig roda no Windows e no Android.

Muitas placas ESP32 e Arduino reiniciam ou entram no bootloader quando a linha DTR ou RTS muda. O LinkJig deixa as duas desligadas por padrão e as define assim que a porta abre, então conectar não gera pulso. Se a sua placa precisa delas ligadas, ative Ligar DTR ao conectar ou Ligar RTS ao conectar nos ajustes da serial.

Outro programa está com a porta aberta — geralmente um monitor serial, uma IDE ou uma segunda janela do LinkJig. Feche-o e toque em Tentar de novo. A mensagem mostra o erro real do Windows, então "acesso negado" significa ocupada, não cabo com defeito.

O baud rate não bate com o do aparelho. O LinkJig percebe dados ilegíveis e oferece Mudar baud. Se você não sabe a velocidade, use Descobrir baud rate nos ajustes da serial: ele testa as velocidades comuns (115200 primeiro), envia um comando à sua escolha (por exemplo AT) ou só escuta, e para na primeira velocidade que dá uma resposta legível. Bits de dados, paridade e stop bits também precisam bater; a maioria dos aparelhos usa 8N1, o padrão.

Verifique nesta ordem:

• Fim de linha. A maioria dos aparelhos só age no fim da linha. O padrão é CR LF (\r\n); alguns aparelhos querem só CR ou só LF.
• Ligação. TX vai no RX, RX no TX, e os terras (GND) estão ligados.
• Baud rate e os demais ajustes da linha.
• A barra de envio mostra os bytes exatos antes de enviar, para você comparar com o manual do aparelho.

Use um adaptador ou cabo USB-OTG e depois conecte o adaptador. O Android pergunta se o LinkJig pode usar o dispositivo — permita. Alguns celulares precisam ativar o OTG nas configurações. Adaptadores com chips CP210x, CH34x, FTDI e PL2303, e placas CDC-ACM, são suportados.

Alguns celulares cortam a alimentação USB-OTG com bateria baixa. O LinkJig avisa quando isso pode acontecer. Carregue o celular ou use um hub OTG com alimentação própria.

Confira se o Bluetooth está ligado e se o LinkJig tem a permissão "Dispositivos por perto" (Android 12 ou mais novo) ou Localização (Android 11 ou mais antigo). O LinkJig avisa claramente quando falta uma permissão ou o Bluetooth está desligado; "Nenhum dispositivo encontrado" quer dizer que a busca funcionou e ninguém respondeu. Muitos módulos BLE param de se anunciar enquanto outra coisa está conectada a eles.

No Android 11 e anteriores, o sistema só mostra aparelhos Bluetooth por perto para apps com permissão de Localização. O LinkJig nunca lê nem guarda onde você está.

Nordic UART (NUS), TI CC254x / HM-10 (FFE0) e Microchip transparent UART são detectados automaticamente. Para outros módulos, o LinkJig escolhe um serviço com uma característica de escrita e outra de notificação. Se escolher a errada, abra o Explorador GATT pelo menu do terminal, escolha as características TX e RX e toque em Usar no terminal.

Escolha Rede, digite o nome do host ou o endereço IP e a porta, e conecte. O LinkJig conecta como cliente TCP — por exemplo a um ESP32 ou a uma ponte serial↔Wi-Fi. Aparelhos que se anunciam por mDNS (como esp32.local) aparecem em Nesta rede depois de tocar em Procurar.

Em Rede, toque em Buscar na seção Wi-Fi e depois na rede do módulo. Digite a senha uma vez; com Lembrar senha ligado, da próxima vez basta um toque. Depois de entrar, o LinkJig preenche o endereço do módulo (geralmente 192.168.4.1): toque em Conectar. A conexão salva lembra o Wi-Fi, então depois um toque entra na rede e conecta. No Android, a primeira busca pede a permissão de Localização: o Android só mostra redes Wi-Fi para apps que a têm. O LinkJig nunca lê a sua localização.

No Android 10 ou mais novo, não: só o LinkJig usa a rede do módulo e o resto do celular continua com internet. No Windows e no Android 9 o aparelho inteiro passa para a rede do módulo até você tocar em Sair (ou Voltar para … no Windows). O Windows nunca entra sozinho na rede de um módulo depois.

No Windows, sim. Em Conexões salvas, abra o menu da conexão e escolha Criar atalho na área de trabalho. Ao abri-lo, o LinkJig inicia, entra no Wi-Fi salvo se a conexão tiver um e conecta. O atalho nunca contém senha.

Só no seu aparelho: no Android criptografadas com uma chave do Android Keystore e fora dos backups; no Windows no perfil de Wi-Fi do sistema. Para apagar uma, abra o menu da rede na lista de Wi-Fi e escolha Esquecer senha.

Não nesta versão.

Mude o formato de entrada da barra de envio para HEX e digite bytes como 01 03 00 00 00 0A. DEC e BIN funcionam do mesmo jeito. No modo texto (ASCII) você pode usar sequências de escape: \r, \n, \t e \xNN para qualquer byte.

As teclas de controle são bytes únicos: Ctrl+C é \x03, Ctrl+D é \x04 e Ctrl+Z é \x1A (Esc é \e). No modo texto (ASCII), digite \x03 ou mude para HEX e digite 03; deixe o fim de linha em Sem EOL se o dispositivo espera o byte sozinho. Salve como macro para enviar com um toque. No Windows, Ctrl+C no terminal copia a seleção; não envia nada.

Sim. Escolha um checksum na barra de envio (SUM8, XOR8, CRC-8, CRC-16/MODBUS, CRC-16/CCITT-FALSE ou CRC-32); ele é adicionado depois dos seus dados e antes do fim de linha, e a prévia mostra o resultado. A Calculadora de checksum em Ajustes → Ferramentas funciona com quaisquer bytes sem enviar nada.

O LinkJig agrupa os bytes recebidos em pacotes. Por padrão, um pacote termina quando não chegam dados por 20 ms (Intervalo). Em Ajustes → Separação de pacotes você pode dividir por bytes delimitadores (por exemplo 0D 0A) ou mostrar cada leitura do jeito que chega (Bruto).

Mude a Visualização do terminal: ASCII, HEX, DEC, BIN ou Dump (offset + hex + texto). No Windows, Ctrl+E alterna entre as visualizações e Ctrl+T entre os carimbos de tempo. A visualização muda só a exibição; os bytes ficam guardados como chegaram.

Sim. O botão de timer da barra de envio manda a entrada atual em intervalos fixos até você parar. O botão de clipe envia um arquivo, em blocos binários ou linha por linha, com uma pausa entre as partes.

RX são os dados recebidos do aparelho e TX os que você enviou. As faixas finas nas bordas do terminal marcam onde houve RX (esquerda) e TX (direita); clique numa marca para ir até lá.

Um comando salvo num botão. Toque nele na barra de macros embaixo do terminal ou pressione F1–F12 no Windows. Shift+F1–F12 edita a macro.

Uma regra que confere cada pacote recebido contra um padrão de texto, hex (com curingas ??) ou regex. Quando bate, o LinkJig pode enviar uma resposta, marcar a linha no log, dar um bipe, salvar um snapshot ou parar um cenário em execução. Use gatilhos para responder a um aparelho automaticamente ou para simular um.

Um teste repetível. Cada passo envia uma mensagem, espera a resposta esperada dentro de um tempo limite e marca o passo como PASS ou FAIL. Você escolhe o que acontece numa falha (continuar, tentar de novo ou parar) e quantas voltas rodar. Salve o resultado como relatório de texto ou tabela CSV.

Sim. Monte-os no computador, compartilhe como pacote de projeto e importe no celular. O celular os executa e mostra o resultado de cada passo.

Um perfil guarda os ajustes de conexão e envio (e, se quiser, macros) de um aparelho. Um pacote de projeto junta perfis, macros, gatilhos, cenários e um log de exemplo opcional num único arquivo .ljpack para compartilhar com um colega ou levar para o celular.

Não. Importar só adiciona cenários, macros, gatilhos e perfis. Nada é enviado até você tocar em Executar ou Enviar.

O registro automático de sessões vem desligado; ative Salvar cada sessão no disco em Ajustes → Terminal. No Windows os logs vão para Documents\LinkJig\logs (snapshots de gatilhos em snapshots). No Android eles ficam dentro do app; na tela Logs, Salvar uma cópia… permite enviar um log ou guardá-lo em outro lugar. Você também pode salvar o terminal atual pelo menu dele a qualquer momento (Ctrl+Shift+S no Windows).

Não. Com Restaurar última sessão ligado (padrão), as últimas 2.000 linhas voltam na próxima abertura. O LinkJig nunca reconecta sozinho; ele pergunta antes.

No Android, sim, enquanto houver uma conexão ativa: o LinkJig mostra a notificação "Conexão ativa" para o sistema mantê-la rodando. Se você desligar as notificações, a conexão continua, mas a notificação fica oculta. Alguns fabricantes fecham apps em segundo plano de forma agressiva; se a conexão cair, permita que o LinkJig rode sem restrições de bateria.

A ferramenta é grátis e nunca mostra anúncios: nem no terminal, nos aparelhos, cenários, macros, gatilhos, logs, biblioteca, ajustes ou ajuda. No Android há um minijogo opcional, Start Bit (Ajustes → Ajuda); os anúncios aparecem só dentro dele. Você nunca precisa abri-lo. O app para desktop não tem jogo nem anúncios.

O Pro é grátis. No Android, vença a fase 15 do Start Bit ou assista a 10 anúncios curtos (no máximo 5 por dia), o que vier primeiro. Depois o Pro fica desbloqueado para sempre; o minijogo continua com anúncios e a ferramenta nunca mostra nenhum. Até lá, cenários e gatilhos podem ser testados por completo no aparelho Demo.

Desbloqueie o Pro no app Android e depois Ajustes → Pro → Desbloquear o app para desktop. Cada código pede 2 anúncios curtos e vale por 48 horas; digite no computador em Ajustes → Pro → Inserir código. O computador acessa a internet uma vez, só para conferir a hora.

Não, desde que o backup do Android esteja ativado na sua conta do Google. O Pro, os temas e o progresso do jogo ficam em um único arquivo criptografado, e só esse arquivo o LinkJig coloca no backup.

Cada capítulo do Start Bit que você termina desbloqueia um tema; você também pode desbloquear um tema com 3 anúncios curtos. Os temas mudam só as cores. O app para desktop tem a aparência padrão clara e escura.

Não. Não há conta, nem análise, nem servidor. Tudo o que você digita, recebe e salva fica no seu aparelho. O minijogo opcional Start Bit no Android recebe anúncios do Google AdMob, que nunca vê os dados do terminal. Veja a política de privacidade em Ajustes → Sobre.

Ajustes → Aparência → Idioma. Sistema segue o idioma do seu aparelho.

Ajustes → Ajuda → Copiar relatório de diagnóstico e cole na sua mensagem para linkjig.app@gmail.com. O relatório traz detalhes do app, do sistema e da conexão — nunca dados do terminal, números de série ou endereços.