blob: e5da27ad8c691f74591a21c66bf493e6f55f58d6 [file] [log] [blame]
.. zephyr:board:: linum
Overview
********
Linum is a development board released by Witte Tenology in 2023, and it was developed around the
STM32H753BI microcontroller. The board has 2 expansion connectors used by the LCD display with
touchscreen and another for access to other peripherals of microcontroller. Also it brings plenty
of communications interfaces like UART with RS232 and RS485 capabillities, CAN bus compatible to
FD standard, and networking over Ethernet.
Hardware
********
The board features:
- 8 to 52V power supply
- SWD Pins for use as STLink (Pin header) and TC2030-IDC 6-Pin Tag-Connect Plug-of-Nails Connector
- Crystal for HS 25MHz
- Crystal for RTC 32.768KHz
- 1 UART serial for debug
- 1 Led RGB
- 1 Buzzer without internal oscillator
- 1 Mono audio up to 3W
- 1 Ethernet 10/100
- 1 MicroSD connector supporting 1 or 4-bit bus
- 1 USB 2.0 Host/Device
- 1 EEPROM memory with 512K bits
- 1 External SRAM memory with 8MB
- 1 NOR memory with 16MB
- 2 On-board RS232 Transceiver with RTS/CTS
- 2 On-board RS485 Transceiver
- 2 On-board CAN-FD Transceiver
Expansion connector 1 features:
- 1 Display RBG 888
- 1 Capacitive Touchscreen sensor
Expansion connector 2 features.
- 1 SPI
- 1 I2C
- 1 One Wire
- 2 DACs
- 6 PWM Channels
- 10 ADCs
More information about the board, can be found at the `Witte Linum website`_.
Supported Features
==================
.. zephyr:board-supported-hw::
Default Zephyr Peripheral Mapping:
----------------------------------
BOARD-LEDs
----------
The LINUM-STM32H753BI has 3 software controllable LEDs.
======= =====
LED RGB PINS
======= =====
LED_R PG2
LED_G PG3
LED_B PB2
======= =====
UART/USART
----------
The LINUM-STM32H753BI used the USART1 for serial console.
USART1
------
====== =====
USART1 PINS
====== =====
TX PB14
RX PB15
====== =====
The LINUM-STM32H753BI board has two on-board RS-232 transceiver connected to USART2 and USART3.
====== =====
USART2 PINS
====== =====
TXD PD5
RXD PD6
CTS PD3
RTS PD4
====== =====
====== =====
USART3 PINS
====== =====
TXD PB10
RXD PB11
CTS PD11
RTS PD12
====== =====
The LINUM-STM32H753BI board has two on-board RS-485 transceiver connected to USART4 and USART6.
====== =====
UART4 PINS
====== =====
TXD PB9
RXD PB8
DE PA15
====== =====
====== =====
USART6 PINS
====== =====
TXD PC6
RXD PC7
DE PG12
====== =====
SDMMC
-----
The LINUM-STM32H753BI has one SDCard slot connected as below:
========== =====
SDMMC1 PINS
========== =====
SDMMC_D0 PC8
SDMMC_D1 PC9
SDMMC_D2 PC10
SDMMC_D3 PC11
SDMMC_DK PC12
========== =====
=============== =====
GPIO PINS
=============== =====
SDCARD_DETECTED PG7
SDCARD_PWR_EN PD7
=============== =====
ETHERNET
--------
The LINUM-STM32H753BI has a ethernet connection using the transceiver KSZ8081RNACA.
============ =====
ETH PINS
============ =====
ETH_REF_CLK PA1
ETH_MDIO PA2
ETH_CRS_DV PA7
ETH_MDC PC1
ETH_RXD0 PC4
ETH_RXD1 PC5
ETH_TX_EN PG11
ETH_TXD0 PG13
ETH_TXD1 PG14
ETH_CLK PA8
ETH_RESET PI4
============ =====
CAN-FD
------
The LINUM-STM32H753BI board has two on-board CAN-FD transceiver connected to FDCAN1 and FDCAN2.
====== =====
FDCAN1 PINS
====== =====
TXD PH13
RXD PH14
STD PI2
====== =====
====== =====
FDCAN2 PINS
====== =====
TXD PB13
RXD PB12
STD PE3
====== =====
USB
---
The LINUM-STM32H753BI has one usb port.
========= =====
USB PINS
========= =====
USB_VBUS PA9
USB_N PA11
USB_P PA12
USB_EN PI12
USB_FLT PI13
========= =====
I2C3
----
The LINUM-STM32H753BI connects the EEPROM memory and the touchscreen sensor to I2C3.
====== =====
I2C3 PINS
====== =====
SCL PH7
SDA PH8
====== =====
External SDRAM
--------------
The LINUM-STM32H753BI has a external SDRAM with 8Mbytes connected to FMC peripheral.
=========== =====
FMC PINS
=========== =====
FMC_A0 PF0
FMC_A1 PF1
FMC_A2 PF2
FMC_A3 PF3
FMC_A4 PF4
FMC_A5 PF5
FMC_A6 PF12
FMC_A7 PF13
FMC_A8 PF14
FMC_A9 PF15
FMC_A10 PG0
FMC_A11 PG1
FMC_BA0 PG4
FMC_BA1 PG5
FMC_D0 PD14
FMC_D1 PD15
FMC_D2 PD0
FMC_D3 PD1
FMC_D4 PE7
FMC_D5 PE8
FMC_D6 PE9
FMC_D7 PE10
FMC_D8 PE11
FMC_D9 PE12
FMC_D10 PE13
FMC_D11 PE14
FMC_D12 PE15
FMC_D13 PD8
FMC_D14 PD9
FMC_D15 PD10
FMC_NBL0 PE0
FMC_NBL1 PE1
FMC_SDCKE0 PC3
FMC_SDCLK PG8
FMC_SDNCAS PG15
FMC_SDNEO PC2
FMC_SDNRAS PF11
FMC_SDNWE PC0
=========== =====
LCD
---
The LINUM-STM32H753BI use the LTDC to support one LCD with RGB connection.
============= =====
LTDC PINS
============= =====
LTDC_B0 PJ12
LTDC_B1 PJ13
LTDC_B2 PJ14
LTDC_B3 PJ15
LTDC_B4 PK3
LTDC_B5 PK4
LTDC_B6 PK5
LTDC_B7 PK6
LTDC_CLK PI14
LTDC_DE PK7
LTDC_G0 PJ7
LTDC_G1 PJ8
LTDC_G2 PJ9
LTDC_G3 PJ10
LTDC_G4 PJ11
LTDC_G5 PK0
LTDC_G6 PK1
LTDC_G7 PK2
LTDC_HSYNC PI10
LTDC_R0 PI15
LTDC_R1 PJ0
LTDC_R2 PJ1
LTDC_R3 PJ2
LTDC_R4 PJ3
LTDC_R5 PJ4
LTDC_R6 PJ5
LTDC_R7 PJ6
LTDC_VSYNC PI9
PWM_BACKLIGHT PH6
============= =====
System Clock
------------
Linum H753ZI System Clock could be driven by an internal or external
oscillator, as well as the main PLL clock. By default, the System clock is
driven by the PLL clock at 480MHz, driven by an 25MHz high-speed external clock.
Programming and Debugging
*************************
.. zephyr:board-supported-runners::
Applications for the ``linum`` board configuration can be built and
flashed in the usual way (see :ref:`build_an_application` and
:ref:`application_run` for more details).
.. note::
For debugging or programming Linum you will need to use an external debug
debug or flash tool and connect it to the SWD Connnector. JLink or ST-Link
probes are examples of out of the box compatible tools.
Flashing
========
Flashing an application to the Linum board
-------------------------------------------
Here is an example for the :zephyr:code-sample:`hello_world` application.
Run a serial host program to connect with your Nucleo board.
.. code-block:: console
$ minicom -b 115200 -D /dev/ttyACM0
Build and flash the application:
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: linum
:goals: build flash
You should see the following message on the console:
.. code-block:: console
$ Hello World! linum
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: linum
:maybe-skip-config:
:goals: debug
.. _Witte Linum website:
https://wittetech.com/