lukaskirner / tokio-sunspec

A tokio-based SunSpec library

tokio-sunspec

A pure Rust SunSpec library based on tokio.

Features

• Pure Rust library
• Non-blocking
• TCP Client
• RTU Client
• Model discovery
• Type safe SunSpec models
• Repeating models

Installation

[dependencies]
tokio-sunspec = "*"

Examples

The src/models/ folder contains all pre generated models which may be available by the device. If you need to add your own model you can generate one with included Python script in the scripts folder.

TCP Connect example for SMA Inverter

let socket_addr = "<ip-address>:502".parse().unwrap();
let device_id: u8 = 126;
let start_addr: u16 = 40000;

let mut client = tokio_sunspec::connect_tcp(socket_addr, device_id, start_addr).await?;

let res = client.read_point(model1::Mn).await?;
assert_eq!(res, "SMA");

Protocol-Specification

• SunSpec Information Model Specification (PDF)

Fruther notice

This lib only implements the SunSpec part. The connection via modbus is done by the tokio-modbus lib.

License

Copyright (c) 2023 Lukas Kirner

Apache-2.0