Firmware for the Sinara 8451 Thermostat

• Continuous Integration
• Download latest firmware build

Building

Debian-based systems (tested on Ubuntu 19.10)

• install git, clone this repository
• install rustup

rustup toolchain install nightly
rustup update
rustup target add thumbv7em-none-eabihf --toolchain nightly
rustup default nightly
cargo build --release

The resulting ELF file will be located under target/thumbv7em-none-eabihf/release/thermostat

Network

Connecting

Ethernet, IP: 192.168.1.26/24

Use netcat to connect to port 23/tcp (telnet)

nc -vv 192.168.1.26 23

telnet clients send binary data after connect. Enter \n once to invalidate the first line of input.

Reading ADC input

Set report mode to on for a continuous stream of input data.

The scope of this setting is per TCP session.

Commands

Syntax	Function
report	Show current input
report mode	Show current report mode
report mode <off/on>	Set report mode
pwm	Show current PWM settings
pwm <0/1> max_i_pos <ratio>	Set PWM duty cycle for max_i_pos to ampere
pwm <0/1> max_i_neg <ratio>	Set PWM duty cycle for max_i_neg to ampere
pwm <0/1> max_v <ratio>	Set PWM duty cycle for max_v to volt
pwm <0/1> <volts>	Disengage PID, set i_set DAC to ampere
pwm <0/1> pid	Set PWM to be controlled by PID
center <0/1> <volts>	Set the MAX1968 0A-centerpoint to volts
center <0/1> vref	Set the MAX1968 0A-centerpoint to measure from VREF
pid	Show PID configuration
pid <0/1> target <value>	Set the PID controller target
pid <0/1> kp <value>	Set proportional gain
pid <0/1> ki <value>	Set integral gain
pid <0/1> kd <value>	Set differential gain
pid <0/1> output_min <value>	Set mininum output
pid <0/1> output_max <value>	Set maximum output
pid <0/1> integral_min <value>	Set integral lower bound
pid <0/1> integral_max <value>	Set integral upper bound
s-h	Show Steinhart-Hart equation parameters
s-h <0/1> <t0/b/r0> <value>	Set Steinhart-Hart parameter for a channel
postfilter	Show postfilter settings
postfilter <0/1> off	Disable postfilter
postfilter <0/1> rate <rate>	Set postfilter output data rate
load	Restore configuration from EEPROM
save	Save configuration to EEPROM
reset	Reset the device
ipv4 <X.X.X.X>	Configure IPv4 address

USB

The firmware includes experimental support for acting as a USB-Serial peripheral. Debug logging will be sent there by default (unless build with logging via semihosting.)

Caveat: This logging does not flush its output. Doing so would hang indefinitely if the output is not read by the USB host. Therefore output will be truncated once buffers are full.