Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/smittytone/pi-pico
Assorted projects made while playing with the Raspberry Pi Pico
https://github.com/smittytone/pi-pico
c cpp micropython raspberry-pi-pico
Last synced: 5 days ago
JSON representation
Assorted projects made while playing with the Raspberry Pi Pico
- Host: GitHub
- URL: https://github.com/smittytone/pi-pico
- Owner: smittytone
- License: mit
- Created: 2021-01-28T16:47:59.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-17T21:24:40.000Z (22 days ago)
- Last Synced: 2024-12-17T22:19:06.387Z (22 days ago)
- Topics: c, cpp, micropython, raspberry-pi-pico
- Language: C++
- Homepage: https://smittytone.net
- Size: 3.35 MB
- Stars: 52
- Watchers: 8
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# pi-pico
Assorted projects made while playing with the [Raspberry Pi Pico](https://www.raspberrypi.org/documentation/pico/getting-started/).
## Projects
* [Cellular IoT Demo](#cellular-iot-demo-102)
* [Phantom Slayer](#phantom-slayer-102)
* [Hunt the Wumpus](#hunt-the-wumpus-102)
* [Sensor](#sensor)
* [I2C](#i2c)
* [Micropython](#micropython)
* [Makepico](#makepico-210)
**Note** [Makepico](#makepico-210) is a script for creating ready-to-use Pico projects. The other items are Pico demos and games.
## Tooling
#### Build Tools
This repo requires `cmake` and the ARM cross-compiler. Please install these as appropriate for your platform. [Details for macOS users can be found in this blog post](https://blog.smittytone.net/2021/02/02/program-raspberry-pi-pico-c-mac/).
#### The Pico SDK
This repo also requires the Pico SDK. From tag 2.0.0 of the repo, the SDK is included as a submodule. To load the code, navigate to the repo directory on your machine and run:
```shell
git submodule update --init --recursive
```
To update the SDK in future, run:
```shell
git submodule update --remote --recursive
```
Set your environment's `PICO_SDK_PATH` variable to point to this `pico-sdk` directory.
**Note** If you already have a global copy of the Pico SDK, you don't need to initialize the submodule here.
---
## Cellular IoT Demo 1.0.2
A sample C++ project bringing the Pico and the [Waveshare Pico SIM7080G Cat-M1 modem board](https://www.waveshare.com/pico-sim7080g-cat-m-nb-iot.htm) together.
### Requirements
* Waveshare’s Pico SIM7080G Cat-M1/NB-IoT — get it [direct from Waveshare](https://www.waveshare.com/pico-sim7080g-cat-m-nb-iot.htm).
* An HT16K33-based four-digit, seven-segment display; I used [this one](https://www.adafruit.com/product/879).
* An MCP9808 thermal sensor breakout board; here’s a [good one](https://www.adafruit.com/product/1782).
* Wires.
* One large, or two standard-size, breadboards.
### Hardware
This is the circuit layout:
### Build the Code
* Use Visual Studio Code with the [CMake](https://marketplace.visualstudio.com/items?itemName=twxs.cmake) and [CMakeTools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools) extensions:
1. Click **No active kit** to select your compiler, `GCC 10.3.1 arm-none-eabi`:
1. Click **Build**:
* From the command line:
1. `cd /pi-pico/cellular-iot-demo`
1. `cmake -S . -B build/`
1. `cmake --build build --clean-first`
### Usage
The device accepts commands in JSON form. For example:
```json
{"cmd": "num", "val": 2021}
```
The JSON string must be converted to a base64 string for transmission by SMS:
```bash
SEND_DATA=$(echo '{"cmd": "num", "val": 2021}' | base64)
```
You can then send the SMS. For example, using [Twilio Super SIM]():
```bash
curl -X POST https://supersim.twilio.com/v1/SmsCommands \
--data-urlencode "${SIM_SID}" \
--data-urlencode "Payload=${SEND_DATA}" \
-u "${ACCOUNT_SID}:${ACCOUNT_AUTH_TOKEN}"
```
You will need shell variables for your Super SIM’s SID, and your Twilio account SID and authorisation token. Different brands of SIM will have different settings, of course.
Alternatively, just punch those values into the `cmd.sh` script that’s included and call it with two arguments. For example"
```bash
./cmd.sh num 9876
```
will send (base64 encoded):
```json
{"cmd": "num", "val": 9876}
```
Commands available from the device:
* `led` — flash the Pico LED. Requires a `val` object with the number of flashes as an integer.
* `num` — write a value on the display. Requires a `val` object with the number (between 0 and 9999) as an integer.
* `tmp` — Send back a Celsius temperature reading. Requires your Super SIM’s fleet to be configured with an SMS Commands webhook, or equivalent for other brands of SIM. Super SIM device-originated SMS Commands are sent to the number 000, so you will need to alter that value in the code (in `modem.cpp`). It also requires server-side code to process or display the received data.
* `tmpcon` - Continuous temperature readout on the LED, but not data is posted elswhere.
* `flash` — flash a code on the LED. Requires a `code` object with a string pattern, eg. `LBSBL` where:
* `L` — Long on (500ms)
* `S` — Short on (250ms)
* `B` - Short off (250ms)
* `rssi` - Continuous RSSI readout on the LED.
### Credits
This project uses the following third-party code:
* [ArduinoJson](https://github.com/bblanchon/ArduinoJson) © 2014-2021, Benoit Blanchon, MIT licence.
* [Base64](https://github.com/ReneNyffenegger/cpp-base64) © 2004-2021, René Nyffenegger. ZLib licence.
---
## Phantom Slayer 1.0.3
A retro-style 3D arcade game written in C. For more details, [see this page](https://smittytone.net/pico-phantoms/).
#### Requirements
* An SSD1306-based 128x64 OLED display; I used [this display](https://www.adafruit.com/product/326).
* A piezo speaker.
* Two small buttons.
* A two-way, self-centring analog joystick; there are [lots available on eBay](https://www.ebay.co.uk/itm/New-PSP-2-Axis-Analog-Thumb-GAME-Joystick-Module-3V-5V-For-arduino-PSP/401104248437?hash=item5d63ad1e75:g:HcEAAOSwjqVZNSzw).
* Wires.
* Two standard breadboards.
### Hardware
The joystick shown is not the one used, but it gives you the idea. Connect purple to the X pin, white to the Y pin.
### The Code
Build from source code, or copy `phantoms.uf2` to your Pico. Please check the SHA 256:
```
d9e4e2d28b8a5b983e1551d114cd4ae6d668858b43a9df6c92f946327a96f146
```
### Build the Code
* Use Visual Studio Code with the [CMake](https://marketplace.visualstudio.com/items?itemName=twxs.cmake) and [CMakeTools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools) extensions:
1. Click **No active kit** to select your compiler, `GCC 10.3.1 arm-none-eabi`:
1. Click **Build**:
* From the command line:
1. `cd /pi-pico/phantoms`
1. `cmake -S . -B build/`
1. `cmake --build build --clean-first`
### The Game
See [this blog post for full details](https://blog.smittytone.net/2021/03/26/3d-arcade-action-courtesy-of-raspberry-pi-pico/).
### Credits
This games is based on a 1982 original created by Ken Kalish of Med Systems for the Tandy Color Computer. The design is Ken’s; the code is mine, and I’ve taken only a few liberties with certain details.
Phantom Slayer uses [TinyMT](https://github.com/MersenneTwister-Lab/TinyMT), copyright © 2011 Mutsuo Saito, Makoto Matsumoto, Hiroshima University and The University of Tokyo. All rights reserved. Licensed under the [three-clause BSD Licence](/phantoms/TinyMT-Licence.txt).
---
## Hunt the Wumpus 1.0.2 ##
A sample C project to build a fun game.
### Requirements
* An HT16K33-based 8x8 LED matrix; I used [this display](https://www.adafruit.com/product/1049).
* A piezo speaker.
* One small button.
* A two-way, self-centring analog joystick; there are [lots available on eBay](https://www.ebay.co.uk/itm/New-PSP-2-Axis-Analog-Thumb-GAME-Joystick-Module-3V-5V-For-arduino-PSP/401104248437?hash=item5d63ad1e75:g:HcEAAOSwjqVZNSzw).
* A red LED.
* A green LED.
* Wires.
* Two standard breadboards.
### Hardware
* Make sure you wire the LEDs correctly: longer leg to the Pico pin, shorter leg to GND.
* The joystick shown is not the one used, but it gives you the idea. Connect white to the X pin, blue to the Y pin.
### The Code
Build from source code, or copy `wumpus.uf2` to your Pico. Please check the SHA 256:
```
65957c643df25f89ddd3f70f16131c7037e582fa04743c35b7af78b90eb0a0f5
```
### Build the Code
* Use Visual Studio Code with the [CMake](https://marketplace.visualstudio.com/items?itemName=twxs.cmake) and [CMakeTools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools) extensions:
1. Click **No active kit** to select your compiler, `GCC 10.3.1 arm-none-eabi`:
1. Click **Build**:
* From the command line:
1. `cd /pi-pico/wumpus`
1. `cmake -S . -B build/`
1. `cmake --build build --clean-first`
### The Game
This is a fun little game to hunt the Wumpus. Move through the cave with the joystick.
A red light indicates a nearby pit — if you fall in, you’ll be killed.
A twittering sound indicates a nearby bat. If you enter its square, it will carry you to another part of the cave.
A green light indicates the Wumpus is close. Enter its square and it will eat you, but if you’re sure where it is, press the button to fire an arrow to kill it first. To fire the arrow successfully, back off and then move toward the Wumpus in the direction you want to the arrow to fly. If you miss, the beast will catch you!
### Credits
This version was based on an [Arduino version](https://github.com/coreyfaure/HuntTheWumpus-Arduino) created by Corey Faure. This is very much his game, but I have taken a few liberties with a couple of the animations and rewritten the code.
Hunt the Wumpus uses [TinyMT](https://github.com/MersenneTwister-Lab/TinyMT), copyright © 2011 Mutsuo Saito, Makoto Matsumoto, Hiroshima University and The University of Tokyo. All rights reserved. Licensed under the [three-clause BSD Licence](/wumpus/TinyMT-Licence.txt).
---
## Sensor
A sample C project. Requires an HT16K33-based 4-digit, 7-segment LED and an SGP30 TVOC sensor. I used [this sensor](https://shop.pimoroni.com/products/sgp30-air-quality-sensor-breakout) and [this display](https://www.adafruit.com/product/878):
---
## I2C
A sample C project. Requires an HT16K33-based 8x8 LED matrix. I used [this display](https://www.adafruit.com/product/1049).
---
## Micropython
A sample MicroPython project. Requires an HT16K33-based 8x8 LED matrix.
---
## makepico 2.1.0
Pico project set up script for Z Shell. Requires Pico C SDK pre-installed.
---
All source code released under the MIT Licence. Copyright © 2022, Tony Smith (@smittytone).