410ac71b70
" I used cd nuttx cmake -B build -DBOARD_CONFIG=stm32f401rc-rs485:nsh -GNinja to config and when following the instruction in this official websites I found the command to use cmake to build the target is wrong. which is "cmake --build build -t menuconfig" also wrong the output dir "build/nuttx". and by the way, In my practice I find the bin file and elf file is not in build/nuttx but in build/. So I changed these. But I'm not 100% sure that my fix is right as I'm a beginner, but what I fix works fine in my computer. This is my first PR to the public doc. My fix maybe totally wrong as I am not get into the nuttx, just following the instruction and encountered some mistakes. thx for reviewing "
60 lines
1.6 KiB
ReStructuredText
60 lines
1.6 KiB
ReStructuredText
====================
|
|
Compiling with CMake
|
|
====================
|
|
|
|
Initialize Configuration with CMake
|
|
===================================
|
|
|
|
The first step is to initialize NuttX configuration for a given board, based on
|
|
a pre-existing configuration. To list all supported configurations you can do:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd nuttx
|
|
$ ./tools/configure.sh -L | less
|
|
|
|
The output is in the format ``<board name>:<board configuration>``. You will see that
|
|
generally all boards support the ``nsh`` configuration which is a good starting point
|
|
since it enables booting into the interactive command line
|
|
:doc:`/applications/nsh/index`.
|
|
|
|
To choose a configuration you pass the ``<board name>:<board configuration>`` such as:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd nuttx
|
|
$ cmake -B build -DBOARD_CONFIG=stm32f4discovery:nsh -GNinja
|
|
|
|
The ``-B build`` tells what is the build directory.
|
|
|
|
You can then customize this configuration by using the menu based
|
|
configuration system with:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd nuttx
|
|
$ cmake --build build -t menuconfig
|
|
|
|
Modifying the configuration is covered in :doc:`configuring`.
|
|
|
|
Build NuttX with CMake
|
|
======================
|
|
|
|
We can now build NuttX. To do so, you can simply run:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd nuttx
|
|
$ cmake --build build
|
|
|
|
The build will complete by generating the binary outputs
|
|
inside ``build/`` directory. Typically this includes the ``nuttx``
|
|
ELF file (suitable for debugging using ``gdb``) and a ``nuttx.bin``
|
|
file that can be flashed to the board.
|
|
|
|
To clean the build, you can do:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cmake --build build -t clean
|