File STM32Board.h

File List > Firmware > Libraries > STM32Board > STM32Board.h

#pragma once
#ifdef ARDUINO_ARCH_STM32

#include <Arduino.h>
#include <stm32f1xx_hal_can.h>

// CanStatus is owned by CANProtocol; forward-declared here so onCanStatus()
// can accept it without pulling the full CANProtocol header into every user.
enum class CanStatus;

static_assert(NODE_ID <= 63,
    "NODE_ID must be 0-63. 0 is reserved for PanelBridge; 1-63 for PanelGroup nodes.");

#ifdef STM32BOARD_TEST
// Effective status-LED state. Normally an internal type defined in STM32Board.cpp;
// exposed here (and mirrored in the .cpp) only for on-target test assertions —
// see Firmware/Tests/STM32Board/. Keep both definitions in sync.
enum class LedState {
    OFF,       
    BOOTING,   
    NORMAL,    
    CONNECTED, 
    CAN_ERROR, 
    BUS_OFF,   
    WARNING,   
};
#endif

namespace STM32Board {

    static constexpr uint8_t PIN_LED_RED   = PB14; 
    static constexpr uint8_t PIN_LED_GREEN = PB15; 

    void begin();

    void setDebug(bool on);

    void tick();

    void onCanStatus(CanStatus status);

    void setWarning(bool on = true);

    void setLinkActive(bool active);

    bool isDebug();

    void log(const char* msg);

    HardwareSerial& diagSerial();

    CAN_HandleTypeDef* canHandle();

#ifdef STM32BOARD_TEST
    LedState currentState();
#endif

} // namespace STM32Board

#endif // ARDUINO_ARCH_STM32