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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OpenAC.Net.Balanca" Version="1.7.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="OpenAC.Net.Balanca" Version="1.7.0" />
                    
Directory.Packages.props
<PackageReference Include="OpenAC.Net.Balanca" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add OpenAC.Net.Balanca --version 1.7.0
                    
#r "nuget: OpenAC.Net.Balanca, 1.7.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package OpenAC.Net.Balanca@1.7.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=OpenAC.Net.Balanca&version=1.7.0
                    
Install as a Cake Addin
#tool nuget:?package=OpenAC.Net.Balanca&version=1.7.0
                    
Install as a Cake Tool

OpenAC.Net.Balanca

NuGet Version NuGet Downloads Discord License: MIT Target Frameworks Target Frameworks

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 por OpenBal<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:

  1. Faça um Fork do repositório.
  2. Crie uma Branch para a sua feature (git checkout -b feature/novo-protocolo).
  3. Faça o commit das suas alterações (git commit -m 'Adiciona suporte a novo protocolo').
  4. Envie para o GitHub (git push origin feature/novo-protocolo).
  5. 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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