STM32CubeMX Sensor Configuration

This page documents the current STM32CubeMX configuration for the Sensor Board firmware and explains how to extend it for sensor interfaces (UART/I2C/SPI/ADC) in a way that is safe for code generation.

• IOC File: components/sensor_board/firmware/firmware.ioc
• Generated HAL Init Files: components/sensor_board/firmware/Core/Src/
• Application Entry: src/sensor_board/main.c

Current CubeMX Snapshot

Enabled CubeMX Components

• CORTEX_M7 (I-Cache/D-Cache enabled, MPU configured)
• ETH (RMII mode)
• LWIP (Static IP, DHCP disabled)
• FREERTOS (CMSIS-RTOS v2, default task generated)
• TIM1 (base timer)
• SYS/NVIC/RCC base platform configuration

Clock and Core Setup

Clock Configuration (from IOC)

Cortex-M7 / MPU

• Instruction cache: enabled
• Data cache: enabled
• MPU region at 0x30000000, size 32KB, shareable, non-cacheable

Pinout and Peripheral Mapping

Ethernet (RMII)

Serial / COM

Board IO / Misc

Timer, RTOS, and Interrupts

TIM1 Base Timer

htim1.Init.Prescaler = 6400 - 1;
htim1.Init.Period = 10000;

With a 72 MHz timer clock, this gives an update period near 0.89 s.

Interrupt Priorities (Key Entries)

Sensor Interface Status

What Is Already Configured in CubeMX

• Networking stack and RMII pinout
• Base timer and RTOS scaffolding
• Basic UART-capable pins and NUCLEO COM integration path

What Is Not Yet Fully Modeled in CubeMX (TO-DO ONCE sensors retrieved and assembled)

• Dedicated ADC channels for analog sensors (pH, load cell, pressure)
• Dedicated I2C/SPI buses for IMU and pressure variants
• Explicit sensor-specific pin labels and alternate-function assignments

Important: Current sensor drivers include placeholders for hardware access in multiple modules. When bringing up physical sensors, add the corresponding CubeMX peripherals first, then update the sensor drivers to use generated handles.

Recommended Workflow

1. Open components/sensor_board/firmware/firmware.ioc in STM32CubeMX.
2. Add required peripherals for the target sensor like this:

GPS        -> USARTx (baud/parity/stop bits to match module)
IMU        -> I2Cx or SPIx (+ optional DRDY INT GPIO)
pH         -> ADCx channel (sampling time, resolution)
Load Cell  -> ADCx channel(s) or external ADC interface
Pressure   -> ADCx or I2Cx/SPIx (depends on sensor part)

1. Assign and lock pins in Pinout view; avoid overlap with RMII and COM pins.
2. Configure clocks for new peripherals in Clock Configuration.
3. Set NVIC priorities for new ISR sources so Ethernet/RTOS timing remains stable.
4. Generate code with Keep User Code enabled.
5. Rebuild using PlatformIO and validate startup + sensor polling.

Conflict To Look Out for Before Saving .ioc file

• No conflict with ETH RMII pins (PA1, PA2, PA7, PC1, PC4, PC5, PG11, PG13, PB13)
• No conflict with debug/COM path (PA9/PA10 and PD8/PD9)
• No conflict with oscillator pins (PH0, PH1, PC14, PC15)

Related Pages

• Configuration
• Reference
• Sensor Basics Utility Library