2021-02-19 15:40:03 +01:00
|
|
|
README
|
|
|
|
|
======
|
|
|
|
|
|
|
|
|
|
This directory contains the port of NuttX to the Raspberry Pi Pico.
|
|
|
|
|
See https://www.raspberrypi.org/products/raspberry-pi-pico/ for information
|
|
|
|
|
about Raspberry Pi Pico.
|
|
|
|
|
|
|
|
|
|
Currently only the following devices are suppored.
|
|
|
|
|
|
|
|
|
|
Supported:
|
|
|
|
|
- UART (console port)
|
|
|
|
|
- GPIO 0 (UART0 TX) and GPIO 1 (UART0 RX) are used for the console.
|
2021-03-02 14:50:57 +01:00
|
|
|
- I2C
|
2021-03-08 16:11:12 +01:00
|
|
|
- SPI
|
|
|
|
|
- DMAC
|
2021-02-19 15:40:03 +01:00
|
|
|
- Flash ROM Boot
|
|
|
|
|
- SRAM Boot
|
|
|
|
|
- If Pico SDK is available, nuttx.uf2 file which can be used in
|
|
|
|
|
BOOTSEL mode will be created.
|
2021-03-09 19:50:02 +01:00
|
|
|
- BMP180 sensor at I2C0 (don't forget to define I2C0 GPIOs at "I2C0 GPIO pin assign" in Board Selection menu)
|
2021-03-11 03:01:02 +01:00
|
|
|
- INA219 sensor / module (don't forget to define I2C0 GPIOs at "I2C0 GPIO pin assign" in Board Selection menu)
|
2021-02-19 15:40:03 +01:00
|
|
|
|
|
|
|
|
Not supported:
|
|
|
|
|
- All other devices
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
1. Download Raspberry Pi Pico SDK
|
|
|
|
|
|
|
|
|
|
$ git clone -b master https://github.com/raspberrypi/pico-sdk.git
|
|
|
|
|
|
|
|
|
|
2. Set PICO_SDK_PATH environment variable
|
|
|
|
|
|
|
|
|
|
$ export PICO_SDK_PATH=<absolute_path_to_pico-sdk_directory>
|
|
|
|
|
|
|
|
|
|
3. Configure and build NuttX
|
|
|
|
|
|
|
|
|
|
$ git clone https://github.com/apache/incubator-nuttx.git nuttx
|
|
|
|
|
$ git clone https://github.com/apache/incubator-nuttx-apps.git apps
|
|
|
|
|
$ cd nuttx
|
|
|
|
|
$ make distclean
|
|
|
|
|
$ ./tools/configure.sh raspberrypi-pico:nsh
|
|
|
|
|
$ make V=1
|
|
|
|
|
|
|
|
|
|
4. Connect Raspberry Pi Pico board to USB port while pressing BOOTSEL.
|
|
|
|
|
The board will be detected as USB Mass Storage Device.
|
|
|
|
|
Then copy "nuttx.uf2" into the device.
|
|
|
|
|
(Same manner as the standard Pico SDK applications installation.)
|
|
|
|
|
|
|
|
|
|
5. To access the console, GPIO 0 and 1 pins must be connected to the
|
|
|
|
|
device such as USB-serial converter.
|
|
|
|
|
|
2021-03-02 14:50:57 +01:00
|
|
|
Defconfigs
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
- nsh
|
2021-03-05 15:11:37 +01:00
|
|
|
Minimum configuration with NuttShell
|
2021-03-02 14:50:57 +01:00
|
|
|
|
|
|
|
|
- nshsram
|
|
|
|
|
Load NuttX binary to SRAM
|
|
|
|
|
|
|
|
|
|
- smp
|
|
|
|
|
Enable SMP mode. Both Core 0 and Core 1 are used by NuttX.
|
|
|
|
|
|
|
|
|
|
- ssd1306
|
|
|
|
|
SSD1306 OLED display (I2C) test configuration
|
|
|
|
|
Connection:
|
|
|
|
|
SSD1306 Raspberry Pi Pico
|
|
|
|
|
GND ----- GND (Pin 3 or 38 or ...)
|
|
|
|
|
VCC ----- 3V3 OUT (Pin 36)
|
|
|
|
|
SDA ----- GP4 (I2C0 SDA) (Pin 6)
|
|
|
|
|
SCL ----- GP5 (I2C0 SCL) (Pin 7)
|
|
|
|
|
|
2021-03-05 15:11:37 +01:00
|
|
|
- spisd
|
|
|
|
|
SD card support (SPI connection)
|
|
|
|
|
Connection:
|
|
|
|
|
SD card slot Raspberry Pi Pico
|
|
|
|
|
DAT2 (NC)
|
|
|
|
|
DAT3/CS ----- GP17 (SPI0 CSn) (Pin 22)
|
|
|
|
|
CMD /DI ----- GP19 (SPI0 TX) (Pin 25)
|
|
|
|
|
VDD ----- 3V3 OUT (Pin 36)
|
|
|
|
|
CLK/SCK ----- GP18 (SPI0 SCK) (Pin 24)
|
|
|
|
|
VSS ----- GND (Pin 3 or 38 or ...)
|
|
|
|
|
DAT0/DO ----- GP16 (SPI0 RX) (Pin 21)
|
|
|
|
|
DAT1 (NC)
|
|
|
|
|
* Card hot swapping is not supported.
|
|
|
|
|
|
2021-02-19 15:40:03 +01:00
|
|
|
License exceptions
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
The following files are originated from the files in Pico SDK.
|
|
|
|
|
So, the files are licensed under 3-Clause BSD same as Pico SDK.
|
|
|
|
|
|
|
|
|
|
- arch/arm/src/rp2040/rp2040_clock.c
|
|
|
|
|
- arch/arm/src/rp2040/rp2040_pll.c
|
|
|
|
|
- arch/arm/src/rp2040/rp2040_xosc.c
|
|
|
|
|
- These are created by referring the Pico SDK clock initialization.
|
|
|
|
|
|
|
|
|
|
- arch/arm/src/rp2040/hardware/*.h
|
|
|
|
|
- These are generated from rp2040.svd originally provided in Pico SDK.
|
