Merge pull request #284 from pimoroni/tweak-docs

Add Pimoroni Pico LiPo button/LED example, tweak docs
This commit is contained in:
Philip Howard 2022-03-09 12:22:45 +00:00 committed by GitHub
commit 7dfd9a04b0
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 22 additions and 9 deletions

View File

@ -0,0 +1,13 @@
# This example blinks the user LED on Pimoroni Pico Lipo whilst the BOOT button is pressed.
# The button is active low, which is why we're using an if not statement!
from machine import Pin
import time
led = Pin(25, Pin.OUT)
button = Pin(23, Pin.IN, Pin.PULL_DOWN)
while True:
if not button.value():
led.toggle()
time.sleep(0.5)

View File

@ -1,6 +1,6 @@
# Badger 2040 <!-- omit in toc --> # Badger 2040 <!-- omit in toc -->
Badger 2040 is an RP2040 powered EInk badge. Badger 2040 is an RP2040 powered E Ink badge.
- [Summary](#summary) - [Summary](#summary)
- [Getting Started](#getting-started) - [Getting Started](#getting-started)
@ -9,7 +9,7 @@ Badger 2040 is an RP2040 powered EInk badge.
- [Other Functions](#other-functions) - [Other Functions](#other-functions)
- [Other Constants](#other-constants) - [Other Constants](#other-constants)
- [Screen Size](#screen-size) - [Screen Size](#screen-size)
- [EInk Pins](#eink-pins) - [E Ink Pins](#e-ink-pins)
- [Power Pins](#power-pins) - [Power Pins](#power-pins)
- [Activity LED Pin](#activity-led-pin) - [Activity LED Pin](#activity-led-pin)
- [Function Reference](#function-reference) - [Function Reference](#function-reference)
@ -49,7 +49,7 @@ This will create a `Badger2040` class called `badger` that will be used in the r
## Update Speed ## Update Speed
The EInk display on Badger 2040 supports several update speeds. These can be set using `update_speed(speed)` where `speed` is a value from `0` to `3`. For convenience these speeds have been given the following constants: The E Ink display on Badger 2040 supports several update speeds. These can be set using `update_speed(speed)` where `speed` is a value from `0` to `3`. For convenience these speeds have been given the following constants:
* `UPDATE_NORMAL` = `0` * `UPDATE_NORMAL` = `0`
* `UPDATE_MEDIUM` = `1` * `UPDATE_MEDIUM` = `1`
@ -89,7 +89,7 @@ font(font)
led(brightness) led(brightness)
image(data, w=298, h=128, x=0, y=0) image(data, w=296, h=128, x=0, y=0)
icon(data, icon_index, sheet_size, icon_size) icon(data, icon_index, sheet_size, icon_size)
clear() clear()
@ -107,7 +107,7 @@ Below is a list of other constants that have been made available, to help with t
* `WIDTH` = `296` * `WIDTH` = `296`
* `HEIGHT` = `128` * `HEIGHT` = `128`
### EInk Pins ### E Ink Pins
* `PIN_CS` = `17` * `PIN_CS` = `17`
* `PIN_CLK` = `18` * `PIN_CLK` = `18`
* `PIN_MOSI` = `19` * `PIN_MOSI` = `19`
@ -273,7 +273,7 @@ We've supplied a script - `convert.py` - which will help you get your images con
Ideally you should pick something already 296x128 pixels or smaller, and in monochrome, but it will dither and convert images for you. Ideally you should pick something already 296x128 pixels or smaller, and in monochrome, but it will dither and convert images for you.
Find it in [examples/badger2040/image_converter](examples/badger2040/image_converter). Find it in [/examples/badger2040/image_converter](/examples/badger2040/image_converter).
To convert an oversized image use: To convert an oversized image use:
@ -281,7 +281,7 @@ To convert an oversized image use:
python3 convert.py --resize --binary my_image.png python3 convert.py --resize --binary my_image.png
``` ```
This will output `my_image.bin`, which you can save to your Badger2040 via Thonny and display with the code above. This will output `my_image.bin`, which you can save to your Badger 2040 via Thonny and display with the code above.
For smaller images such as icons you can omit the `--resize` flag: For smaller images such as icons you can omit the `--resize` flag:
@ -369,7 +369,7 @@ partial_update(
### Invert (aka Dark Mode) ### Invert (aka Dark Mode)
Badger2040 can invert all your display data for a quick and easy dark mode: Badger 2040 can invert all your display data for a quick and easy dark mode:
```python ```python
invert( invert(
@ -379,7 +379,7 @@ invert(
### Update Speed ### Update Speed
Badger2040 is capable of updating the display at multiple different speeds. Badger 2040 is capable of updating the display at multiple different speeds.
These offer a tradeoff between the quality of the final image and the speed of the update. These offer a tradeoff between the quality of the final image and the speed of the update.