v01d commented on a change in pull request #1675: URL: https://github.com/apache/incubator-nuttx/pull/1675#discussion_r479845241
########## File path: Documentation/quickstart/quickstart.rst ########## @@ -0,0 +1,107 @@ +.. include:: /substitutions.rst +.. _quickstart: + +Quickstart +========== + +Here's the quick version of getting things going. This is a bare-bones outline for experienced developers– if it's +going too quickly, dive into the other sections of the Companion. This Quickstart guide assumes you're on a Linux +computer, you're using an ARM processor on your embedded board, and you're familiar with using the command line. + +#. Install a Cross-Compiler Toolchain + + With NuttX, you compile the operating system and your application on your desktop or laptop computer, then install the + binary file on your embedded computer. This guide assumes your computer is an + `ARM <https://en.wikipedia.org/wiki/ARM_architecture>`_ CPU. If it isn't, you'll need a different tool chain. + + Download the right flavor of the + `ARM Embedded Gnu Toolchain <https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm>`_ + for your embedded processor's CPU. + + Unpack it into ``/opt/gcc`` and add the bin directory to your path. For instance: + + .. code-block:: bash + + $ sudo mkdir /opt/gcc + $ sudo chgrp -R users /opt/gcc + $ cd /opt/gcc + $ wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/9-2019q4/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2?revision=108bd959-44bd-4619-9c19-26187abf5225&la=en&hash=E788CE92E5DFD64B2A8C246BBA91A249CB8E2D2D + $ tar xf gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2 + $ # add the toolchain bin/ dir to your path... + $ # you can edit your shell's rc files if you don't use bash + $ echo "export PATH=/opt/gcc/gcc-arm-none-eabi-9-2019-q4-major/bin:$PATH" >> ~/.bashrc Review comment: ```suggestion In the following example, we download ``gcc-arm-none-eabi`` version 9.0 and unpack it into ``/opt/gcc`: .. code-block:: console $ sudo mkdir /opt/gcc $ sudo chgrp -R users /opt/gcc $ cd /opt/gcc $ wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/9-2019q4/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2 $ tar xf gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2 Then, add the toolchain ``bin/`` directory to your path: .. code-block:: console $ echo "export PATH=/opt/gcc/gcc-arm-none-eabi-9-2019-q4-major/bin:$PATH" >> ~/.bashrc If you are using any other shell, the procedure is similar by editing the corresponding rc file. ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected]
