Usn.Pb1151.DeviceKit 1.1.2

Usn.Pb1151.DeviceKit

A C# Serial/BLE interface library for the PB1151 microcontroller, developed for the PB1151 – Objektorientert programmering og databaser course at USN.

The library communicates with the microcontroller board (4 LEDs, 1 servo, 3 pushbuttons, a TMP102 temperature sensor, and an ADXL345 accelerometer) over a line-based JSON protocol, connected via either a USB serial port or Bluetooth Low Energy (Nordic UART Service). It is consumed as an object-oriented API — setting properties and subscribing to events — without direct handling of JSON or the underlying port.

The firmware for the kit and its interface description are available at PB1151vSnippets/Firmware/Micropython/jsonSerialAndBLE.

Install

dotnet add package Usn.Pb1151.DeviceKit

Requires .NET 10 on Windows (the BLE transport uses the Windows Runtime Bluetooth APIs).

Quick start

using System.Diagnostics;
using Usn.Pb1151.DeviceKit;

// Connect over USB serial...
var port = new SerialPortEx { PortName = "COM3", BaudRate = 9600 };
port.Open();
var controller = new JsonSerialController(port);

// ...or over BLE instead — same controller API either way.
// var ble = new BleNusEx("Pico-NUS");
// await ble.ConnectAsync(TimeSpan.FromSeconds(15));
// var controller = new JsonSerialController(ble);

// Turn LED1 on
controller.LedControl["LED1"].Value = 1;

// Move servo SV1 to 90 degrees
controller.ServoControl["SV1"].Angle = 90;

// React to a pushbutton
controller.ButtonControl["SW1"].ValueChanged += (s, e) =>
    Debug.WriteLine($"{e.Id} = {e.Value}");

Usage

using System.Diagnostics;
using Usn.Pb1151.DeviceKit;

// SerialPortEx implements ISerialDataReadWrite; a plain SerialPort does not.
var port = new SerialPortEx { PortName = "COM3", BaudRate = 9600 };
port.Open();
var controller = new JsonSerialController(port);

// Outgoing: turn LED1 on
controller.LedControl["LED1"].Value = 1;

// Outgoing: move SV1 to 90 degrees, then let it go slack
controller.ServoControl["SV1"].Angle = 90;
controller.ServoControl.Release("SV1");

// Incoming: react to SW1
controller.ButtonControl["SW1"].ValueChanged += (s, e) =>
{
    Debug.WriteLine($"{e.Id} = {e.Value}");
};

// Sensors: react to readings, then request them
controller.SensorControl["TEMP1"].DataChanged += (s, e) =>
{
    var temp = (TempSensor)e.Sensor;
    Debug.WriteLine($"{temp.Id}: {temp.Value} {temp.Unit}");
};
controller.SensorControl["ACC1"].DataChanged += (s, e) =>
{
    var acc = (AccSensor)e.Sensor;
    Debug.WriteLine($"{acc.Id}: x={acc.X} y={acc.Y} z={acc.Z} {acc.Unit}");
};
controller.SensorControl.SensorError += (s, e) =>
{
    Debug.WriteLine($"{e.Id} error: {e.Error}");
};

controller.SensorControl.Read("TEMP1");          // one-shot read
controller.SensorControl.StartStream("ACC1", 50); // stream every 50 ms
controller.SensorControl.StopStream("ACC1");      // stop the stream

BleNusEx implements ISerialDataReadWrite too, so it drops in unchanged:

var ble = new BleNusEx("Pico-NUS");
await ble.ConnectAsync(TimeSpan.FromSeconds(15));
var controller = new JsonSerialController(ble);

Library contents

Documentation

Full API reference, JSON wire protocol, and sequence diagrams: JsonSerialController.md

Example project

A complete Windows Forms demo that consumes this library lives in the parent repository (SerialLedBtnLibEx) — see its README.md for a walkthrough of wiring the controller up to a GUI.