REQ-HW-001: MKS Robin Nano (STM32F407xx) board support functional

[andre-stefanov]

Requirement Description

REQ-HW-001: The system SHALL support MKS Robin Nano (STM32F407xx-based) as the primary hardware platform.

Objective

Implement and verify full board support for the MKS Robin Nano (STM32F407xx) within the Zephyr RTOS platform foundation. Ensure that required hardware interfaces, abstraction, and configuration are robust, documented, and tested.

Technical Requirements

Core Board Functionality

• Zephyr board definition and integration in boards/mks/robin_nano/
• Device tree and Kconfig configuration for Robin Nano
• Pin mapping, peripheral support (UART, GPIO, timers, SPI, I2C)
• Hardware abstraction for compile-time configuration

Hardware Integration

• Board-specific configuration file and overlays provided
• Documentation for board setup and supported peripherals
• Ensure compatibility with Zephyr RTOS v4.2.0

Testing & Verification

• Automated build system setup (west build -b robin_nano)
• Hardware-in-the-loop testing for all major interfaces
• Integration tests with application layer
• Documentation updated (docs/boards/robin_nano.md)

Acceptance Criteria

• Robin Nano board boots Zephyr RTOS v4.2.0
• All required hardware interfaces function correctly
• Board abstraction and configuration are documented
• Automated and integration tests pass
• Documentation is up to date

Implementation Notes

Zephyr RTOS Integration

• Use Zephyr's board definition and configuration mechanisms
• Implement device tree overlays for board-specific pin mappings
• Document any board limitations and workarounds

Testing Requirements

• Unit and integration tests for board support
• Hardware verification on actual Robin Nano
• Automated build and CI pipeline coverage

Dependencies

• Prerequisite: REQ-SYS-001 (Zephyr RTOS integration functional)
• Prerequisite: REQ-SYS-002 (32-bit microcontroller platform support)
• Prerequisite: REQ-HW-003 (STM32F407xx family support)
• Enables: All platform-dependent features and EPICs

Implementation Priority

🔴 priority:critical - This is foundational infrastructure required for all hardware-dependent features and system operation.

Related Files

• boards/mks/robin_nano/ - Board definition and configuration
• app/src/ - Application-level board usage
• drivers/ - Hardware interface drivers
• tests/ - Board verification test suites

Definition of Done

• Board support verified on target hardware
• All acceptance criteria met and tested
• Code review completed
• Unit and integration tests passing
• Documentation updated