O padrão do artigo
Os recursos que deixam um artigo didático. No editor, cada um é um botão; aqui está o que ele produz — e, para quem prefere escrever o arquivo à mão, a sintaxe.
Resumo rápido
O artigo inteiro em quatro linhas, no alto. Quem só tem um minuto lê isto e sabe se vale seguir.
Sintaxe
:::resumo Vamos ler a temperatura de um inversor pela rede e mostrar no celular: - conectar o inversor na rede Modbus TCP - achar o registrador certo no manual - ler o valor a cada 2 segundos :::
O que você vai aprender
A promessa do artigo, em uma ou duas frases. Vem logo depois do resumo.
Sintaxe
:::aprender A achar qualquer dado de um equipamento Modbus sem software do fabricante — do manual ao número na tela. :::
Dica
O atalho que quem já fez conhece. Título opcional depois do tipo.
Sintaxe
:::dica Comece só lendo. Escrever no equipamento fica para depois que a leitura estiver certa. :::
Atenção
O que costuma dar errado se o leitor pular.
Sintaxe
:::atencao Confira se o endereço no manual começa em 0 ou em 1. Metade dos erros de leitura é isso. :::
Cuidado
Risco de verdade: choque, máquina em movimento, perda de dado, equipamento queimado.
Sintaxe
:::perigo Máquina energizada Nunca escreva num registrador de comando com a máquina em operação sem saber o que ele aciona. :::
Nota
Uma observação que ajuda, mas que o texto não precisa para seguir.
Sintaxe
:::nota 2 segundos é um bom equilíbrio entre atualização e carga na rede. :::
Curiosidade
A história por trás. Deixa o texto humano sem atrapalhar quem quer só o passo.
Sintaxe
:::curiosidade O Modbus foi publicado pela Modicon em 1979 e continua sendo o protocolo mais usado na indústria. :::
Nota de margem
Um comentário curto, ao lado do raciocínio — o que você diria em voz baixa.
Sintaxe
:::margem Se o equipamento for antigo, ele provavelmente só fala RS-485. Um conversor resolve. :::
Roteiro
O caminho do artigo em etapas, antes de começar. Uma etapa por linha: título — descrição.
Sintaxe
:::roteiro - Preparar a rede — cabo, IP fixo e um teste de ping - Achar o registrador — o mapa de memória do manual - Ler o valor — com um programa gratuito, antes do app :::
O roteiro
- Preparar a rede cabo, IP fixo e um teste de ping
- Achar o registrador o mapa de memória do manual
- Ler o valor com um programa gratuito, antes do app
Passo a passo
Passos que o leitor marca conforme faz. O contador sobe sozinho, sem nada instalado.
Sintaxe
:::passos - Ligar o inversor na rede — cabo direto no switch - Configurar o IP — parâmetro de comunicação no painel - Testar a leitura — registrador 40001 no programa de teste :::
Passo a passo
Checklist
O que o leitor tem nas mãos no fim. Bom para fechar o artigo.
Sintaxe
:::checklist O que você conquistou - Inversor respondendo na rede - Temperatura lida a cada 2 segundos :::
O que você conquistou
- Inversor respondendo na rede
- Temperatura lida a cada 2 segundos
Armadilhas
Os erros que quase todo mundo comete. Cada um com título, o que acontece e como evitar.
Sintaxe
:::armadilhas Top 3 armadilhas ### A leitura volta sempre zero O endereço está deslocado em uma posição. Como evitar: some ou tire 1 do endereço do manual e teste de novo. ### O equipamento não responde O ID do escravo não bate. Como evitar: confira o parâmetro de ID no painel — o padrão costuma ser 1. :::
Top 3 armadilhas
2 itensA leitura volta sempre zero
O endereço está deslocado em uma posição.
Como evitar some ou tire 1 do endereço do manual e teste de novo.
O equipamento não responde
O ID do escravo não bate.
Como evitar confira o parâmetro de ID no painel — o padrão costuma ser 1.
Prós e contras
Os dois lados de uma escolha. + para o que é a favor, - para o que é contra.
Sintaxe
:::proscontras Modbus RTU + Barato e simples + Quase todo equipamento fala - Lento para muitos pontos - Não diz o que cada registrador é :::
A favor Modbus RTU
- Barato e simples
- Quase todo equipamento fala
Contra Modbus RTU
- Lento para muitos pontos
- Não diz o que cada registrador é
Antes e depois
Duas imagens lado a lado: como estava e como ficou.
Sintaxe
:::antesdepois antes: painel-antes.jpg | O painel com fiação solta depois: painel-depois.jpg | O mesmo painel organizado em canaletas :::
Fórmula
A conta, escrita direito, com o que cada letra significa e um exemplo resolvido. A expressão vai entre $$.
Sintaxe
:::formula Escala de um sinal 4–20 mA
$$ V = \frac{(I - 4)}{16} \cdot (V_{max} - V_{min}) + V_{min} $$
Onde:
- `I` — a corrente medida, em mA
- `V_max` e `V_min` — o fundo e o começo da escala
= Com 12 mA numa escala de 0 a 500 °C: **V = 250 °C**
:::Fórmula · Escala de um sinal 4–20 mA
Onde:
I— a corrente medida, em mAV_maxeV_min— o fundo e o começo da escala
Com 12 mA numa escala de 0 a 500 °C: V = 250 °C
Árvore de pastas
Estrutura de pastas ou de projeto. Dois espaços por nível; pasta termina em /; comentário depois de //; * no fim destaca.
Sintaxe
:::arvore projeto-clp programa/ principal.st // a lógica * alarmes.st configuracao/ rede.xml // IP e ID :::
- programa/
- principal.sta lógica
- alarmes.st
- configuracao/
- rede.xmlIP e ID
Frase em destaque
Uma frase que resume o artigo. Pode ter uma imagem de fundo e a autoria.
Sintaxe
:::frase A melhor manutenção é a que você não precisou fazer. — ditado de chão de fábrica :::
A melhor manutenção é a que você não precisou fazer.
Quiz
Três a cinco perguntas no fim — a marca do Instituto. ? é a pergunta, + a resposta certa, - as erradas, > a explicação.
Sintaxe
:::quiz ? Em que endereço começa a área de holding registers no Modbus? - 00001 + 40001 - 30001 > Holding registers são a faixa 4xxxx; 3xxxx são os input registers, só de leitura. :::
Teste o que ficou
Isso.Não é essa. Holding registers são a faixa 4xxxx; 3xxxx são os input registers, só de leitura.
Recursos e links
Para onde ir depois: manual, norma, ferramenta. Um link por linha.
Sintaxe
:::recursos - [Especificação do protocolo Modbus](https://modbus.org/specs.php) :::
Nota do autor
Em que equipamento você testou, o que ficou de fora, como falar com você.
Sintaxe
:::notadoautor Testei em um inversor com firmware 2.1. Em versões anteriores o mapa de memória muda. :::
Código
Programa, configuração, trecho de ST. A linguagem vai depois das três crases; o leitor ganha o botão Copiar.
Sintaxe
```st Liga a bomba IF nivel < 20.0 THEN bomba := TRUE; END_IF; ```
IF nivel < 20.0 THEN
bomba := TRUE;
END_IF;Terminal
O que se digita e o que aparece. Linha com $ é comando; o resto é a saída.
Sintaxe
```terminal ping no CLP $ ping 192.168.0.10 Resposta de 192.168.0.10: tempo=2ms ✓ o CLP está na rede ```
$ ping 192.168.0.10 Resposta de 192.168.0.10: tempo=2ms ✓ o CLP está na rede
Tabela
Comparação lado a lado. (sim), (não) e (parcial) viram marca colorida.
Sintaxe
| | Modbus RTU | Modbus TCP | |---|---|---| | Meio | RS-485 | Ethernet | | Precisa de IP | (não) | (sim) | | Vários mestres | (não) | (parcial) |
| Modbus RTU | Modbus TCP | |
|---|---|---|
| Meio | RS-485 | Ethernet |
| Precisa de IP | Não | Sim |
| Vários mestres | Não | Parcial |
Na linha do texto
Tecla entre colchetes duplos; termo explicado entre chaves duplas, com a definição depois da barra; negrito, itálico, código e link como no markdown.
Sintaxe
Aperte [[Ctrl]] + [[S]] para salvar. O {{CLP|controlador lógico programável}} lê as entradas a cada **ciclo de varredura**.Aperte Ctrl + S para salvar. O CLPcontrolador lógico programável lê as entradas a cada ciclo de varredura.