ThreeByte.LinkLib.NetBooter 1.0.4

🔋 ThreeByte.LinkLib.NetBooter

Client library for controlling Synaccess NetBooter networked power controllers — toggle outlets, poll state, and monitor power remotely.

✨ Features

📦 Installation

dotnet add package ThreeByte.LinkLib.NetBooter

or via the NuGet Package Manager:

Install-Package ThreeByte.LinkLib.NetBooter

🚀 Quick Start

using ThreeByte.LinkLib.NetBooter;

// Connect to a NetBooter device
var netBooter = new NetBooterLink("192.168.1.10");

// Subscribe to errors
netBooter.ErrorOccurred += (s, ex) =>
    Console.WriteLine($"Error: {ex.Message}");

// Turn on outlet 1
netBooter.Power(outlet: 1, state: true);

// Turn off outlet 3
netBooter.Power(outlet: 3, state: false);

// Poll all outlet states from the device
netBooter.PollState();

// Check individual outlet states
bool outlet1 = netBooter[1];  // true = ON
bool outlet2 = netBooter[2];  // false = OFF
Console.WriteLine($"Outlet 1: {(outlet1 ? "ON" : "OFF")}");
Console.WriteLine($"Outlet 2: {(outlet2 ? "ON" : "OFF")}");

WPF / MVVM Data Binding

NetBooterLink implements INotifyPropertyChanged, making it easy to bind to UI:

<StackPanel DataContext="{Binding NetBooter}">
    <TextBlock Text="{Binding [1], StringFormat='Outlet 1: {0}'}" />
    <TextBlock Text="{Binding [2], StringFormat='Outlet 2: {0}'}" />
    <Button Content="Refresh" Command="{Binding PollCommand}" />
</StackPanel>

📖 API Reference

NetBooterLink

Constructor

NetBooterLink(string ipAddress)

Properties

Methods

Events

🏗️ Architecture

┌──────────────────────────────────────────────┐
│              NetBooterLink                    │
│                                              │
│  Power(outlet, state) ─────┐                 │
│                             ▼                │
│                  ┌─────────────────────┐     │
│                  │  HTTP Commands      │     │
│                  │                     │     │
│                  │  SET:  $A3 {o} {s}  │     │
│                  │  POLL: $A5          │     │
│                  └────────┬────────────┘     │
│                           │                  │
│                           ▼                  │
│                  ┌─────────────────────┐     │
│                  │  NetBooter Device   │     │
│                  │  http://{ip}/       │     │
│                  │  cmd.cgi            │     │
│                  └─────────────────────┘     │
│                           │                  │
│  PollState() ─────────────┘                  │
│       │                                      │
│       ▼                                      │
│  ┌─────────────────────────────────────────┐ │
│  │  Outlet State Dictionary                │ │
│  │  { 1: ON, 2: OFF, 3: ON, ... }         │ │
│  └─────────────────────────────────────────┘ │
│       │                                      │
│       ▼                                      │
│  PropertyChanged events → UI binding         │
└──────────────────────────────────────────────┘

🔧 How It Works

The library communicates with Synaccess NetBooter devices via their HTTP CGI interface:

State Response Format

The device returns a binary string where each bit (right-to-left) represents an outlet:

Response: "1101"
           ||||
           |||└─ Outlet 1: ON
           ||└── Outlet 2: OFF
           |└─── Outlet 3: ON
           └──── Outlet 4: ON

🎯 Platform Support

📄 License

Part of the ThreeByte.LinkLib family of communication libraries.