pi-pico

Assorted projects made while playing with the Raspberry Pi Pico.

Projects

• Cellular IoT Demo
• Phantom Slayer
• Hunt the Wumpus
• Sensor
• I2C
• Micropython
• Makepico

Note Makepico is a script for creating ready-to-use Pico projects. The other items are Pico demos and games.

---

Cellular IoT Demo 1.0.2

A sample C++ project bringing the Pico and the Waveshare Pico SIM7080G Cat-M1 modem board together.

Requirements

• Waveshare’s Pico SIM7080G Cat-M1/NB-IoT — get it direct from Waveshare.
• An HT16K33-based four-digit, seven-segment display; I used this one.
• An MCP9808 thermal sensor breakout board; here’s a good one.
• Wires.
• One large, or two standard-size, breadboards.

Hardware

This is the circuit layout:

Build the Code

• Use Visual Studio Code with the CMake and CMakeTools extensions:
  1. Click No active kit to select your compiler, GCC 10.3.1 arm-none-eabi:
     
  2. Click Build:
     
• From the command line:
  1. cd <YOUR_GIT_DIRECTORY>/pi-pico/cellular-iot-demo
  2. cmake -S . -B build/
  3. cmake --build build --clean-first

Usage

The device accepts commands in JSON form. For example:

{"cmd": "num", "val": 2021}

The JSON string must be converted to a base64 string for transmission by SMS:

SEND_DATA=$(echo '{"cmd": "num", "val": 2021}' | base64)

You can then send the SMS. For example, using Twilio Super SIM:

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"

./cmd.sh num 9876

will send (base64 encoded):

{"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 © 2014-2021, Benoit Blanchon, MIT licence.
• Base64 © 2004-2021, René Nyffenegger. ZLib licence.

---

Phantom Slayer 1.0.2

A retro-style 3D arcade game written in C. For more details, see this page.

Requirements

• An SSD1306-based 128x64 OLED display; I used this display.
• A piezo speaker.
• Two small buttons.
• A two-way, self-centring analog joystick; there are lots available on eBay.
• 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 and CMakeTools extensions:
  1. Click No active kit to select your compiler, GCC 10.3.1 arm-none-eabi:
     
  2. Click Build:
     
• From the command line:
  1. cd <YOUR_GIT_DIRECTORY>/pi-pico/phantoms
  2. cmake -S . -B build/
  3. cmake --build build --clean-first

The Game

See this blog post for full details.

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, copyright © 2011 Mutsuo Saito, Makoto Matsumoto, Hiroshima University and The University of Tokyo. All rights reserved. Licensed under the three-clause BSD Licence.

---

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.
• A piezo speaker.
• One small button.
• A two-way, self-centring analog joystick; there are lots available on eBay.
• 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 and CMakeTools extensions:
  1. Click No active kit to select your compiler, GCC 10.3.1 arm-none-eabi:
     
  2. Click Build:
     
• From the command line:
  1. cd <YOUR_GIT_DIRECTORY>/pi-pico/wumpus
  2. cmake -S . -B build/
  3. 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 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, copyright © 2011 Mutsuo Saito, Makoto Matsumoto, Hiroshima University and The University of Tokyo. All rights reserved. Licensed under the three-clause BSD Licence.

---

Sensor

A sample C project. Requires an HT16K33-based 4-digit, 7-segment LED and an SGP30 TVOC sensor. I used this sensor and this display:

---

I2C

A sample C project. Requires an HT16K33-based 8x8 LED matrix. I used this display.

---

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.

---

Updates

• 2 November 2022
  • Bring some programs up to date.
• 1 March 2022
  • Improve Cellular IoT Demo commenting.
  • Add tmpcon and rssi commands to Cellular IoT Demo.
• 3 September 2021
  • Complete Cellular IoT Demo — add POST ops and various improvements.
• 20 August 2021
  • Add Cellular IoT Demo.
• 13 August 2021
  • makepico now generates main.c/cpp and main.h not project-specific files.
  • makepico’s CMakeLists.txt now uses CMake 3.14.
  • makepico’s main.c now calls stdio_init_all().
• 23 July 2021
  • Spring clean makepico and bump to 2.0.0.
• 30 April 2021
  • Update makepico to support C++ projects:
    • Add -c switch to create a C++ project.
    • Add a -n option so you can add your name for code comments.
• 6 April 2021
  • Bump Phantom Slayer to 1.0.2
    • Move some common routines into utils.h/utils.c.
    • Update inkey() to return the key pressed.
    • Add another map.
• 31 March 2021
  • Bump Phantom Slayer to 1.0.1
    • Graphics tweaks.
    • Improve Phantom movement logic.
    • Fix laser post-fire delay.
  • Bump Hunt the Wumpus to 1.0.2
    • Use TinyMT for random number generation.
  • Bump makepico to 1.2.0.
• 26 March 2021
  • Add Phantom Slayer 1.0.0
• 25 February 2021
  • Bump Wumpus to 1.0.1
    • Tweak sprites.
    • Improve trophy presentation.
    • Improve in-game code flow.
• 20 February 2021
  • Add wumpus example.
  • Update makepico script:
    • Add VSCode config creation.
    • Add -d/--debug switch to add VSCode SWD debugging support.
• 5 February 2021
  • Add sensor example.
• 4 February 2021
  • Add debugger-friendly VSCode launch.json.
• 2 February 2021
  • Initial release.

All source code released under the MIT Licence. Copyright © 2022, Tony Smith (@smittytone).