OpenAC.Net.Balanca
1.7.0
Prefix Reserved
dotnet add package OpenAC.Net.Balanca --version 1.7.0
NuGet\Install-Package OpenAC.Net.Balanca -Version 1.7.0
<PackageReference Include="OpenAC.Net.Balanca" Version="1.7.0" />
<PackageVersion Include="OpenAC.Net.Balanca" Version="1.7.0" />
<PackageReference Include="OpenAC.Net.Balanca" />
paket add OpenAC.Net.Balanca --version 1.7.0
#r "nuget: OpenAC.Net.Balanca, 1.7.0"
#:package OpenAC.Net.Balanca@1.7.0
#addin nuget:?package=OpenAC.Net.Balanca&version=1.7.0
#tool nuget:?package=OpenAC.Net.Balanca&version=1.7.0
OpenAC.Net.Balanca
Biblioteca .NET multiplataforma para comunicação e leitura de balanças, com suporte a diferentes fabricantes e protocolos de pesagem.
Desenvolvida pelo time OpenAC .Net, a biblioteca utiliza o OpenAC.Net.Devices para comunicação com os equipamentos e tem os protocolos do ACBrBAL como referência.
🚀 Funcionalidades
- Leitura de Peso: solicitação de pesagem e interpretação dos retornos do equipamento.
- Múltiplos Protocolos: 38 modelos específicos e um protocolo genérico configurável.
- Comunicação Serial e TCP: configuração pelo
OpenAC.Net.Devices, com acesso fortemente tipado porOpenBal<TConfig>. - Monitoramento Contínuo: acompanhamento das transmissões espontâneas da balança pelo evento
AoLerPeso. - Estados de Pesagem: identificação de instabilidade, peso negativo, sobrecarga e outros estados específicos de cada modelo.
- Tratamento dos Retornos: leitura de quadros fragmentados, timeout configurável e conversão decimal independente da cultura.
- Demo Multiplataforma: interface Avalonia com configurações, simulador sem hardware e histórico das respostas.
- Testes Automatizados: TUnit para protocolos, comunicação e ciclo de conexão, além de testes headless da interface.
🏛️ Protocolos Suportados
A biblioteca abstrai os formatos de solicitação e resposta dos seguintes modelos:
| Fabricante / família | Protocolos |
|---|---|
| Toledo | Toledo, Toledo2090, Toledo2090N, Toledo2180, ToledoBCS21, Toledo9091_8530_8540, ToledoTi420 |
| Filizola | Filizola |
| Urano | Urano, UranoPOP, UranoUDC |
| Weightech | WeightechWT1000, WeightechWT3000_ABS, WeightechWT3000IR_ABS, WeightechWT27R_ETH |
| Libratek | Libratek, LibratekWT3000IR |
| Digitron | Digitron, Digitron_UL |
| Outros modelos | AFTS, Alfa, Capital, LenkeLK2500, Lider, LucasTec, Magellan, Magna, MarelCG62XL, Marte, Micheletti, Muller, Precision, Ramuza, Rinnert, Saturno, Siciliano, Trentin, WeighTRUTest |
| Genérica | Extração do campo de peso por posição inicial e tamanho |
Consulte a matriz de protocolos para comandos, formatos, estados e particularidades de cada modelo. O protocolo e os parâmetros de comunicação devem corresponder ao modo configurado no equipamento.
📦 Instalação
Adicione o pacote via NuGet Package Manager ou CLI:
.NET CLI:
dotnet add package OpenAC.Net.Balanca
Package Manager Console:
Install-Package OpenAC.Net.Balanca
PackageReference:
<PackageReference Include="OpenAC.Net.Balanca" Version="1.6.0.1" />
🛠️ Como Usar
1. Inicializando e Configurando o Componente
using System;
using System.IO.Ports;
using OpenAC.Net.Balanca;
using OpenAC.Net.Devices;
using var balanca = new OpenBal<SerialConfig>(new SerialConfig
{
Porta = "COM1", // No Linux, por exemplo: /dev/ttyUSB0
Baud = 9600,
DataBits = 8,
Parity = Parity.None,
StopBits = StopBits.One,
Handshake = Handshake.None,
TimeOut = 3000 // Milissegundos
});
balanca.Protocolo = ProtocoloBalanca.Toledo;
balanca.DelayMonitoramento = 200;
A biblioteca suporta .NET Framework 4.6.2 e 4.8, .NET Standard 2.0 e .NET 8, 9 e 10. Os exemplos usam sintaxe moderna de C#.
2. Lendo o Peso e Tratando os Retornos
balanca.AoLerPeso += (_, leitura) =>
{
if (leitura.Excecao != null)
{
Console.WriteLine($"Falha de leitura: {leitura.Excecao.Message}");
return;
}
Console.WriteLine($"Peso/estado: {leitura.Peso}");
Console.WriteLine($"Resposta bruta: {leitura.Leitura}");
};
balanca.Conectar();
var peso = balanca.LerPeso();
balanca.Desconectar();
Falhas de comunicação são informadas em BalancaEventArgs.Excecao, com Peso nulo; LerPeso() retorna -9. Chamadas sem conexão ativa lançam uma exceção.
Os valores negativos também podem representar estados específicos do protocolo:
| Valor | Significado |
|---|---|
-1 |
Peso instável |
-2 |
Peso negativo / subcarga |
-9 |
Falha de comunicação / timeout |
-10 |
Sobrecarga |
-11 |
Captura inicial de zero |
-12 |
Erro de calibração |
Alguns modelos possuem convenções próprias: o Toledo2090, por exemplo, pode retornar o peso com sinal negativo. Consulte a matriz antes de tratar o retorno como peso em quilogramas.
3. Monitorando Transmissões Contínuas
balanca.Protocolo = ProtocoloBalanca.Lider;
balanca.DelayMonitoramento = 200;
balanca.IsMonitorar = true;
balanca.Conectar();
// O evento AoLerPeso recebe as leituras enquanto a conexão estiver ativa.
// Para interromper o monitoramento:
balanca.IsMonitorar = false;
balanca.Desconectar();
O monitor acompanha equipamentos que transmitem espontaneamente. Para modelos que dependem de solicitação, utilize LerPeso(). No monitoramento, o evento é disparado em uma thread de trabalho; em aplicações gráficas, encaminhe a atualização para a thread da interface.
4. Configurando uma Conexão TCP
using var balancaTcp = new OpenBal<TCPConfig>(new TCPConfig("192.168.0.100", 9000)
{
TimeOut = 3000
});
balancaTcp.Protocolo = ProtocoloBalanca.WeightechWT27R_ETH;
balancaTcp.Conectar();
var pesoTcp = balancaTcp.LerPeso();
balancaTcp.Desconectar();
O endereço, a porta e o protocolo dependem da configuração do equipamento.
5. Interpretando Respostas sem Equipamento
using var simulador = new OpenBal<SerialConfig>
{
Protocolo = ProtocoloBalanca.Toledo
};
// STX + peso + ETX: retorna 1,234 kg.
var pesoSimulado = simulador.InterpretarRespostaPeso("\u000201234\u0003");
// Protocolo genérico: posição inicial baseada em 1 e quantidade de caracteres.
simulador.Protocolo = ProtocoloBalanca.Generica;
simulador.PosicaoInicial = 3;
simulador.TamanhoResposta = 6;
var pesoGenerico = simulador.InterpretarRespostaPeso("PB012345kg"); // 12,345 kg
InterpretarRespostaPeso() não abre o dispositivo. A extração por posição e tamanho também é utilizada pelo protocolo Marte.
🖥️ Aplicação de Demonstração
O demo utiliza Avalonia e .NET 8, seguindo o padrão visual do NFSe Nacional, e oferece:
- Configuração dos protocolos e das conexões serial/TCP.
- Leitura manual e monitoramento das transmissões contínuas.
- Simulador de respostas sem equipamento conectado.
- Histórico de peso, estados e retornos brutos.
- Persistência das configurações no diretório de dados do usuário.
Execute a partir da raiz do repositório:
cd src
dotnet run --project OpenAC.Net.Balanca.Demo
Consulte o README do demo para mais detalhes.
🧪 Compilação e Testes
Para compilar a solução completa, utilize o .NET SDK 10, com os SDKs/runtimes correspondentes aos alvos executados.
cd src
dotnet restore OpenAC.Net.Balanca.sln
dotnet build OpenAC.Net.Balanca.sln -c Release
dotnet test --solution OpenAC.Net.Balanca.sln -c Release --no-build
Os testes utilizam TUnit e Microsoft.Testing.Platform:
- OpenAC.Net.Balanca.Test: interpretação de todos os protocolos em diferentes culturas, comandos, estados, fragmentação, estabilização, timeout, eventos e reconexão.
- OpenAC.Net.Balanca.Demo.Test: validação headless da janela Avalonia, seleção de transporte e simulação de retornos.
Os testes não acessam balanças físicas. A comunicação deve ser homologada com o equipamento e seu modo de transmissão.
🤝 Como Contribuir
Contribuições são muito bem-vindas! Para relatar um problema, sugerir melhorias ou enviar uma contribuição:
- Faça um Fork do repositório.
- Crie uma Branch para a sua feature (
git checkout -b feature/novo-protocolo). - Faça o commit das suas alterações (
git commit -m 'Adiciona suporte a novo protocolo'). - Envie para o GitHub (
git push origin feature/novo-protocolo). - Abra um Pull Request.
Ao contribuir com um protocolo, inclua exemplos dos comandos e retornos e testes que cubram peso e estados do modelo.
💖 Ajude o Projeto OpenAC .Net
Se o OpenAC.Net.Balanca é útil para o seu negócio ou projeto open source e você deseja apoiar o desenvolvimento contínuo, considere fazer uma contribuição:
- Participe da nossa comunidade no Discord.
- Contribua com código, testes e documentação no GitHub.
- Apoie o projeto pelo Padrim ou Apoia.se.
🙏 Agradecimentos
Agradecimento especial aos projetos:
- Gerene.Balanca, pela doação do componente original.
- brainiac, como referência para comunicação serial em C#.
- ACBr, como referência dos protocolos de balanças.
📄 Licença
Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 is compatible. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
-
.NETFramework 4.8
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
-
.NETStandard 2.0
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
-
net10.0
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
-
net8.0
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
-
net9.0
- OpenAC.Net.Core (>= 1.6.0)
- OpenAC.Net.Devices (>= 1.7.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.7.0 | 114 | 10/28/2026 |
| 1.6.0.1 | 474 | 6/22/2025 |
| 1.5.0.1 | 3,243 | 8/20/2022 |
| 1.5.0 | 312 | 4/24/2022 |
| 1.5.0-preview.4 | 302 | 4/6/2022 |
| 1.5.0-preview.2 | 293 | 4/5/2022 |
| 1.5.0-preview.1 | 295 | 3/29/2022 |
| 1.1.0-preview.1 | 305 | 3/24/2022 |
| 1.0.0.2 | 623 | 9/30/2021 |
| 1.0.0.1 | 491 | 9/30/2021 |
| 1.0.0 | 559 | 9/20/2021 |