picoco/README.md
2025-02-21 12:50:04 +01:00

88 lines
3.0 KiB
Markdown

# Picoco
A repository to store Rasbperry Pico C sample projects.
It uses the **Freenove Super Starter Kit For Raspberry Pi Pico**, the tutorial and ressources can be found [here](https://github.com/Freenove/Freenove_Super_Starter_Kit_for_Raspberry_Pi_Pico).
The official documentation to start with the Raspberry Pi Pico: [Getting started with Raspberry Pi Pico-series](https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf) and the [C SDK documentation](https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-c-sdk.pdf). Some examples can be found here: [github.com/raspberrypi/pico-examples](https://github.com/raspberrypi/pico-examples).
**NOTE**: the configuration defined in `config/FreeRTOSConfig.h` is specific for the **Raspberry Pi Pico 2 RP2350**. Feel free to update it for your Pico spec.
The FreeRTOS documentation can found here: [FreeRTOS book](https://freertos.org/Documentation/02-Kernel/07-Books-and-manual/01-RTOS_book).
## Installation
In order to build and deploy the binary in the Raspberry Pi Pico, you have to install the **Pico C SDK**, **Picotool** & **FreeRTOS Raspberry Kernel**.
So, you need to execute the following command that will installed all:
```bash
make install
```
**NOTE**: this will install the **SDK**, **Picotool** and **FreeRTOS** in the current directory. If you want to set an other intallation path,
set the `INSTALL_PATH` variable. The `INSTALL_PATH` directory must exists, create it before and make sure user have write rights.
The **SDK** and **Picotool** version used is: **2.1.0**.
## Generate a project
You can generate a new Pico C project with the command:
```
make project name=<project_name>
```
It will create a new project in the current directory and build it.
## Compile
Update you `main.c` file and then launch:
```
make compile name=<project_name>
```
It will generate the `.elf` file in the `build` directory.
## Load binary into the device
You can combine both **compilation** and **load** with the following command:
```bash
make push name=<project_name>
```
**NOTE**: you have to USB plug your Pico device in **BOOTSEL** mode before executing the command.
After the load, the device will automatically reboot and be unpluged. And the program freshly pushed will start.
## Get device info
When plugging your device in **BOOTSEL** mode, you can get the device information using:
```bash
make info
Program Information
name: simple_led
version: 0.1
binary start: 0x10000000
binary end: 0x10001744
target chip: RP2350
image type: ARM Secure
Fixed Pin Information
none
Build Information
sdk version: 2.1.0
pico_board: pico2
boot2_name: boot2_w25q080
build date: Feb 18 2025
build attributes: Release
Metadata Block 1
address: 0x10000138
next block address: 0x10001730
block type: image def
target chip: RP2350
image type: ARM Secure
```