Copied Cosmic MPy examples to Stellar

Author: ZodiusInfuser

micropython/examples/cosmic_unicorn/feature_test_with_audio.py

@@ -152,8 +152,6 @@ def outline_text(text):
 # The current synth beat
 beat = 0
 
-text = ""
-
 
 def next_beat():
     global beat
@@ -312,6 +310,8 @@ def tick(timer):
         # print("white gradient")
         gradient(255, 255, 255)
 
+    text = ""
+
     if cu.is_pressed(CosmicUnicorn.SWITCH_A):
         text = "PlaySyn"
 

micropython/examples/stellar_unicorn/README.md

@@ -0,0 +1,178 @@
+# Stellar Unicorn MicroPython Examples <!-- omit in toc -->
+ 
+- [About Stellar Unicorn](#about-stellar-unicorn)
+- [Stellar Unicorn and PicoGraphics](#stellar-unicorn-and-picographics)
+- [Examples](#examples)
+  - [Clock](#clock)
+  - [Eighties Super Computer](#eighties-super-computer)
+  - [Feature Test](#feature-test)
+  - [Feature Test With Audio](#feature-test-with-audio)
+  - [Fire Effect](#fire-effect)
+  - [Lava Lamp](#lava-lamp)
+  - [Nostalgia Prompt](#nostalgia-prompt)
+  - [Rainbow](#rainbow)
+  - [Scrolling Text](#scrolling-text)
+  - [Today](#today)
+- [Wireless Examples](#wireless-examples)
+  - [Cheerlights History](#cheerlights-history)
+  - [Stellar Paint](#stellar-paint)
+  - [Exchange Ticker](#exchange-ticker)
+  - [HTTP Text](#http-text)
+  - [Weather](#weather)
+- [NumPy examples](#numpy-examples)
+- [Other Examples](#other-examples)
+  - [Launch (Demo Reel)](#launch-demo-reel)
+- [Other Resources](#other-resources)
+
+## About Stellar Unicorn
+
+Stellar Unicorn offers 16x16 bright RGB LEDs driven by Pico W's PIO in addition to a 1W amplifier + speaker, a collection of system and user buttons, and two Qw/ST connectors for adding external sensors and devices. Woha!
+
+- :link: [Stellar Unicorn store page](https://shop.pimoroni.com/products/stellar-unicorn)
+
+Stellar Unicorn ships with MicroPython firmware pre-loaded, but you can download the most recent version at the link below (you'll want the  `stellar-unicorn` image).
+
+- [MicroPython releases](https://github.com/pimoroni/pimoroni-pico/releases)
+- [Installing MicroPython](../../../setting-up-micropython.md)
+
+## Stellar Unicorn and PicoGraphics
+
+The easiest way to start displaying cool stuff on Stellar Unicorn is using our Stellar Unicorn module (which contains a bunch of helpful functions for interacting with the buttons, adjusting brightness and suchlike) and our PicoGraphics library, which is chock full of useful functions for drawing on the LED matrix.
+
+- [Stellar Unicorn function reference](../../modules/stellar_unicorn/README.md)
+- [PicoGraphics function reference](../../modules/picographics/README.md)
+
+## Examples
+
+### Clock
+
+[clock.py](clock.py)
+
+Clock example with (optional) NTP synchronization. You can adjust the brightness with LUX + and -, and resync the time by pressing A.
+
+### Eighties Super Computer
+
+[eighties_super_computer.py](eighties_super_computer.py)
+
+Random LEDs blink on and off mimicing the look of a movie super computer doing its work in the eighties. You can adjust the brightness with LUX + and -.
+
+### Feature Test
+
+[feature_test.py](feature_test.py)
+
+Displays some text, gradients and colours and demonstrates button use. You can adjust the brightness with LUX + and -.
+
+### Feature Test With Audio
+
+[feature_test_with_audio.py](feature_test_with_audio.py)
+
+Displays some text, gradients and colours and demonstrates button use. Also demonstrates some of the audio / synth features.
+- Button A plays a synth tune
+- Button B plays a solo channel of the synth tune
+- Button C plays a sinewave (it's frequency can be adjusted with VOL + and -)
+- Button D plays a second sinewave (it's frequency can be adjusted with LUX + and -)
+- Sleep button stops the sounds
+
+### Fire Effect
+
+[fire_effect.py](fire_effect.py)
+
+A pretty, procedural fire effect. Switch between landscape fire and vertical fire using the A and B buttons! You can adjust the brightness with LUX + and -.
+
+### Lava Lamp
+
+[lava_lamp.py](lava_lamp.py)
+
+A 70s-tastic, procedural rainbow lava lamp. You can adjust the brightness with LUX + and -.
+
+### Nostalgia Prompt
+
+[nostalgia_prompt.py](nostalgia_prompt.py)
+
+A collection of copies of classic terminal styles including C64, MS-DOS, Spectrum, and more. Images and text are drawn pixel by pixel from a pattern of Os and Xs. You can adjust the brightness with LUX + and -.
+
+### Rainbow
+
+[rainbow.py](rainbow.py)
+
+Some good old fashioned rainbows! You can adjust the cycling speed with A and B, stripe width with C and D, hue with VOL + and -, and the brightness with LUX + and -. The sleep button stops the animation (can be started again with A or B).
+
+### Scrolling Text
+
+[scrolling_text.py](scrolling_text.py)
+
+Display scrolling wisdom, quotes or greetz. You can adjust the brightness with LUX + and -.
+
+### Today
+
+[today.py](today.py)
+
+Calendar example with (optional) NTP synchronization. You can adjust the brightness with LUX + and -, and resync the date by pressing C.
+
+## Wireless Examples
+
+These examples need `WIFI_CONFIG.py` and `network_manager.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).
+
+- [micropython/examples/common](../../examples/common)
+
+### Cheerlights History
+
+[cheerlights_history.py](cheerlights_history.py)
+
+Updates one pixel every two minutes to display the most recent #Cheerlights colour. Discover the most popular colours over time, or use it as an avant garde (but colourful) 16 hour clock! Find out more about the Cheerlights API at https://cheerlights.com/
+
+You can adjust the brightness with LUX + and -.
+
+### Stellar Paint
+
+[stellar_paint](stellar_paint)
+
+Draw on your Stellar Unicorn from another device in real time, over wifi!
+
+This example needs the `micropython-phew` and `microdot` libraries (you can install these using Thonny's 'Tools > Manage Packages').
+
+### Exchange Ticker
+
+[exchange_ticker.py](exchange_ticker.py)
+
+This example uses the Coinbase open API to collect the current exchange rates of various cryptocurrencies.
+
+Press A to change to a different base exchange currency.
+
+### HTTP Text
+
+[http_text](http_text)
+
+Display scrolling wisdom, quotes or greetz... from another computer or device!
+
+You can adjust the brightness with LUX + and -.
+
+Requires `logging.mpy` and `tinyweb` from [micropython/examples/common](../../examples/common) - copy these into the `lib` folder on your Pico W. You'll also need `index.html` to be saved alongside `html_text.py`.
+
+### Weather
+
+[weather](weather)
+
+Display current weather data from the [Open-Meteo](https://open-meteo.com/) weather API.
+
+## NumPy examples
+
+[numpy](numpy)
+
+The examples in the folder use `numpy`-like array functions contained in the `ulab` library for super fast graphical effects.
+
+## Other Examples
+
+### Launch (Demo Reel)
+
+[launch](launch)
+
+If you want to get the demo reel that Stellar Unicorn ships with back, copy the contents of this `launch` folder to your Pico W.
+
+## Other Resources
+
+Here are some cool Stellar Unicorn community projects and resources that you might find useful / inspirational! Note that code at the links below has not been tested by us and we're not able to offer support with it.
+
+- :link: [Green Energy Display with Stellar Unicorn](https://www.hackster.io/andreas-motzek/clock-and-green-energy-display-with-stellar-unicorn-641dcb)
+- :link: [stellar-emoji-react - paint emojis from a computer, phone or tablet](https://github.com/chriscareycode/stellar-unicorn/tree/main/stellar-emoji-react)
+- :link: [stellar-paste - paste images from the clipboard to Stellar Unicorn](https://github.com/chriscareycode/stellar-unicorn/tree/main/stellar-paste)

micropython/examples/stellar_unicorn/cheerlights_history.py

@@ -0,0 +1,128 @@
+# This Stellar Unicorn example updates a pixel every two(ish) minutes
+# to display the most recent #cheerlights colour. Discover the most popular
+# colours over time, or use it as an avant garde (but colourful) 16 hour clock!
+# Find out more about the Cheerlights API at https://cheerlights.com/
+#
+# To run this example you'll need WIFI_CONFIG.py and network_manager.py from
+# the pimoroni-pico micropython/examples/common folder
+
+import WIFI_CONFIG
+from network_manager import NetworkManager
+import uasyncio
+import urequests
+import time
+from machine import Timer, Pin
+from stellar import StellarUnicorn
+from picographics import PicoGraphics, DISPLAY_STELLAR_UNICORN as DISPLAY
+
+URL = 'http://api.thingspeak.com/channels/1417/field/2/last.json'
+
+UPDATE_INTERVAL = 113  # refresh interval in secs. Be nice to free APIs!
+# this esoteric number is used so that a column of LEDs equates (approximately) to an hour
+
+
+def status_handler(mode, status, ip):
+    # reports wifi connection status
+    print(mode, status, ip)
+    print('Connecting to wifi...')
+    if status is not None:
+        if status:
+            print('Wifi connection successful!')
+        else:
+            print('Wifi connection failed!')
+
+
+def hex_to_rgb(hex):
+    # converts a hex colour code into RGB
+    h = hex.lstrip('#')
+    r, g, b = (int(h[i:i + 2], 16) for i in (0, 2, 4))
+    return r, g, b
+
+
+def get_data():
+    # open the json file
+    print(f'Requesting URL: {URL}')
+    r = urequests.get(URL)
+    # open the json data
+    j = r.json()
+    print('Data obtained!')
+    r.close()
+
+    # flash the onboard LED after getting data
+    pico_led.value(True)
+    time.sleep(0.2)
+    pico_led.value(False)
+
+    # extract hex colour from the json data
+    hex = j['field2']
+
+    # add the new hex colour to the end of the array
+    colour_array.append(hex)
+    print(f'Colour added to array: {hex}')
+    # remove the oldest colour in the array
+    colour_array.pop(0)
+    update_leds()
+
+
+def update_leds():
+    # light up the LEDs
+    # this step takes a second, it's doing a lot of hex_to_rgb calculations!
+    print("Updating LEDs...")
+    i = 0
+    for x in range(width):
+        for y in range(height):
+            r, g, b = hex_to_rgb(colour_array[i])
+
+            current_colour = graphics.create_pen(r, g, b)
+            graphics.set_pen(current_colour)
+            graphics.pixel(x, y)
+            i = i + 1
+    su.update(graphics)
+    print("LEDs updated!")
+
+
+su = StellarUnicorn()
+graphics = PicoGraphics(DISPLAY)
+
+width = StellarUnicorn.WIDTH
+height = StellarUnicorn.HEIGHT
+
+su.set_brightness(0.5)
+
+# set up the Pico W's onboard LED
+pico_led = Pin('LED', Pin.OUT)
+
+current_colour = graphics.create_pen(0, 0, 0)
+
+# set up an list to store the colours
+colour_array = ["#000000"] * 1024
+
+# set up wifi
+try:
+    network_manager = NetworkManager(WIFI_CONFIG.COUNTRY, status_handler=status_handler)
+    uasyncio.get_event_loop().run_until_complete(network_manager.client(WIFI_CONFIG.SSID, WIFI_CONFIG.PSK))
+except Exception as e:
+    print(f'Wifi connection failed! {e}')
+
+# get the first lot of data
+get_data()
+
+# start timer (the timer will call the function to update our data every UPDATE_INTERVAL)
+timer = Timer(-1)
+timer.init(period=UPDATE_INTERVAL * 1000, mode=Timer.PERIODIC, callback=lambda t: get_data())
+
+while True:
+    # adjust brightness with LUX + and -
+    # LEDs take a couple of secs to update, so adjust in big (10%) steps
+    if su.is_pressed(StellarUnicorn.SWITCH_BRIGHTNESS_UP):
+        su.adjust_brightness(+0.1)
+        update_leds()
+        print(f"Brightness set to {su.get_brightness()}")
+
+    if su.is_pressed(StellarUnicorn.SWITCH_BRIGHTNESS_DOWN):
+        su.adjust_brightness(-0.1)
+        update_leds()
+        print(f"Brightness set to {su.get_brightness()}")
+
+    # pause for a moment (important or the USB serial device will fail)
+    time.sleep(0.001)