Wiznet makers

Project Overview

Booster NGFW is not a general RF amplifier design repository. It is the firmware layer for operating the Sinara Booster safely and remotely. The firmware supervises RF modules, handles interlock and fault conditions, publishes telemetry over MQTT, accepts runtime settings, and exposes local service/configuration through USB serial. The official documentation identifies three application interfaces: front-panel buttons, USB port, and Ethernet via MQTT.

The underlying Booster hardware provides several watts of RF output across eight channels between 40 MHz and 500 MHz in a compact 2U 19-inch chassis. It includes Ethernet-based remote monitoring/configuration, per-channel monitoring, interlocks, and modular field-replaceable RF channels.

System Architecture

[Front Panel Buttons]
  ├─ Standby
  └─ Interlock Reset
        │
        ▼
[STM32F4 Firmware: Rust + RTIC]
  ├─ Channel monitor
  ├─ Telemetry task
  ├─ Button polling
  ├─ USB processing
  ├─ Settings update
  ├─ Watchdog check-in
  └─ RF channel state machine
        │
        ├──────────────► [Ethernet]
        │                  ├─ W5500 MACRAW
        │                  └─ ENC424J600
        │                         │
        │                         ▼
        │                    [smoltcp]
        │                         │
        │                         ├─ MQTT Telemetry
        │                         ├─ Miniconf Settings
        │                         └─ MQTT Control / Python CLI
        │
        ▼
[8 RF Amplifier Channels]
  ├─ Bias DAC
  ├─ Input power ADC
  ├─ Output / reflected power sensing
  ├─ Temperature monitor
  ├─ Interlock threshold DAC
  ├─ RF switch control
  └─ Fan control

The firmware uses no_std, no_main, RTIC v2, stm32f4xx-hal, smoltcp, smoltcp-nal, minimq, minireq, miniconf, miniconf_mqtt, w5500, and enc424j600. These dependencies define a bare-metal Rust firmware rather than a Linux application or high-level gateway program.

Operation Flow

Boot
  ↓
STM32F4 hardware initialization
  ↓
GPIO / I2C / SPI / ADC / USB / watchdog / flash setup
  ↓
RF channel enumeration through I2C mux
  ↓
Detected channel modules are attached to RF channel state machines
  ↓
Runtime settings are loaded from EEPROM / flash
  ↓
Network controller is detected
  ├─ W5500 → MACRAW initialization
  └─ ENC424J600 → MAC initialization
  ↓
smoltcp network stack is started
  ↓
Periodic operation
  ├─ Channel monitoring
  ├─ LED status update
  ├─ Fan control
  ├─ MQTT telemetry publication
  ├─ MQTT / Miniconf settings processing
  ├─ USB serial service processing
  └─ Watchdog check-in

The initialization code configures clocks, watchdog, I2C buses, RF channel pins, ADC, EEPROM/flash settings, Ethernet controller detection, USB CDC serial, and fan control. It detects W5500 by reading the W5500 version register and otherwise initializes ENC424J600.

RF Channel Control Flow

Each RF channel is detected and instantiated only when its expected I2C devices respond. The channel discovery loop selects each mux bus, creates an RfChannel, wraps it in an RfChannelMachine, and stores only successfully enumerated channels.

The channel model includes bias DAC, input power ADC, temperature monitor, power monitor, interlock threshold DAC, EEPROM, control pins, output power sensing, and reflected power sensing. The code defines fault conditions for over-temperature, under-temperature, and supply alert, and defines power interlocks for input, output, and reflected power.

The RF state machine includes states such as Off, Powerup, Powered, Enabled, Tripped, Powerdown, and Blocked. Interlock trips can disable the RF switch, while fault states can move the channel into a blocked state.

Network Flow

RF channel measurements
  ↓
STM32F4 firmware
  ↓
smoltcp network stack
  ↓
MQTT topics
  ↓
Telemetry / settings / control clients

Booster uses MQTT for telemetry reporting, runtime settings, and channel control. MQTT topics are prefixed with dt/sinara/booster/<ID>, where the default ID is the device MAC address unless configured through USB. Channel telemetry is published under <prefix>/telemetry/ch<N> for connected channels, with N ranging from 0 to 7.

Runtime settings are managed through Miniconf. The documentation also describes a Python package under the repository’s py folder for channel bias tuning and saving active channel settings to EEPROM.

WIZnet Product Usage

The firmware explicitly detects W5500 by checking for version value 0x04, resets the W5500, and initializes it with initialize_macraw(). If W5500 is not detected, it initializes ENC424J600 instead.

TOE Usage

The code uses initialize_macraw() for W5500 and then creates a smoltcp_nal::NetworkStack, indicating that W5500 is used as a MAC-level Ethernet interface rather than as a TCP/IP socket offload device.

Hybrid Network Assessment

The documentation lists front-panel buttons, USB, and Ethernet via MQTT as the supported application interfaces. No Wi-Fi, BLE, LoRa, cellular, or other wireless network path is described in the reviewed project materials.

Strengths

The firmware’s RTIC tasks include channel monitoring, telemetry reporting, button handling, USB processing, settings update, network processing, and watchdog check-ins.

Limitations

The Sinara Booster wiki states that power measurement is useful but should not be treated as test-and-measurement-grade network analysis, and high VSWR can cause dB-level forward-power measurement errors.

Application Value

Booster NGFW is valuable as a reference for network-enabled laboratory equipment firmware. It combines embedded Rust, multi-channel hardware supervision, RF protection logic, MQTT telemetry, persistent settings, USB service operation, and Ethernet controller abstraction in a single instrument-control system.

The project is especially relevant to:

Final Summary

Booster NGFW is a Rust-based firmware rewrite for the Sinara Booster 8-channel RF power amplifier. Its main technical value lies in safe RF channel management, structured telemetry, remote configuration, and maintainable embedded firmware design. W5500 is used as an Ethernet controller, but the implementation uses MACRAW mode with smoltcp; therefore, it is not a W5500 TCP/IP Offload Engine example. The project is best classified as laboratory equipment control firmware with strong relevance to RF amplifier supervision and networked experimental systems.

Author Information

The repository page identifies the project as firmware for the Sinara Booster RF amplifier, lists Rust and Python as the main languages, and shows MIT/Apache-2.0 licensing. Cargo metadata lists Ryan Summers and Robert Jördens as authors.

Sinara Booster RF 증폭기를 위한 Rust 기반 제어 펌웨어

프로젝트 개요

Booster NGFW는 RF 증폭기 회로 자체를 새로 설계하는 저장소가 아니라, Sinara Booster 장비를 안전하게 운용하기 위한 펌웨어 저장소이다. 펌웨어는 RF 모듈 감지, 채널 상태 제어, interlock 및 fault 처리, MQTT telemetry 전송, runtime setting 처리, USB serial 기반 설정 및 service interface를 담당한다. 공식 문서는 Booster 애플리케이션과 상호작용하는 경로를 front-panel button, USB port, Ethernet via MQTT의 세 가지로 정리한다.

Sinara Booster 하드웨어는 2U 19인치 chassis에 들어가는 8채널 RF power amplifier이며, 40 MHz에서 500 MHz 범위에서 수 W급 RF 출력을 제공한다. Ethernet 기반 원격 monitoring/configuration, per-channel monitoring, interlock, modular channel 구조를 갖는다.

시스템 구조

[Front Panel Buttons]
  ├─ Standby
  └─ Interlock Reset
        │
        ▼
[STM32F4 Firmware: Rust + RTIC]
  ├─ Channel monitor
  ├─ Telemetry task
  ├─ Button polling
  ├─ USB processing
  ├─ Settings update
  ├─ Watchdog check-in
  └─ RF channel state machine
        │
        ├──────────────► [Ethernet]
        │                  ├─ W5500 MACRAW
        │                  └─ ENC424J600
        │                         │
        │                         ▼
        │                    [smoltcp]
        │                         │
        │                         ├─ MQTT Telemetry
        │                         ├─ Miniconf Settings
        │                         └─ MQTT Control / Python CLI
        │
        ▼
[8 RF Amplifier Channels]
  ├─ Bias DAC
  ├─ Input power ADC
  ├─ Output / reflected power sensing
  ├─ Temperature monitor
  ├─ Interlock threshold DAC
  ├─ RF switch control
  └─ Fan control

소프트웨어 구성은 no_std, no_main 기반 Rust firmware이며, RTIC v2, stm32f4xx-hal, smoltcp, smoltcp-nal, minimq, minireq, miniconf, miniconf_mqtt, w5500, enc424j600 등을 사용한다. 이는 Linux 기반 애플리케이션이나 단순 gateway 프로그램이 아니라, STM32F4에서 동작하는 bare-metal 장비 제어 펌웨어에 해당한다.

동작 흐름

Boot
  ↓
STM32F4 hardware initialization
  ↓
GPIO / I2C / SPI / ADC / USB / watchdog / flash 초기화
  ↓
I2C mux를 통한 RF channel enumeration
  ↓
감지된 RF channel을 state machine에 연결
  ↓
EEPROM / flash 기반 runtime settings 로드
  ↓
Ethernet controller 감지
  ├─ W5500 → MACRAW 초기화
  └─ ENC424J600 → MAC 초기화
  ↓
smoltcp network stack 시작
  ↓
주기적 운용
  ├─ Channel monitoring
  ├─ LED status update
  ├─ Fan control
  ├─ MQTT telemetry publication
  ├─ MQTT / Miniconf settings processing
  ├─ USB serial service processing
  └─ Watchdog check-in

초기화 코드는 clock, watchdog, I2C bus, RF channel pin, ADC, EEPROM/flash settings, Ethernet controller detection, USB CDC serial, fan control을 설정한다. Ethernet controller는 W5500 version register를 읽어 W5500 여부를 판단하고, 그렇지 않은 경우 ENC424J600을 초기화한다.

RF 채널 제어 흐름

각 RF 채널은 I2C mux를 통해 순차적으로 선택되며, 필요한 I2C device가 응답하는 경우에만 RfChannel로 생성된다. 이후 RfChannelMachine으로 감싸져 channel array에 등록된다.

채널 구성은 bias DAC, input power ADC, temperature monitor, power monitor, interlock threshold DAC, EEPROM, control pin, output power sensing, reflected power sensing을 포함한다. 코드상 fault 조건은 over-temperature, under-temperature, supply alert로 정의되고, power interlock은 input, output, reflected 항목으로 정의된다.

RF channel state machine은 Off, Powerup, Powered, Enabled, Tripped, Powerdown, Blocked 상태를 포함한다. Interlock trip은 RF switch disable로 이어질 수 있고, fault 조건은 channel을 blocked 상태로 전환할 수 있다.

네트워크 흐름

RF channel measurements
  ↓
STM32F4 firmware
  ↓
smoltcp network stack
  ↓
MQTT topics
  ↓
Telemetry / settings / control clients

Booster는 MQTT를 사용해 telemetry reporting, runtime settings, channel control을 수행한다. MQTT topic prefix는 dt/sinara/booster/<ID>이며, 기본 ID는 장치 MAC address이고 USB를 통해 변경할 수 있다. Channel telemetry는 <prefix>/telemetry/ch<N> topic으로 발행되며, N은 0부터 7까지의 채널 번호이다.

Runtime settings는 Miniconf를 통해 관리된다. 저장소의 py 폴더에는 channel bias tuning과 active channel settings 저장을 위한 Python package가 제공된다.

WIZnet 제품 사용 여부와 시스템 내 역할

펌웨어는 W5500의 version 값 0x04를 확인해 W5500을 감지하고, W5500 reset 이후 initialize_macraw()로 초기화한다. W5500이 감지되지 않으면 ENC424J600을 초기화한다.

TOE 사용 여부

코드상 W5500은 initialize_macraw()로 초기화되고, 이후 smoltcp_nal::NetworkStack이 생성된다. 따라서 이 구현은 W5500의 socket 기반 TCP/IP offload를 사용하는 구조가 아니라, W5500을 MAC-level Ethernet interface로 사용하고 TCP/IP 처리는 MCU 측 software stack에서 수행하는 구조이다.

Hybrid Network 여부

문서상 Booster 애플리케이션의 통신 경로는 front-panel button, USB port, Ethernet via MQTT이다. Wi-Fi, BLE, LoRa, cellular 등 무선 네트워크 경로는 검토한 자료에서 확인되지 않는다.

장점

RTIC task 구성은 channel monitoring, telemetry reporting, button handling, USB processing, settings update, network processing, watchdog check-in으로 나뉜다.

한계

Sinara Booster wiki는 power measurement가 유용한 기능이지만 test-and-measurement-grade network analyzer가 아니며, high VSWR 조건에서 forward power measurement에 dB 단위 오차가 발생할 수 있다고 설명한다.

적용 가치

Booster NGFW는 network-enabled laboratory equipment firmware의 참고 사례로 가치가 있다. Embedded Rust, multi-channel hardware supervision, RF protection logic, MQTT telemetry, persistent settings, USB service operation, Ethernet controller abstraction이 하나의 장비 제어 시스템 안에 결합되어 있다.

최종 요약

Booster NGFW는 Sinara Booster 8채널 RF power amplifier를 위한 Rust 기반 펌웨어 재작성 프로젝트이다. 핵심 가치는 RF 출력 자체가 아니라, 각 채널을 안전하게 감시하고 제어하는 firmware architecture, MQTT telemetry, runtime settings, USB service interface, Ethernet 기반 원격 운용에 있다. W5500은 Ethernet controller로 사용되지만, TOE 방식이 아니라 MACRAW mode와 smoltcp 조합으로 사용된다. 따라서 이 프로젝트는 W5500 TCP/IP Offload Engine 사례가 아니라, W5500을 MACRAW Ethernet interface로 사용한 Rust 기반 실험장비 제어 펌웨어 사례로 분류된다.

저자 정보

저장소 페이지는 이 프로젝트를 Sinara Booster RF amplifier용 firmware로 설명하며, 주요 언어는 Rust와 Python으로 표시된다. Cargo metadata에는 Ryan Summers와 Robert Jördens가 작성자로 표기되어 있다.