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

# Pico Explorer MicroPython Examples <!-- omit in toc -->

- [PicoGraphics](#picographics)
- [Non-Wireless Examples](#non-wireless-examples)
  - [Balls Demo](#balls-demo)
  - [Button Test](#button-test)
  - [Demo](#demo)
  - [Noise](#noise)
  - [Rainbow](#rainbow)
  - [Thermometer](#thermometer)
  - [Weather Station (BME280)](#weather-station-bme280)
  - [Weather Station (BME68X)](#weather-station-bme68x)
- [Wireless Examples](#wireless-examples)
  - [Cheerlights](#cheerlights)

## PicoGraphics

You can draw on Pico Explorer's display using our tiny PicoGraphics display library.
- [PicoGraphics MicroPython function reference](../../modules/picographics)

## Non-Wireless Examples

### Balls Demo
[balls_demo.py](balls_demo.py)

LCD demo showing 100 bouncy balls!

### Button Test
[button_test.py](button_test.py)

This example shows you a simple, non-interrupt way of reading Pico Explorer's buttons with a loop that checks to see if buttons are pressed.

### Demo
[demo.py](demo.py)

A demo of all Pico Explorer's functions. Connect analog inputs like potentiometers up to ADC0-ADC3 and motors to the motor channels for best results. Connect AUDIO to GP0 with a jumper wire to hear noise.

### Noise
[noise.py](noise.py)

This example shows you how you can use Pico Explorer's onboard buzzer as a speaker to play different notes and string them together into a bleepy tune (you'll need to connect AUDIO to GP0 with a jumper wire to hear noise).

### Rainbow
[rainbow.py](rainbow.py)

This example borrows a CircuitPython hsv to rgb function to cycle through some rainbows on Pico Explorer's screen.

### Thermometer
[thermometer.py](thermometer.py)

This example takes the temperature from the Pico's onboard temperature sensor, and displays it on Pico Explorer, along with a little pixelly graph.

### Weather Station (BME280)
[weatherstation_BME280.py](weatherstation_BME280.py)

Plug a [BME280 breakout](https://shop.pimoroni.com/products/bme280-breakout) into your Pico Explorer and make a little indoor weather station, with barometer style descriptions.

### Weather Station (BME68X)
[weatherstation_BME68X.py](weatherstation_BME68X.py)

Plug a [BME680](https://shop.pimoroni.com/products/bme680-breakout) or [BME688](https://shop.pimoroni.com/products/bme688-breakout) breakout into your Pico Explorer to make a little indoor weather station, with barometer style descriptions.

## Wireless Examples

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'.

### Cheerlights
[cheerlights.py](cheerlights.py)

This Pico W example sets your Pico Explorer's screen (and optionally, a [RGB LED](https://shop.pimoroni.com/products/led-rgb-clear-common-cathode)) to the current #cheerlights colour.