Oakrey.Acroname 3.0.0

Oakrey.Acroname

Managed .NET wrapper around the Acroname BrainStem2 native SDK. Enables .NET 11 applications to control the Acroname USBCSwitch over USB � port switching, mux selection, and real-time voltage and current measurement � without writing any native or C++/CLI code directly.

Main features

• Control the USB-C port on the Acroname USBCSwitch (enable / disable).
• Enable, disable, and select any of the four USB-C mux channels (Ch0-Ch3).
• Query which mux channel is currently active.
• Read port voltage and current (returned in volts / amperes).
• Read per-channel voltage.
• Connect to a specific device by serial number or to the first discovered device.
• Structured error reporting via AcronameException with a numeric BrainStem2 error code.
• Bundled native binaries � BrainStem2.dll, Ijwhost.dll, and Oakrey.Acroname.Wrapper.dll are copied to the output directory automatically; no manual deployment step required.

Architecture

graph TD
    A[Consumer .NET application] --> B[Oakrey.Acroname<br>net11.0 managed library]
    B --> C[Oakrey.Acroname.Wrapper.dll <br> C++/CLI mixed-mode assembly]
    C --> D[BrainStem2.dll <br> Acroname native SDK]
    C --> E[Ijwhost.dll <br> IJW hosting shim]

Each operation follows an implicit connect / call / disconnect cycle inside the C++/CLI layer. The USBCSwitch class is IDisposable; disposing it disconnects from the device.

Key types

The Oakrey.Acroname.Devices package builds a higher-level abstraction on top of this library.

Requirements

• .NET 11 or higher
• Windows x64 (native DLLs are x64-only)
• No additional runtime installation required; native binaries are bundled in the NuGet package

Installation

.NET CLI

dotnet add package Oakrey.Acroname

Package Manager Console

Install-Package Oakrey.Acroname

NuGet Package Manager

Search for Oakrey.Acroname in Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

Example usage

using Oakrey.Acroname.Wrapper;

// Connect to the first discovered USBCSwitch
using USBCSwitch sw = new USBCSwitch();

// Enable the USB-C port and select mux channel 2
sw.PortEnable();
sw.MuxEnable();
sw.MuxSelect(Channel.Ch2);

// Read telemetry
double voltage = sw.GetPortVoltage();   // volts
double current = sw.GetPortCurrent();   // amperes
double ch2Voltage = sw.GetChannelVoltage(Channel.Ch2);

Console.WriteLine($"Port: {voltage:F3} V  {current:F3} A");
Console.WriteLine($"Ch2:  {ch2Voltage:F3} V");

// Connect to a specific device by serial number
using USBCSwitch swById = new USBCSwitch(0x12345678);

Error handling

All BrainStem2 errors are translated to AcronameException. The ErrorCode property contains the raw aErr integer from the native SDK.

try
{
    sw.MuxSelect(Channel.Ch0);
}
catch (AcronameException ex)
{
    Console.WriteLine($"BrainStem2 error {ex.ErrorCode}: {ex.Message}");
}

Common error codes:

Development notes

• The C++/CLI wrapper (Acroname.Wrapper\main.cpp) connects, executes a single command, and disconnects on every call. This is intentional � the Acroname SDK is stateless between calls.
• Ijwhost.dll is the IJW (It Just Works) hosting shim required by .NET Core for mixed-mode C++/CLI assemblies. It must be present alongside Oakrey.Acroname.Wrapper.dll at runtime.
• All three native DLLs are included in the NuGet package under lib\net11.0 and are configured with PackageCopyToOutput="true" so they land in the consuming project's output directory without any manual configuration.

License

MIT - Copyright (c) Oakrey 2016-present

License

This project is licensed under the MIT License. See the LICENSE file for details.