boards: blues: adds Cygnet
Adds new STM32L433 Feather Board from Blues Signed-off-by: Alex Bucknall <alex.bucknall@gmail.com>
This commit is contained in:
parent
b53937239f
commit
67dece8474
12 changed files with 460 additions and 0 deletions
5
boards/blues/cygnet/Kconfig.cygnet
Normal file
5
boards/blues/cygnet/Kconfig.cygnet
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
# Copyright (c) 2025 Blues
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
config BOARD_CYGNET
|
||||||
|
select SOC_STM32L433XX
|
12
boards/blues/cygnet/Kconfig.defconfig
Normal file
12
boards/blues/cygnet/Kconfig.defconfig
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
# STM32L433CC Cygnet board configuration
|
||||||
|
|
||||||
|
# Copyright (c) 2025 Blues
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
if BOARD_CYGNET
|
||||||
|
|
||||||
|
config SPI_STM32_INTERRUPT
|
||||||
|
default y
|
||||||
|
depends on SPI
|
||||||
|
|
||||||
|
endif # BOARD_CYGNET
|
10
boards/blues/cygnet/board.cmake
Normal file
10
boards/blues/cygnet/board.cmake
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
# keep first
|
||||||
|
board_runner_args(stm32cubeprogrammer "--port=swd" "--reset-mode=hw")
|
||||||
|
board_runner_args(jlink "--device=STM32L433CC" "--speed=4000")
|
||||||
|
|
||||||
|
# keep first
|
||||||
|
include(${ZEPHYR_BASE}/boards/common/stm32cubeprogrammer.board.cmake)
|
||||||
|
include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
|
||||||
|
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
|
6
boards/blues/cygnet/board.yml
Normal file
6
boards/blues/cygnet/board.yml
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
board:
|
||||||
|
name: cygnet
|
||||||
|
full_name: Cygnet
|
||||||
|
vendor: blues
|
||||||
|
socs:
|
||||||
|
- name: stm32l433xx
|
138
boards/blues/cygnet/cygnet.dts
Normal file
138
boards/blues/cygnet/cygnet.dts
Normal file
|
@ -0,0 +1,138 @@
|
||||||
|
/*
|
||||||
|
* Copyright (c) 2025 Blues
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: Apache-2.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
/dts-v1/;
|
||||||
|
#include <st/l4/stm32l433Xc.dtsi>
|
||||||
|
#include <st/l4/stm32l433c(b-c)ux-pinctrl.dtsi>
|
||||||
|
#include "feather_connector.dtsi"
|
||||||
|
#include <zephyr/dt-bindings/input/input-event-codes.h>
|
||||||
|
|
||||||
|
/ {
|
||||||
|
model = "Blues Cygnet";
|
||||||
|
compatible = "blues,cygnet";
|
||||||
|
|
||||||
|
chosen {
|
||||||
|
zephyr,console = &lpuart1;
|
||||||
|
zephyr,shell-uart = &lpuart1;
|
||||||
|
zephyr,sram = &sram0;
|
||||||
|
zephyr,flash = &flash0;
|
||||||
|
};
|
||||||
|
|
||||||
|
leds: leds {
|
||||||
|
compatible = "gpio-leds";
|
||||||
|
|
||||||
|
user_led: led_0 {
|
||||||
|
gpios = <&gpioa 8 GPIO_ACTIVE_HIGH>;
|
||||||
|
label = "User LED";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
gpio_keys {
|
||||||
|
compatible = "gpio-keys";
|
||||||
|
|
||||||
|
user_button: button {
|
||||||
|
gpios = <&gpioc 13 GPIO_ACTIVE_LOW>;
|
||||||
|
label = "User Button";
|
||||||
|
zephyr,code = <INPUT_KEY_0>;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
aliases {
|
||||||
|
led0 = &user_led;
|
||||||
|
sw0 = &user_button;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
&clk_lsi {
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&clk_hsi {
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&pll {
|
||||||
|
div-m = <1>;
|
||||||
|
mul-n = <20>;
|
||||||
|
div-p = <7>;
|
||||||
|
div-q = <2>;
|
||||||
|
div-r = <4>;
|
||||||
|
clocks = <&clk_hsi>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&rcc {
|
||||||
|
clocks = <&pll>;
|
||||||
|
clock-frequency = <DT_FREQ_M(80)>;
|
||||||
|
ahb-prescaler = <1>;
|
||||||
|
apb1-prescaler = <1>;
|
||||||
|
apb2-prescaler = <1>;
|
||||||
|
};
|
||||||
|
|
||||||
|
&lpuart1 {
|
||||||
|
pinctrl-0 = <&lpuart1_tx_pb11 &lpuart1_rx_pb10>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
current-speed = <115200>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&usart1 {
|
||||||
|
pinctrl-0 = <&usart1_tx_pa9 &usart1_rx_pa10>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
current-speed = <115200>;
|
||||||
|
};
|
||||||
|
|
||||||
|
&spi1 {
|
||||||
|
pinctrl-0 = <&spi1_sck_pa5 &spi1_miso_pa6 &spi1_mosi_pb5>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
cs-gpios = <&gpiob 0 (GPIO_ACTIVE_LOW | GPIO_PULL_UP)>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&i2c1 {
|
||||||
|
pinctrl-0 = <&i2c1_scl_pb6 &i2c1_sda_pb7>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
clock-frequency = <I2C_BITRATE_FAST>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&timers2 {
|
||||||
|
status = "okay";
|
||||||
|
|
||||||
|
pwm2: pwm {
|
||||||
|
status = "okay";
|
||||||
|
pinctrl-0 = <&tim2_ch1_pa0>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
&can1 {
|
||||||
|
pinctrl-0 = <&can1_rx_pb8 &can1_tx_pb9>;
|
||||||
|
pinctrl-names = "default";
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&rtc {
|
||||||
|
clocks = <&rcc STM32_CLOCK_BUS_APB1 0x10000000>,
|
||||||
|
<&rcc STM32_SRC_LSI RTC_SEL(2)>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&flash0 {
|
||||||
|
partitions {
|
||||||
|
compatible = "fixed-partitions";
|
||||||
|
#address-cells = <1>;
|
||||||
|
#size-cells = <1>;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Reserve the final 16 KiB for file system partition
|
||||||
|
*/
|
||||||
|
storage_partition: partition@3c000 {
|
||||||
|
label = "storage";
|
||||||
|
reg = <0x0003c000 DT_SIZE_K(16)>;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
22
boards/blues/cygnet/cygnet.yaml
Normal file
22
boards/blues/cygnet/cygnet.yaml
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
identifier: cygnet
|
||||||
|
name: Blues Cygnet
|
||||||
|
type: mcu
|
||||||
|
arch: arm
|
||||||
|
toolchain:
|
||||||
|
- zephyr
|
||||||
|
- gnuarmemb
|
||||||
|
- xtools
|
||||||
|
ram: 64
|
||||||
|
flash: 256
|
||||||
|
supported:
|
||||||
|
- nvs
|
||||||
|
- can
|
||||||
|
- spi
|
||||||
|
- i2c
|
||||||
|
- pwm
|
||||||
|
- gpio
|
||||||
|
- counter
|
||||||
|
- feather_serial
|
||||||
|
- feather_i2c
|
||||||
|
- feather_spi
|
||||||
|
vendor: blues
|
17
boards/blues/cygnet/cygnet_defconfig
Normal file
17
boards/blues/cygnet/cygnet_defconfig
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
# Enable MPU
|
||||||
|
CONFIG_ARM_MPU=y
|
||||||
|
|
||||||
|
# Enable HW stack protection
|
||||||
|
CONFIG_HW_STACK_PROTECTION=y
|
||||||
|
|
||||||
|
# Enable UART driver
|
||||||
|
CONFIG_SERIAL=y
|
||||||
|
|
||||||
|
# Enable GPIO
|
||||||
|
CONFIG_GPIO=y
|
||||||
|
|
||||||
|
# Enable console
|
||||||
|
CONFIG_CONSOLE=y
|
||||||
|
CONFIG_UART_CONSOLE=y
|
BIN
boards/blues/cygnet/doc/img/cygnet-pinout.webp
Normal file
BIN
boards/blues/cygnet/doc/img/cygnet-pinout.webp
Normal file
Binary file not shown.
After Width: | Height: | Size: 42 KiB |
BIN
boards/blues/cygnet/doc/img/cygnet.webp
Normal file
BIN
boards/blues/cygnet/doc/img/cygnet.webp
Normal file
Binary file not shown.
After Width: | Height: | Size: 46 KiB |
204
boards/blues/cygnet/doc/index.rst
Normal file
204
boards/blues/cygnet/doc/index.rst
Normal file
|
@ -0,0 +1,204 @@
|
||||||
|
.. zephyr:board:: cygnet
|
||||||
|
|
||||||
|
Overview
|
||||||
|
********
|
||||||
|
|
||||||
|
The Blues Cygnet board features an ARM Cortex-M4 based STM32L433CC MCU
|
||||||
|
with a wide range of connectivity support and configurations. Here are
|
||||||
|
some highlights of the Cygnet board:
|
||||||
|
|
||||||
|
- STM32L4 microcontroller in LQFP48 package
|
||||||
|
- Adafruit Feather connector
|
||||||
|
- User LED
|
||||||
|
- User push-button
|
||||||
|
- USB Type-C connector
|
||||||
|
|
||||||
|
More information about the board can be found at the `Blues Cygnet website`_.
|
||||||
|
|
||||||
|
Hardware
|
||||||
|
********
|
||||||
|
|
||||||
|
The STM32L433CC SoC provides the following hardware IPs:
|
||||||
|
|
||||||
|
- Ultra-low-power with FlexPowerControl (down to 28 nA Standby mode and 84
|
||||||
|
|micro| A/MHz run mode)
|
||||||
|
- Core: ARM |reg| 32-bit Cortex |reg| -M4 CPU with FPU, frequency up to 80 MHz,
|
||||||
|
100DMIPS/1.25DMIPS/MHz (Dhrystone 2.1)
|
||||||
|
- Clock Sources:
|
||||||
|
|
||||||
|
- 32 kHz crystal oscillator for RTC (LSE)
|
||||||
|
- Internal 16 MHz factory-trimmed RC ( |plusminus| 1%)
|
||||||
|
- Internal low-power 32 kHz RC ( |plusminus| 5%)
|
||||||
|
- Internal multispeed 100 kHz to 48 MHz oscillator, auto-trimmed by
|
||||||
|
LSE (better than |plusminus| 0.25 % accuracy)
|
||||||
|
- 2 PLLs for system clock, USB, audio, ADC
|
||||||
|
|
||||||
|
- RTC with HW calendar, alarms and calibration
|
||||||
|
- 11x timers:
|
||||||
|
|
||||||
|
- 1x 16-bit advanced motor-control
|
||||||
|
- 1x 32-bit and 2x 16-bit general purpose
|
||||||
|
- 2x 16-bit basic
|
||||||
|
- 2x low-power 16-bit timers (available in Stop mode)
|
||||||
|
- 2x watchdogs
|
||||||
|
- SysTick timer
|
||||||
|
|
||||||
|
- Up to 21 fast I/Os, most 5 V-tolerant
|
||||||
|
- Memories
|
||||||
|
|
||||||
|
- Up to 256 KB single bank Flash, proprietary code readout protection
|
||||||
|
- 64 KB of SRAM including 16 KB with hardware parity check
|
||||||
|
|
||||||
|
- Rich analog peripherals (independent supply)
|
||||||
|
|
||||||
|
- 1x 12-bit ADC 5 MSPS, up to 16-bit with hardware oversampling, 200
|
||||||
|
|micro| A/MSPS
|
||||||
|
- 2x 12-bit DAC output channels, low-power sample and hold
|
||||||
|
- 1x operational amplifiers with built-in PGA
|
||||||
|
- 2x ultra-low-power comparators
|
||||||
|
|
||||||
|
- 17x communication interfaces
|
||||||
|
|
||||||
|
- USB 2.0 full-speed crystal less solution with LPM and BCD
|
||||||
|
- 1x SAI (serial audio interface)
|
||||||
|
- 3x I2C FM+(1 Mbit/s), SMBus/PMBus
|
||||||
|
- 4x USARTs (ISO 7816, LIN, IrDA, modem)
|
||||||
|
- 1x LPUART (Stop 2 wake-up)
|
||||||
|
- 3x SPIs (and 1x Quad SPI)
|
||||||
|
- CAN (2.0B Active)
|
||||||
|
|
||||||
|
- 14-channel DMA controller
|
||||||
|
- True random number generator
|
||||||
|
- CRC calculation unit, 96-bit unique ID
|
||||||
|
- Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell*
|
||||||
|
|
||||||
|
More information about STM32L433CC can be found here:
|
||||||
|
|
||||||
|
- `STM32L433CC on www.st.com`_
|
||||||
|
- `STM32L432 reference manual`_
|
||||||
|
|
||||||
|
Supported Features
|
||||||
|
==================
|
||||||
|
|
||||||
|
.. zephyr:board-supported-hw::
|
||||||
|
|
||||||
|
.. note:: CAN feature requires a CAN transceiver.
|
||||||
|
|
||||||
|
Connections and IOs
|
||||||
|
===================
|
||||||
|
|
||||||
|
The Cygnet board has 6 GPIO controllers. These controllers are responsible for pin muxing,
|
||||||
|
input/output, pull-up, etc.
|
||||||
|
|
||||||
|
Available pins
|
||||||
|
--------------
|
||||||
|
.. image:: img/cygnet-pinout.webp
|
||||||
|
:align: center
|
||||||
|
:alt: Cygnet Pinout
|
||||||
|
|
||||||
|
For more details please refer to `Blues Cygnet User Manual`_.
|
||||||
|
|
||||||
|
Default Zephyr Peripheral Mapping
|
||||||
|
---------------------------------
|
||||||
|
|
||||||
|
- LPUART_1_TX : PB11
|
||||||
|
- LPUART_1_RX : PB10
|
||||||
|
- UART_1_TX : PA9
|
||||||
|
- UART_1_RX : PA10
|
||||||
|
- I2C_1_SCL : PB6
|
||||||
|
- I2C_1_SDA : PB7
|
||||||
|
- PWM_2_CH1 : PA0
|
||||||
|
- SPI_1: SCK/MISO/MOSI : PA5/PA6/PB5
|
||||||
|
|
||||||
|
System Clock
|
||||||
|
------------
|
||||||
|
|
||||||
|
The Cygnet board System Clock could be driven by internal or external oscillator,
|
||||||
|
as well as main PLL clock. By default System clock is driven by PLL clock at 80MHz,
|
||||||
|
driven by 16MHz high speed internal oscillator.
|
||||||
|
|
||||||
|
Serial Port
|
||||||
|
-----------
|
||||||
|
|
||||||
|
The Cygnet board has 4 U(S)ARTs and 1 LPUART. The Zephyr console output is assigned
|
||||||
|
to LPUART1. Default settings are 115200 8N1.
|
||||||
|
|
||||||
|
|
||||||
|
Programming and Debugging
|
||||||
|
*************************
|
||||||
|
|
||||||
|
The Cygnet board requires an ST-LINK embedded debug tool in order to be programmed and debugged.
|
||||||
|
|
||||||
|
Applications for the ``cygnet`` board configuration can be built and
|
||||||
|
flashed in the usual way (see :ref:`build_an_application` and
|
||||||
|
:ref:`application_run` for more details).
|
||||||
|
|
||||||
|
Flashing
|
||||||
|
========
|
||||||
|
|
||||||
|
The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
|
||||||
|
so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
|
||||||
|
|
||||||
|
Alternatively, OpenOCD or JLink can also be used to flash the board using
|
||||||
|
the ``--runner`` (or ``-r``) option:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ west flash --runner openocd
|
||||||
|
$ west flash --runner jlink
|
||||||
|
|
||||||
|
Flashing an application to Cygnet
|
||||||
|
---------------------------------
|
||||||
|
|
||||||
|
Connect the Cygnet to the ST-LINK debugger, then run a serial host program to connect with your Cygnet board.
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ picocom /dev/ttyACM0 -b 115200
|
||||||
|
|
||||||
|
Now build and flash an application. Here is an example for
|
||||||
|
:zephyr:code-sample:`hello_world`.
|
||||||
|
|
||||||
|
.. zephyr-app-commands::
|
||||||
|
:zephyr-app: samples/hello_world
|
||||||
|
:board: cygnet
|
||||||
|
:goals: build flash
|
||||||
|
|
||||||
|
You should see the following message on the console:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ Hello World! cygnet
|
||||||
|
|
||||||
|
|
||||||
|
Debugging
|
||||||
|
=========
|
||||||
|
|
||||||
|
You can debug an application in the usual way. Here is an example for the
|
||||||
|
:zephyr:code-sample:`hello_world` application.
|
||||||
|
|
||||||
|
.. zephyr-app-commands::
|
||||||
|
:zephyr-app: samples/hello_world
|
||||||
|
:board: cygnet
|
||||||
|
:maybe-skip-config:
|
||||||
|
:goals: debug
|
||||||
|
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
|
||||||
|
.. _Blues Cygnet website:
|
||||||
|
https://www.blues.dev/
|
||||||
|
|
||||||
|
.. _Blues Cygnet User Manual:
|
||||||
|
https://dev.blues.io/feather-mcus/cygnet/cygnet-introduction/
|
||||||
|
|
||||||
|
.. _STM32L433CC on www.st.com:
|
||||||
|
https://www.st.com/en/microcontrollers-microprocessors/stm32l433cc.html
|
||||||
|
|
||||||
|
.. _STM32L432 reference manual:
|
||||||
|
https://www.st.com/resource/en/reference_manual/dm00151940.pdf
|
||||||
|
|
||||||
|
.. _STM32CubeProgrammer:
|
||||||
|
https://www.st.com/en/development-tools/stm32cubeprog.html
|
39
boards/blues/cygnet/feather_connector.dtsi
Normal file
39
boards/blues/cygnet/feather_connector.dtsi
Normal file
|
@ -0,0 +1,39 @@
|
||||||
|
/*
|
||||||
|
* Copyright (c) 2025 Blues Inc.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: Apache-2.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
/ {
|
||||||
|
feather_header: connector {
|
||||||
|
compatible = "adafruit-feather-header";
|
||||||
|
#gpio-cells = <2>;
|
||||||
|
gpio-map-mask = <0xffffffff 0xffffffc0>;
|
||||||
|
gpio-map-pass-thru = <0 0x3f>;
|
||||||
|
gpio-map = <0 0 &gpioa 0 0>, /* A0 */
|
||||||
|
<1 0 &gpioa 1 0>, /* A1 */
|
||||||
|
<2 0 &gpioa 2 0>, /* A2 */
|
||||||
|
<3 0 &gpioa 3 0>, /* A3 */
|
||||||
|
<4 0 &gpiob 1 0>, /* A4 */
|
||||||
|
<5 0 &gpioa 7 0>, /* A5 */
|
||||||
|
<6 0 &gpioa 5 0>, /* SCK */
|
||||||
|
<7 0 &gpiob 5 0>, /* MOSI */
|
||||||
|
<8 0 &gpioa 6 0>, /* MISO */
|
||||||
|
<9 0 &gpioa 10 0>, /* RX */
|
||||||
|
<10 0 &gpioa 9 0>, /* TX */
|
||||||
|
<11 0 &gpiob 1 0>, /* D4 */
|
||||||
|
<12 0 &gpiob 7 0>, /* SDA */
|
||||||
|
<13 0 &gpiob 6 0>, /* SCL */
|
||||||
|
<14 0 &gpiob 8 0>, /* D5 */
|
||||||
|
<15 0 &gpiob 9 0>, /* D6 */
|
||||||
|
<16 0 &gpiob 14 0>, /* D9 */
|
||||||
|
<17 0 &gpiob 13 0>, /* D10 */
|
||||||
|
<18 0 &gpiob 0 0>, /* D11 */
|
||||||
|
<19 0 &gpiob 15 0>, /* D12 */
|
||||||
|
<20 0 &gpiob 4 0>; /* D13 */
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
feather_serial: &usart1 {};
|
||||||
|
feather_i2c: &i2c1 {};
|
||||||
|
feather_spi: &spi1 {};
|
7
boards/blues/cygnet/support/openocd.cfg
Normal file
7
boards/blues/cygnet/support/openocd.cfg
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
source [find interface/stlink.cfg]
|
||||||
|
|
||||||
|
transport select hla_swd
|
||||||
|
|
||||||
|
source [find target/stm32l4x.cfg]
|
||||||
|
|
||||||
|
reset_config srst_only
|
Loading…
Add table
Add a link
Reference in a new issue