pimoroni-pico/micropython/examples/inky_frame/README.md

111 wiersze
4.0 KiB
Markdown
Czysty Zwykły widok Historia

2022-07-19 17:54:44 +00:00
# Pico Inky Frame MicroPython Examples <!-- omit in toc -->
- [PicoGraphics](#picographics)
- [Examples](#examples)
2022-07-22 18:17:39 +00:00
- [Button Test](#button-test)
2023-03-14 14:29:20 +00:00
- [Carbon Intensity](#carbon-intensity)
- [Daily Activity](#daily-activity)
2023-03-13 17:12:29 +00:00
- [Dithering](#dithering)
2022-07-22 18:17:39 +00:00
- [Image Gallery](#image-gallery)
2022-07-25 12:42:21 +00:00
- [LED PWM](#led-pwm)
- [News](#news)
- [PlaceKitten](#placekitten)
- [Quote of the Day](#quote-of-the-day)
- [Random Joke](#random-joke)
2023-03-13 17:12:29 +00:00
- [RTC Demo](#rtc-demo)
2022-07-28 17:39:12 +00:00
- [SD Card Test](#sd-card-test)
- [XKCD Daily](#xkcd-daily)
## PicoGraphics
You can draw on Inky Frame using our tiny PicoGraphics display library.
- [PicoGraphics MicroPython function reference](../../modules/picographics)
## Examples
2022-07-22 18:17:39 +00:00
The wireless examples need `network_manager.py` and `WIFI_CONFIG.py` from the `common` directory to be saved to your Pico W. Open up `WIFI_CONFIG.py` in Thonny to add your wifi details (and save it when you're done).
You'll also need to install the `micropython-urllib.urequest` library using Thonny's 'Tools' > 'Manage Packages' or `common/lib/urllib` which contains a compiled `.mpy` version that uses less RAM. You should place this directory in `lib` on your Pico W.
2022-07-22 18:17:39 +00:00
### Button Test
[button_test.py](button_test.py)
2022-07-28 17:39:12 +00:00
Inky Frame's buttons (and the RTC alarm, busy signal from the screen and external trigger from the hack header) are connected to a shift register to help conserve pins, and to allow these inputs to wake the board up from sleep.
This example demonstrates a simple way of reading when a button has been pushed by reading the shift register and checking if the bit in a specific position is 0 or 1.
2022-07-22 18:17:39 +00:00
2023-03-14 14:29:20 +00:00
### Carbon Intensity
[carbon_intensity.py](carbon_intensity.py)
This example connects to the Carbon Intensity API to give you a regional forecast of how your (UK) electricity is being generated and its carbon impact.
Find out more at https://carbonintensity.org.uk/
### Daily Activity
[inky_frame_daily_activity.py](inky_frame_daily_activity.py)
2022-07-19 17:54:44 +00:00
Generate a random activity from Bored API.
2023-03-13 17:12:29 +00:00
### Dithering
[inky_frame_dithering.py](inky_frame_dithering.py)
A basic example showing automatic dithering in action, as PicoGraphics tries to use Inky Frame's limited colour palette to match arbitrary colours.
2022-07-22 18:17:39 +00:00
### Image Gallery
2022-07-28 17:39:12 +00:00
[/image_gallery](../inky_frame/image_gallery)
2022-07-22 18:17:39 +00:00
This photo frame example displays local images on Inky Frame and lets you switch between them with the buttons. Use `image_gallery.py` if your images are stored on your Pico, or `image_gallery_sd.py` if the images are on your SD card.
2022-07-25 12:42:21 +00:00
### LED PWM
[led_pwm.py](led_pwm.py)
A basic example showing how you can control the brightness of Inky Frame's LEDs using PWM.
### News
[inky_frame_news.py](inky_frame_news.py)
2022-07-22 18:17:39 +00:00
Display headlines from BBC News.
### PlaceKitten
[inky_frame_placekitten.py](inky_frame_placekitten.py)
Download a random (from a small subset) image from PlaceKitten.
### Quote of the Day
[inky_frame_quote_of_the_day.py](inky_frame_quote_of_the_day.py)
Load the WikiQuotes Quote of the Day and display it.
### Random Joke
[inky_frame_random_joke.py](inky_frame_random_joke.py)
Load a random joke from JokeAPI.dev and display it.
Jokes are rendered into images "offline" by our feed2image service for two reasons:
1. Saves the Pico W having to process them
2. JokeAPI.dev needs TLS1.3 which Pico W does not support!
For bugs/contributions or to complain about a joke, see: https://github.com/pimoroni/feed2image
2023-03-13 17:12:29 +00:00
### RTC Demo
[inky_frame_rtc_demo.py](inky_frame_rtc_demo.py)
A basic example that sets the time/date from an NTP server, syncs the Inky and Pico RTCs and and makes Inky Frame wake up on a timer.
2022-07-28 17:39:12 +00:00
### SD Card Test
[sd_test.py](sd_test.py)
This simple example shows how to read and write from the SD card on Inky Frame.
### XKCD Daily
[inky_frame_xkcd_daily.py](inky_frame_xkcd_daily.py)
Download and display the daily webcomic from https://xkcd.com/
The webcomic is rendered "offline" by our feed2image service since xkcd.com requires TLS1.3!
For bugs/contributions see: https://github.com/pimoroni/feed2image
2023-03-03 11:21:32 +00:00