Manual de configuração — Fractum SL-01 (firmware V4.05)

Passo a passo para cadastro no SIGMAIS, uso do Fractum Manager (USB) e apontamento do gateway para o broker SmartSaving.

1 Registrar o Fractum no site (antes de programar)

O broker MQTT só aceita o equipamento depois que ele existir no SIGMAIS. Faça isso antes de gravar usuário/senha no logger.

  1. Anote o IMEI de 15 dígitos — está na caixa do Fractum e no rótulo do aparelho.
  2. Tire fotos da caixa, do rótulo com IMEI e do equipamento aberto (SIM, etc.) para controle interno / suporte.
  3. No SIGMAIS: Gerenciamento → Adicionar dispositivo.
  4. Tipo: fractum. Campo Tag/IMEI: cole o IMEI (ex.: 358833275411330).
O sistema cria automaticamente: usuário MQTT = IMEI, senha = {IMEI}123, ACL em fractum/{IMEI}/#.
Abrir cadastro de dispositivo Listar dispositivos

2 Baixar e instalar o Fractum Manager

Use o software oficial da Fractum para enviar comandos pela USB (recomendado no firmware V4.05, que exige TOKEN e desbloqueio serial).

Baixar Fractum Manager (GitBook)

  1. Baixe o instalador na página acima e instale no Windows.
  2. Abra o Fractum Manager.
  3. Em tipo de dispositivo, selecione CELULAR (SmartLogger SL-01 celular).

Referência de comandos: manual SL-01 Rev05 V4.05.

3 Conectar o hardware

  1. Insira o chip IoT (SIM) NB-IoT / Cat-M1 (ex.: Vivo M2M smart.m2m.vivo.com.br).
  2. Conecte o cabo USB ↔ UART no conector interno do Fractum.
  3. Ligue a bateria do Fractum (alimentação do modem).
  4. No Fractum Manager, clique em Detectar automaticamente e aguarde reconhecer a porta serial.
V4.05: comandos de configuração na USB exigem desbloqueio temporário (*UNLOCKCMD). Comandos remotos via MQTT continuam funcionando quando o equipamento já estiver na rede.

4 Enviar comandos (substitua <IMEI> e <TAG>)

Envie um comando por vez e aguarde resposta (Data saved successfully! ou linha com ;1; = OK). No V4.05 o comando *NET usa o formato completo (não use o formato curto antigo).

1 — Desbloquear USB por 30 minutos
*UNLOCKCMD;0000;0;30#
2 — APN Vivo M2M
*NET;0000;smart.m2m.vivo.com.br;vivo;vivo;1;5;3;0;0;134217748;0#
3 — Intervalo (ex.: coleta 15 min, envio 30 min). Para 1 min: use 1;1 no lugar de 15;2
*INTV;0000;15;2;0;1;1;0;0#
4 — Broker MQTT SmartSaving (usuário/senha = cadastro no site)
*MQTT;0000;mqtt.smartsaving.com.br;1883;<IMEI>;<IMEI>123;fractum_;0;1#
5 — Tópico de leituras
*TOPIC;0000;fractum/<IMEI>/readings;2;0#
6 — Tópico de configuração (base sem IMEI; o aparelho acrescenta o IMEI)
*TOPIC2;0000;fractum/config;2;1#
7 — TAG do cliente (máx. 11 caracteres)
*TAG;0000;<TAG>#
8 — Conferência
*INFO;0000# *INFOR;0000#

Resumo MQTT (gravado no equipamento)

ItemValor
Hostmqtt.smartsaving.com.br
Porta1883 (sem TLS)
Usuário<IMEI>
Senha<IMEI>123
Client IDfractum_<IMEI>
Leiturasfractum/<IMEI>/readings
Config (downlink)Publicar em fractum/config/<IMEI>/ (com / no final), QoS 2, retain

5 Validar no SIGMAIS

  • *INFO;0000# — operadora (OP:), RSSI, intervalos de coleta/envio.
  • *INFOR;0000# — endereço MQTT, usuário, tópicos.
  • Em Fractum Config, o gateway deve sair de “Sem dados” quando chegar o primeiro pacote *SL01.
Abrir Fractum Config

6 Ajustes remotos (opcional)

Com o equipamento já na rede celular, dá para reconfigurar pelo broker sem USB:

  • Tópico: fractum/config/<IMEI>/
  • QoS 2, retain true
  • Payload V4.05 (mesmo formato da USB): ex. 2 min → *INTV;0000;2;1;0;1;1;0;0#; 1 min → *INTV;0000;1;1;0;1;1;0;0#.
  • Payload VFW 2.04: *INTV;2;1;0;1# (cinco campos, sem 0000).
  • O gateway lê o retain no próximo ciclo de envio; confirme com COLETA/ENVIO no *INFO ou intervalo nos pacotes *SL01.

Documentação interna complementar: docs/fractum-sl03-config.md no repositório SIGMAIS.