REAMDE.md improvements

Fix the order of the steps (fixes #133) and make it clearer that step 2 is choose-just-one-option
This commit is contained in:
Andrew Scheller 2021-02-17 13:46:24 +00:00 committed by Graham Sanderson
parent 2fa84c7743
commit 9fbfa1fcbc

View File

@ -42,7 +42,7 @@ instructions for other platforms, and just in general, we recommend you see [Ras
``` ```
1. Set up your project to point to use the Raspberry Pi Pico SDK 1. Set up your project to point to use the Raspberry Pi Pico SDK
* By cloning the SDK locally (most common) * Either by cloning the SDK locally (most common) :
1. `git clone` this Raspberry Pi Pico SDK repository 1. `git clone` this Raspberry Pi Pico SDK repository
1. Copy [pico_sdk_import.cmake](https://github.com/raspberrypi/pico-sdk/blob/master/external/pico_sdk_import.cmake) 1. Copy [pico_sdk_import.cmake](https://github.com/raspberrypi/pico-sdk/blob/master/external/pico_sdk_import.cmake)
from the SDK into your project directory from the SDK into your project directory
@ -65,7 +65,7 @@ instructions for other platforms, and just in general, we recommend you see [Ras
``` ```
* With the Raspberry Pi Pico SDK as a submodule * Or with the Raspberry Pi Pico SDK as a submodule :
1. Clone the SDK as a submodule called `pico-sdk` 1. Clone the SDK as a submodule called `pico-sdk`
1. Setup a `CMakeLists.txt` like: 1. Setup a `CMakeLists.txt` like:
@ -85,7 +85,7 @@ instructions for other platforms, and just in general, we recommend you see [Ras
``` ```
* With automatic download from github * Or with automatic download from github :
1. Copy [pico_sdk_import.cmake](https://github.com/raspberrypi/pico-sdk/blob/master/external/pico_sdk_import.cmake) 1. Copy [pico_sdk_import.cmake](https://github.com/raspberrypi/pico-sdk/blob/master/external/pico_sdk_import.cmake)
from the SDK into your project directory from the SDK into your project directory
1. Setup a `CMakeLists.txt` like: 1. Setup a `CMakeLists.txt` like:
@ -110,16 +110,7 @@ instructions for other platforms, and just in general, we recommend you see [Ras
``` ```
3. Setup a CMake build directory. 1. Write your code (see [pico-examples](https://github.com/raspberrypi/pico-examples) or the [Raspberry Pi Pico C/C++ SDK](https://rptl.io/pico-c-sdk) documentation for more information)
For example, if not using an IDE:
```
$ mkdir build
$ cd build
$ cmake ..
```
4. Write your code (see [pico-examples](https://github.com/raspberrypi/pico-examples) or the [Raspberry Pi Pico C/C++ SDK](https://rptl.io/pico-c-sdk) documentation
for more information)
About the simplest you can do is a single source file (e.g. hello_world.c) About the simplest you can do is a single source file (e.g. hello_world.c)
@ -151,10 +142,17 @@ for more information)
if you want to use the default USB see the [hello-usb](https://github.com/raspberrypi/pico-examples/tree/master/hello_world/usb) example. if you want to use the default USB see the [hello-usb](https://github.com/raspberrypi/pico-examples/tree/master/hello_world/usb) example.
5. Make your target from the build directory you created. 1. Setup a CMake build directory.
For example, if not using an IDE:
```
$ mkdir build
$ cd build
$ cmake ..
```
1. Make your target from the build directory you created.
```sh ```sh
$ make hello_world $ make hello_world
``` ```
6. You now have `hello_world.elf` to load via a debugger, or `hello_world.uf2` that can be installed and 1. You now have `hello_world.elf` to load via a debugger, or `hello_world.uf2` that can be installed and run on your Raspberry Pi Pico via drag and drop.
run on your Raspberry Pi Pico via drag and drop.