pump-sim
codeGitHub
v1.0 · open source · MIT

Simule o concentrador. Teste a pista sem ir ao posto.

pump-sim é um simulador open source dos concentradores Companytec (CBC, Horustech, Concept e Identfid), fiel ao SimuladorCBC 2.7.2, com API de controle, servidor MCP e console de tráfego para devs e agentes de IA.

downloadBaixar para Windows terminalInstalar pela CLI open_in_newGitHub
verified pump-sim-win-x64.exe · ainda sem assinatura · SHA-256 no releasemacOS e Linux: Node 22+
Teste em uma linha $printf '(&S)' | nc 127.0.0.1 2001
Canal 1 · perfil simulador-2.7.2 · 127.0.0.1:2001
A interface

A pista do 2.7.2, com o que faltava.

Os painéis do SimuladorCBC, mais tráfego ao vivo, gravação e diff. Roda no navegador com --ui ou numa janela própria no Windows.

swipeArraste para ver a pista inteira
Recursos

Feito para quem integra bomba.

lan

Protocolos e perfis

Companytec (&…), Identfid (?…) com os 14 modos de identificação e Horustech >? nativo. Os perfis são dados, não código.

simulador-2.7.2cbc-32cbc05-dip3cbc01horustech-cbc-36horustech-48concept-48

simulador-2.7.2 medido contra o SimuladorCBC 2.7.2 real.

Os outros seis segundo o manual, não validado em hardware (DT435, DT432, DT277).

rule

Paridade com o 2.7.2, medida

Cada caso manda o quadro exato a um SimuladorCBC 2.7.2 numa bancada Windows real e compara a resposta byte a byte. Os bugs dele viram quirks, ligados só no perfil simulador-2.7.2.

pump-sim diff --a <bancada>:2001
smart_toy

Pronto para agentes

API HTTP de controle só em loopback e servidor MCP stdio com o mesmo catálogo de comandos. O relógio manual deixa o CI do seu cliente determinístico.

POST /api/comandos/<comando>
terminal

Console de tráfego e injeção de falhas

Cada leitura e escrita do socket, por porta e conexão. Injete uma falha e veja o seu software reagir.

sem_respostaatraso 800 msframe_corrompidotruncado
history

Gravar, reproduzir, comparar

Grave o tráfego em JSONL, reproduza como concentrador ou como cliente, e rode o teste diferencial contra um alvo real.

--record trafego.jsonl pump-sim replay servidor trafego.jsonl pump-sim diff --a <alvo>:2001
Início rápido

Um comando.

macOS ou Linux com Node 22+: um npx e a interface abre. No Windows, o .exe dispensa o Node: dois cliques. Para mexer no código, use a opção do código-fonte.

1
Rodar com npx (Mac/Linux, Node 22+)
$npx pump-sim --profile simulador-2.7.2 --ui
Depois, aponte o PDV ou a automação para 127.0.0.1:2001. printf '(&S)' | nc 127.0.0.1 2001
Para agentes

Seu agente dirige a pista.

pump-sim mcp expõe o catálogo de comandos como ferramentas MCP. Cada chamada vira um POST na API de controle: o agente abastece, apresenta cartão, injeta falha, avança o relógio e lê o estado.

Algumas ferramentas
gerar_abastecimentosapresentar_cartaoinjetar_falhaavancar_temposet_perfilstart_recording
shieldA API não tem autenticação e só escuta em 127.0.0.1.
data_objectmcp.json

            

            
Antes, suba o simulador com a API:$ pump-sim --profile cbc-32 --control 7070