FeasaLedAnalyser 0.1.0

FeasaLedAnalyser

A .NET library for reading measurements from Feasa LED analysers over their USB-serial interface — RGBI, HSI, xy/xyi chromaticity, CCT, CIE XYZ, wavelength, intensity, and more — parsed into typed objects instead of raw strings.

Node.js and Python ports are planned; this repo currently ships the .NET package.

Install

dotnet add package FeasaLedAnalyser

Usage

Auto-detect the analyser's COM port

using FeasaLedAnalyser;

var client = new FeasaClient(); // same as new FeasaClient("auto", 57600)
client.OnLog += Console.WriteLine;

if (await client.ConnectAsync())
{
    await client.CaptureAsync();

    var rgbi = await client.GetRgbiAsync();
    foreach (var reading in rgbi)
        Console.WriteLine(reading); // Fiber 1: R=45 G=132 B=77 I=55

    var cct = await client.GetCctAsync();
    var cieXyz = await client.GetCieXyzAsync();

    client.Disconnect();
}

Connect to a known port manually

var client = new FeasaClient("COM7", 57600);
await client.ConnectAsync();

Both forms take the port (or "auto") and baud rate in the constructor; ConnectAsync() uses whatever was configured there. Pass a port name to ConnectAsync("COM3") instead if you need to override it after construction (e.g. from a UI dropdown).

Reading everything at once

var snapshot = await client.GetAllReadingsAsync();
// snapshot.Rgbi, snapshot.Cct, snapshot.CieXyz, etc.

Supported measurements

Every reading also carries FiberNumber and Raw (the untouched line from the device, for debugging).

Wire format note

Confirmed against a real analyser: responses are one space-separated line per fiber, fiber number first — e.g. 01 045 132 077 00055 for an RGBI reply. Fiber-looped commands (CIEXYZ, Absint — one command sent per fiber, e.g. getCIEXYZ03) don't repeat the fiber number in the response; it's tracked from the command that was sent. If your firmware/model differs, the fix is isolated to FeasaResponseParser.cs; nothing else in the library depends on the exact format.

Testing

dotnet test tests/FeasaLedAnalyser.Tests/FeasaLedAnalyser.Tests.csproj

The test suite checks FeasaResponseParser against real output captured from an actual analyser — no hardware needed to run it.

Protocol

Built from publicly available Feasa serial command documentation. Not an official Feasa library — command behavior may vary by device/firmware revision.

License

MIT