kopia lustrzana https://github.com/peterhinch/micropython-nano-gui
Add asnano_sync demo.
Peter Hinch
rodzic
969455591f
commit
16a0f9834b
|
|
@ -1,8 +1,33 @@
|
|||
# nanogui: Simple asynchronous demos
|
||||
# nanogui: Use in asynchronous code
|
||||
|
||||
Demo of the use of `nanogui` with `uasyncio`:
|
||||
* `asnano.py` Runs until the usr button is pressed.
|
||||
## Blocking
|
||||
|
||||
Requires [asyn.py](https://github.com/peterhinch/micropython-async/blob/master/asyn.py).
|
||||
The suitability of `nanogui` for use with cooperative schedulers such as
|
||||
`uasyncio` is constrained by the underlying display driver. The GUI supports
|
||||
displays whose driver is subclassed from `framebuf`. Such drivers hold the
|
||||
frame buffer on the host, transferring its entire contents to the display
|
||||
hardware, usually via I2C or SPI. Current drivers block for the time taken by
|
||||
this.
|
||||
|
||||
In the case of the Pyboard driver for Adafruit 1.5 and 1.27 inch displays,
|
||||
running on a Pyboard 1.x, blocking is for 41ms. Blocking periods for monochrome
|
||||
or smaller colour dislays will be shorter. On hosts which don't support inline
|
||||
Arm Thumb assembler or the viper emitter it will be very much longer.
|
||||
|
||||
Blocking occurs when the `nanogui.refresh` function is called. In typical
|
||||
applications which might wait for user input from a switch this blocking is
|
||||
not apparent and the response appears immediate. It may have consequences in
|
||||
applications performing fast concurrent input over devices such as UARTs.
|
||||
|
||||
# Demo scripts
|
||||
|
||||
* `asnano.py` Runs until the usr button is pressed. In this demo each meter
|
||||
updates independently and mutually asynchronously to test the response to
|
||||
repeated display refreshes.
|
||||
* `asnano_sync.py` Provides a less hectic visual by only updating the display
|
||||
when all data has been acquired. Uses a `Barrier` object to achieve the
|
||||
necessary synchronisation.
|
||||
|
||||
These demos require [asyn.py](https://github.com/peterhinch/micropython-async/blob/master/asyn.py).
|
||||
|
||||
###### [Main README](../README.md)
|
||||
|
|
|
|||
|
|
@ -0,0 +1,131 @@
|
|||
# asnano_sync.py Test/demo program for use of nanogui with uasyncio
|
||||
# Uses Adafruit ssd1351-based OLED displays (change height to suit)
|
||||
# Adafruit 1.5" 128*128 OLED display: https://www.adafruit.com/product/1431
|
||||
# Adafruit 1.27" 128*96 display https://www.adafruit.com/product/1673
|
||||
|
||||
# The MIT License (MIT)
|
||||
|
||||
# Copyright (c) 2018 Peter Hinch
|
||||
|
||||
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
# of this software and associated documentation files (the "Software"), to deal
|
||||
# in the Software without restriction, including without limitation the rights
|
||||
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
# copies of the Software, and to permit persons to whom the Software is
|
||||
# furnished to do so, subject to the following conditions:
|
||||
#
|
||||
# The above copyright notice and this permission notice shall be included in
|
||||
# all copies or substantial portions of the Software.
|
||||
#
|
||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
# THE SOFTWARE.
|
||||
|
||||
# WIRING (Adafruit pin nos and names)
|
||||
# Pyb SSD
|
||||
# 3v3 Vin (10)
|
||||
# Gnd Gnd (11)
|
||||
# X1 DC (3 DC)
|
||||
# X2 CS (5 OC OLEDCS)
|
||||
# X3 Rst (4 R RESET)
|
||||
# X6 CLK (2 CL SCK)
|
||||
# X8 DATA (1 SI MOSI)
|
||||
|
||||
height = 96 # 1.27 inch 96*128 (rows*cols) display
|
||||
# height = 128 # 1.5 inch 128*128 display
|
||||
|
||||
import machine
|
||||
import gc
|
||||
from ssd1351 import SSD1351 as SSD
|
||||
|
||||
# Initialise hardware and framebuf before importing modules
|
||||
pdc = machine.Pin('X1', machine.Pin.OUT_PP, value=0)
|
||||
pcs = machine.Pin('X2', machine.Pin.OUT_PP, value=1)
|
||||
prst = machine.Pin('X3', machine.Pin.OUT_PP, value=1)
|
||||
spi = machine.SPI(1)
|
||||
gc.collect() # Precaution befor instantiating framebuf
|
||||
ssd = SSD(spi, pcs, pdc, prst, height) # Create a display instance
|
||||
|
||||
import uasyncio as asyncio
|
||||
import asyn
|
||||
import pyb
|
||||
import uos
|
||||
from writer import CWriter
|
||||
from nanogui import LED, Meter, refresh
|
||||
refresh(ssd)
|
||||
|
||||
# Fonts
|
||||
import arial10, freesans20
|
||||
|
||||
GREEN = SSD.rgb(0, 255, 0)
|
||||
RED = SSD.rgb(255, 0, 0)
|
||||
YELLOW = SSD.rgb(255, 255, 0)
|
||||
BLACK = 0
|
||||
|
||||
CWriter.set_textpos(ssd, 0, 0) # In case previous tests have altered it
|
||||
wri = CWriter(ssd, arial10, GREEN, BLACK, verbose=False)
|
||||
wri.set_clip(True, True, False)
|
||||
|
||||
color = lambda v : RED if v > 0.7 else YELLOW if v > 0.5 else GREEN
|
||||
txt = lambda v : 'ovr' if v > 0.7 else 'high' if v > 0.5 else 'ok'
|
||||
|
||||
@asyn.cancellable
|
||||
async def meter(bar, x, text):
|
||||
m = Meter(wri, 5, x, divisions = 4, ptcolor=YELLOW,
|
||||
label=text, style=Meter.BAR, legends=('0.0', '0.5', '1.0'))
|
||||
l = LED(wri, ssd.height - 16 - wri.height, x, bdcolor=YELLOW, label ='over')
|
||||
while True:
|
||||
v = int.from_bytes(uos.urandom(3),'little')/16777216
|
||||
m.value(v, color(v))
|
||||
l.color(color(v))
|
||||
l.text(txt(v), fgcolor=color(v))
|
||||
# Demo would work if data acquisition was slow. But even with fast
|
||||
# running we pause here until all meters have updated and the main
|
||||
# task is ready to refresh the display.
|
||||
await bar
|
||||
|
||||
@asyn.cancellable
|
||||
async def flash(n, t):
|
||||
led = pyb.LED(n)
|
||||
try:
|
||||
while True:
|
||||
led.toggle()
|
||||
await asyncio.sleep_ms(t)
|
||||
except asyn.StopTask:
|
||||
led.off() # Demo tidying up on cancellation.
|
||||
|
||||
# The main task instantiates other tasks then does the display update process.
|
||||
@asyn.cancellable
|
||||
async def main(loop):
|
||||
print('Press Pyboard usr button to stop test.')
|
||||
bar = asyn.Barrier(4, refresh, (ssd,))
|
||||
# Asynchronously flash Pyboard LED's. Because we can.
|
||||
loop.create_task(asyn.Cancellable(flash, 1, 200)())
|
||||
loop.create_task(asyn.Cancellable(flash, 2, 233)())
|
||||
# Task for each meter and GUI LED
|
||||
loop.create_task(asyn.Cancellable(meter, bar, 2, 'left')())
|
||||
loop.create_task(asyn.Cancellable(meter, bar, 50, 'right')())
|
||||
loop.create_task(asyn.Cancellable(meter, bar, 98, 'bass')())
|
||||
try:
|
||||
while True:
|
||||
await asyncio.sleep_ms(800)
|
||||
# If necessary wait until all meters have updated.
|
||||
# Barrier callback updates display.
|
||||
await bar
|
||||
except asyn.StopTask:
|
||||
ssd.fill(0) # Clear display at end.
|
||||
refresh(ssd)
|
||||
|
||||
async def killer():
|
||||
sw = pyb.Switch()
|
||||
while not sw():
|
||||
await asyncio.sleep_ms(100)
|
||||
await asyn.Cancellable.cancel_all()
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
loop.create_task(asyn.Cancellable(main, loop)())
|
||||
loop.run_until_complete(killer())
|
||||
Ładowanie…
Reference in New Issue