sergiotarxz/nuttx
sergiotarxz/nuttx
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

configs/nucleo-144: Some documentation updating

Browse Source
This commit is contained in:
Juha Niskanen 2018-03-22 06:42:19 -06:00 committed by Gregory Nutt
parent 6575480d5e
commit 4a0e98de3a
3 changed files with 56 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
configs/nucleo-144/Kconfig
View File

@ -14,14 +14,13 @@ choice
Virtual COM Port: Virtual COM Port:
Advantage: Use the ST-Link as a console. No Extra wiring Advantage: Use the ST-Link as a console. No Extra wiring
neded. needed.
Disdvantage: Not the best choice for initanl bring up. Disdvantage: Not the best choice for initial bring up.
ARDUINO Connector: ARDUINO Connector:
Advantage: You have a shield so it is Advantage: You have a shield so it is easy.
easy.
Disdvantage: You loose the use of the Disdvantage: You loose the use of the
other functions on PC6, PC7 other functions on PC6, PC7
@ -89,7 +88,7 @@ config NUCLEO_SPI_TEST
bool "Enable SPI test" bool "Enable SPI test"
default n default n
---help--- ---help---
Enable Spi test - initalize and configure SPI to send Enable Spi test - initialize and configure SPI to send
NUCLEO_SPI_TEST_MESSAGE text. The text is sent on the NUCLEO_SPI_TEST_MESSAGE text. The text is sent on the
selected SPI Buses with the configured parameters. selected SPI Buses with the configured parameters.
Note the CS lines will not be asserted. Note the CS lines will not be asserted.

54
configs/nucleo-144/README.txt
View File

@ -2,9 +2,9 @@ README
====== ======
This README discusses issues unique to NuttX configurations for the STMicro This README discusses issues unique to NuttX configurations for the STMicro
Nucleo-144 board. See Nucleo-144 board. See ST document STM32 Nucleo-144 boards (UM1974):
http://www.st.com/content/ccc/resource/technical/document/data_brief/group0/7b/df/1d/e9/64/55/43/8d/DM00247910/files/DM00247910.pdf/jcr:content/translations/en.DM00247910.pdf https://www.st.com/resource/en/user_manual/dm00244518.pdf
Contents Contents
======== ========
@ -15,7 +15,7 @@ Contents
- Nucleo F767ZI - Nucleo F767ZI
- Development Environment - Development Environment
- IDEs - IDEs
- Basic configuaration & build steps - Basic configuration & build steps
- Hardware - Hardware
- Button - Button
- LED - LED
@ -41,6 +41,7 @@ LQFP144 package. Variants include
STM32F446ZET6 NUCLEO-F446ZE STM32F446ZET6 NUCLEO-F446ZE
STM32F722ZET6 NUCLEO-F722ZE STM32F722ZET6 NUCLEO-F722ZE
STM32F746ZGT6 NUCLEO-F746ZG STM32F746ZGT6 NUCLEO-F746ZG
STM32F756ZGT6 NUCLEO-F756ZG
STM32F767ZIT6 NUCLEO-F767ZI STM32F767ZIT6 NUCLEO-F767ZI
STM32L496ZGT6 NUCLEO-L496ZG STM32L496ZGT6 NUCLEO-L496ZG
STM32L496ZGT6P NUCLEO-L496ZG-P STM32L496ZGT6P NUCLEO-L496ZG-P
@ -225,11 +226,11 @@ Hardware
1) The I/O is 3.3 Volt not 5 Volt like on the Arduino products. 1) The I/O is 3.3 Volt not 5 Volt like on the Arduino products.
2) The Nucleo-144 board family has 3 pages of Solder Bridges AKA Solder 2) The Nucleo-144 board family has 3 pages of Solder Bridges AKA Solder
Blobs (SB) that can alter the factory configuration. We will note SB Blobs (SB) that can alter the factory configuration. We will note SB
in effect but will assume the facitory defualt settings. in effect but will assume the factory default settings.
Our main concern is establishing a console and LED utilization for Our main concern is establishing a console and LED utilization for
debugging. Because so many pins can be multiplexed with so many functions, debugging. Because so many pins can be multiplexed with so many functions,
the above mentioned graphic may be helpful in indentifying a serial port. the above mentioned graphic may be helpful in identifying a serial port.
There are 5 choices that can be made from the menuconfig: There are 5 choices that can be made from the menuconfig:
@ -237,11 +238,11 @@ Hardware
CONFIG_NUCLEO_CONSOLE_MORPHO_UART4 or CONFIG_NUCLEO_CONSOLE_VIRTUAL or CONFIG_NUCLEO_CONSOLE_MORPHO_UART4 or CONFIG_NUCLEO_CONSOLE_VIRTUAL or
CONFIG_NUCLEO_CONSOLE_NONE CONFIG_NUCLEO_CONSOLE_NONE
The CONFIG_NUCLEO_CONSOLE_NONE makes no preset for the console. YOu shuld still visit The CONFIG_NUCLEO_CONSOLE_NONE makes no preset for the console. You should still
the U[S]ART selection and Device Drivers to disable any U[S]ART reamaing. visit the U[S]ART selection and Device Drivers to disable any U[S]ART remaining.
The CONFIG_NUCLEO_CONSOLE_ARDUINO configurations assume that you are using a The CONFIG_NUCLEO_CONSOLE_ARDUINO configurations assume that you are using a
standard Arduio RS-232 shield with the serial interface with RX on pin D0 and standard Arduino RS-232 shield with the serial interface with RX on pin D0 and
TX on pin D1 from USART6: TX on pin D1 from USART6:
-------- --------------- -------- ---------------
@ -254,7 +255,8 @@ Hardware
The CONFIG_NUCLEO_CONSOLE_MORPHO configurations uses Serial Port 8 (USART8) The CONFIG_NUCLEO_CONSOLE_MORPHO configurations uses Serial Port 8 (USART8)
with TX on PE1 and RX on PE0. with TX on PE1 and RX on PE0.
Serial
Serial
------ ------
SERIAL_RX PE_0 SERIAL_RX PE_0
SERIAL_TX PE_1 SERIAL_TX PE_1
@ -262,21 +264,23 @@ Hardware
The CONFIG_NUCLEO_CONSOLE_MORPHO_UART4 configurations uses Serial Port 4 (UART4) The CONFIG_NUCLEO_CONSOLE_MORPHO_UART4 configurations uses Serial Port 4 (UART4)
with TX on PA1 and RX on PA0. Zero Ohm resistor / solder short at with TX on PA1 and RX on PA0. Zero Ohm resistor / solder short at
SB13 must be removed/open. (Disables Ethernet MII clocking.) SB13 must be removed/open. (Disables Ethernet MII clocking.)
Serial
------ Serial
SERIAL_RX PA_1 CN11 30 ------
SERIAL_TX PA_0 CN11 28 SERIAL_RX PA_1 CN11 30
SERIAL_TX PA_0 CN11 28
The CONFIG_NUCLEO_CONSOLE_VIRTUAL configurations uses Serial Port 3 (USART3) The CONFIG_NUCLEO_CONSOLE_VIRTUAL configurations uses Serial Port 3 (USART3)
with TX on PD8 and RX on PD9. with TX on PD8 and RX on PD9.
Serial
Serial
------ ------
SERIAL_RX PD9 SERIAL_RX PD9
SERIAL_TX PD8 SERIAL_TX PD8
These signals are internalaly connected to the on board ST-Link These signals are internally connected to the on board ST-Link.
Of course if your design has used those pins you can choose a completely Of course if your design has used those pins you can choose a completely
different U[S]ART to use as the console. In that Case, you will need to edit different U[S]ART to use as the console. In that Case, you will need to edit
the include/board.h to select different U[S]ART and / or pin selections. the include/board.h to select different U[S]ART and / or pin selections.
@ -491,7 +495,8 @@ Configurations
============== ==============
f7xx-nsh: f7xx-nsh:
---- ---------
Configures the NuttShell (nsh) located at apps/examples/nsh for the Configures the NuttShell (nsh) located at apps/examples/nsh for the
Nucleo-144 boards. The Configuration enables the serial interfaces Nucleo-144 boards. The Configuration enables the serial interfaces
on USART6. Support for builtin applications is enabled, but in the base on USART6. Support for builtin applications is enabled, but in the base
@ -505,8 +510,10 @@ f7xx-nsh:
a. Build and install the kconfig-mconf tool. See nuttx/README.txt a. Build and install the kconfig-mconf tool. See nuttx/README.txt
see additional README.txt files in the NuttX tools repository. see additional README.txt files in the NuttX tools repository.
b. If this is the intall configuration then Execute b. If this is the initial configuration then execute
'cd tools && ./configure.sh nucleo-144/nsh && cd ..'
./tools/configure.sh nucleo-144/nsh
in nuttx/ in order to start configuration process. in nuttx/ in order to start configuration process.
Caution: Doing this step more than once will overwrite .config with Caution: Doing this step more than once will overwrite .config with
the contents of the nucleo-144/nsh/defconfig file. the contents of the nucleo-144/nsh/defconfig file.
@ -550,7 +557,8 @@ f7xx-nsh:
be correct. be correct.
f7xx-evalos: f7xx-evalos:
------- ------------
This configuration is designed to test the features of the board. This configuration is designed to test the features of the board.
- Configures the NuttShell (nsh) located at apps/examples/nsh for the - Configures the NuttShell (nsh) located at apps/examples/nsh for the
Nucleo-144 boards. The console is available on serial interface USART3, Nucleo-144 boards. The console is available on serial interface USART3,
@ -567,8 +575,10 @@ f7xx-evalos:
a. Build and install the kconfig-mconf tool. See nuttx/README.txt a. Build and install the kconfig-mconf tool. See nuttx/README.txt
see additional README.txt files in the NuttX tools repository. see additional README.txt files in the NuttX tools repository.
b. If this is the intall configuration then Execute b. If this is the initial configuration then execute
'cd tools && ./configure.sh nucleo-144/evalos && cd ..'
./tools/configure.sh nucleo-144/evalos
in nuttx/ in order to start configuration process. in nuttx/ in order to start configuration process.
Caution: Doing this step more than once will overwrite .config with Caution: Doing this step more than once will overwrite .config with
the contents of the nucleo-144/evalos/defconfig file. the contents of the nucleo-144/evalos/defconfig file.

38
configs/nucleo-l496zg/README.txt
View File

@ -23,22 +23,20 @@ Nucleo-144 Boards:
================= =================
The Nucleo-144 is a standard board for use with several STM32 parts in the The Nucleo-144 is a standard board for use with several STM32 parts in the
LQFP144 package. Variants include LQFP144 package. Variants with a STM32L4 MCU include:
STM32 Part Board Variant Name STM32 Part Board Variant Name
------------- ------------------ ------------- ------------------
STM32F207ZGT6 NUCLEO-F207ZG
STM32F303ZET6 NUCLEO-F303ZE
STM32F429ZIT6 NUCLEO-F429ZI
STM32F446ZET6 NUCLEO-F446ZE
STM32F746ZGT6 NUCLEO-F746ZG
STM32F767ZIT6 NUCLEO-F767ZI
STM32L496ZGT6 NUCLEO-L496ZG STM32L496ZGT6 NUCLEO-L496ZG
STM32L496ZGT6P NUCLEO-L496ZG-P STM32L496ZGT6P NUCLEO-L496ZG-P
STM32L4A6ZGT6 NUCLEO-L4A6ZG
STM32L4R5ZIT6 NUCLEO-L4R5ZI
STM32L4R5ZIT6P NUCLEO-L4R5ZI-P
------------- ------------------ ------------- ------------------
This directory supports the STM32L4 variants of Nucleo-144. This directory supports only the STM32L4 variants of Nucleo-144. For others,
see configs/nucleo-144 configuration.
Please read the User Manual UM2179: Getting started with STM32 Nucleo board Please read the User Manual UM2179: Getting started with STM32 Nucleo board
software development tools and take note of the Powering options for the software development tools and take note of the Powering options for the
@ -111,11 +109,11 @@ Hardware
1) The I/O is 3.3 Volt not 5 Volt like on the Arduino products. 1) The I/O is 3.3 Volt not 5 Volt like on the Arduino products.
2) The Nucleo-144 board family has 3 pages of Solder Bridges AKA Solder 2) The Nucleo-144 board family has 3 pages of Solder Bridges AKA Solder
Blobs (SB) that can alter the factory configuration. We will note SB Blobs (SB) that can alter the factory configuration. We will note SB
in effect but will assume the facitory defualt settings. in effect but will assume the factory default settings.
Our main concern is establishing a console and LED utilization for Our main concern is establishing a console and LED utilization for
debugging. Because so many pins can be multiplexed with so many functions, debugging. Because so many pins can be multiplexed with so many functions,
the above mentioned graphic may be helpful in indentifying a serial port. the above mentioned graphic may be helpful in identifying a serial port.
There are 4 choices that can be made from the menuconfig: There are 4 choices that can be made from the menuconfig:
@ -123,10 +121,10 @@ Hardware
CONFIG_NUCLEO_CONSOLE_VIRTUAL or CONFIG_NUCLEO_CONSOLE_NONE CONFIG_NUCLEO_CONSOLE_VIRTUAL or CONFIG_NUCLEO_CONSOLE_NONE
The CONFIG_NUCLEO_CONSOLE_NONE makes no preset for the console. You should still visit The CONFIG_NUCLEO_CONSOLE_NONE makes no preset for the console. You should still visit
the U[S]ART selection and Device Drivers to disable any U[S]ART reamaing. the U[S]ART selection and Device Drivers to disable any U[S]ART remaining.
The CONFIG_NUCLEO_CONSOLE_ARDUINO configurations assume that you are using a The CONFIG_NUCLEO_CONSOLE_ARDUINO configurations assume that you are using a
standard Arduio RS-232 shield with the serial interface with RX on pin D0 and standard Arduino RS-232 shield with the serial interface with RX on pin D0 and
TX on pin D1 from USART6: TX on pin D1 from USART6:
-------- --------------- -------- ---------------
@ -139,21 +137,23 @@ Hardware
The CONFIG_NUCLEO_CONSOLE_MORPHO configurations uses Serial Port 8 (USART8) The CONFIG_NUCLEO_CONSOLE_MORPHO configurations uses Serial Port 8 (USART8)
with TX on PE1 and RX on PE0. with TX on PE1 and RX on PE0.
Serial
Serial
------ ------
SERIAL_RX PE_0 SERIAL_RX PE_0
SERIAL_TX PE_1 SERIAL_TX PE_1
The CONFIG_NUCLEO_CONSOLE_VIRTUAL configurations uses Serial Port 3 (USART3) The CONFIG_NUCLEO_CONSOLE_VIRTUAL configurations uses Serial Port 3 (USART3)
with TX on PD8 and RX on PD9. with TX on PD8 and RX on PD9.
Serial
Serial
------ ------
SERIAL_RX PD9 SERIAL_RX PD9
SERIAL_TX PD8 SERIAL_TX PD8
These signals are internally connected to the on board ST-Link These signals are internally connected to the on board ST-Link
Of course if your design has used those pins you can choose a completely Of course if your design has used those pins you can choose a completely
different U[S]ART to use as the console. In that Case, you will need to edit different U[S]ART to use as the console. In that Case, you will need to edit
the include/board.h to select different U[S]ART and / or pin selections. the include/board.h to select different U[S]ART and / or pin selections.
@ -316,11 +316,13 @@ nsh:
a. Build and install the kconfig-mconf tool. See nuttx/README.txt a. Build and install the kconfig-mconf tool. See nuttx/README.txt
see additional README.txt files in the NuttX tools repository. see additional README.txt files in the NuttX tools repository.
b. If this is the intall configuration then Execute b. If this is the initial configuration then execute
'cd tools && ./configure.sh nucleo-144/nsh && cd ..'
./tools/configure.sh nucleo-l496zg/nsh
in nuttx/ in order to start configuration process. in nuttx/ in order to start configuration process.
Caution: Doing this step more than once will overwrite .config with Caution: Doing this step more than once will overwrite .config with
the contents of the nucleo-144/nsh/defconfig file. the contents of the nucleo-l496zg/nsh/defconfig file.
c. Execute 'make oldconfig' in nuttx/ in order to refresh the c. Execute 'make oldconfig' in nuttx/ in order to refresh the
configuration. configuration.