REST API: list boards

[jbride]

path = "/api/v1/boards"

Response: JSON representation of BoardListResponse

Supporting Data Structures:

1. BoardListResponse

---

#[derive(Debug, Clone, Serialize, ToSchema)]
pub struct BoardListResponse {
    pub active_boards: Vec<BoardStatus>,
    pub failed_boards: Vec<FailedBoardStatus>,
}

---

2. BoardStatus

---

#[derive(Debug, Clone, Serialize, ToSchema)]
pub struct BoardStatus {
    /// Board model/type (e.g., "Bitaxe Gamma")
    #[schema(example = "Bitaxe Gamma")]
    pub model: String,
    /// Board firmware version if available
    #[schema(example = "2.1.4")]
    pub firmware_version: Option<String>,
    /// Serial number
    #[schema(example = "ABC12345")]
    pub serial_number: String,
    /// Whether the board is currently connected
    #[schema(example = true)]
    pub connected: bool,
    /// Whether voltage control is available for this board
    #[schema(example = true)]
    pub voltage_control_available: bool,
    /// Current voltage in volts (if voltage control is available)
    #[schema(example = 1.2)]
    pub current_voltage_v: Option<f32>,
    /// Error message if the board is experiencing issues (e.g., I2C communication failure)
    #[schema(example = "I2C communication timeout")]
    pub error: Option<String>,
    /// Whether the board needs reinitialization due to consecutive failures
    #[schema(example = false)]
    pub needs_reinit: bool,
    /// Number of consecutive failures
    #[schema(example = 0)]
    pub consecutive_failures: u32,
    /// Number of automatic retry attempts
    #[schema(example = 0)]
    pub retry_count: u32,
}

---

3. FailedBoardStatus

---

#[derive(Debug, Clone, Serialize, ToSchema)]
pub struct FailedBoardStatus {
    /// Board model/type if known
    #[schema(example = "Bitaxe Gamma")]
    pub model: Option<String>,
    /// Serial number if available
    #[schema(example = "ABC12345")]
    pub serial_number: Option<String>,
    /// Error message describing why initialization failed
    #[schema(example = "Failed to initialize I2C communication")]
    pub error: String,
}

---

[jbride]

BoardStatus struct should also include:

1. board_temp_c
2. fan_speed_rpm

[rkuester]

MIP-0001 makes /boards a readable collection in the unified tree, so listing boards is just a read of that path. Folding into #57; closing as superseded. Thanks for the early spec.