Display-o-Tron 3000 Driver
Project description
# Display-o-Tron 3000
## Installing
We've created a super-easy installation script that will install all pre-requisites and get your Dot3k up and running in a jiffy, just type this into a terminal or LXTerminal:
```bash
curl get.pimoroni.com/dot3k | bash
```
## Usage
### LCD
```python
from dot3k import lcd
lcd.write('Hello World!')
```
### Backlight
```python
from dot3k import backlight
backlight.sweep(0.5)
backlight.update()
```
### Joystick
```python
from dot3k import joystick
@joystick.on(joystick.UP)
def handle_joystick_up(pin):
print("Joystick up!")
```
Changelog
---------
2.0.1
-----
* Now handles reset pin for Display-o-Tron HAT
* Added cap1xxx as a dependency
2.0.0
-----
* Added support for Display-o-Tron HAT
* Misc fixes and improvements
1.9.0
-----
* Added new MenuIcon class with pre-made icons for use in plugins/menus
* Added "cancel" method which can be called to immediately exit any menu item
1.8.2
-----
* Fixed bug in screensaver functionality so it works with non-keyword args
* Added new "add_item" feature so that menu items can be kept in order
1.8.1
-----
* Backlight now has off() method shortcut for turning lights off
* Added a use_brg() method for old Dot3ks with different pixel order
1.8.0
-----
* Significant, possibly breaking, change to __init__.py to remove redundant imports
* lcd and joystick should work with Python 3, backlight still requires smbus
1.7.1
-----
* Sane defaults for write_option(), now no longer defauts to 1 margin and blank icon
1.7
---
* Added input handling plugin support
* Remapped parameters to args/kwargs to make menu initialisation less mystifying
1.6.1
-----
* Fixed bug in set_bar which cased the left blue backlight to light
1.6
---
* Added support for an "idle" plugin which shows after a customisable amount of seconds
1.5
---
* Fixed joystick repeat using delta timing instead of delays
1.4
---
* Bugfix of menu.py line-endings
* Attempt to fix joystick.repeat to prevent multiple repeats firing at once
1.3
---
* Removed plugins from dot3k.menu into examples/plugins folder
1.2
---
* Breaking changes with plugin compatibility vs version 1.1
* Many fixes to redraw calls
* Plugin redraw method is now passed the "menu" instance
1.1
---
* Fix for joystick on Rev 1 Pi
1.0dev
------
* Initial Release
## Installing
We've created a super-easy installation script that will install all pre-requisites and get your Dot3k up and running in a jiffy, just type this into a terminal or LXTerminal:
```bash
curl get.pimoroni.com/dot3k | bash
```
## Usage
### LCD
```python
from dot3k import lcd
lcd.write('Hello World!')
```
### Backlight
```python
from dot3k import backlight
backlight.sweep(0.5)
backlight.update()
```
### Joystick
```python
from dot3k import joystick
@joystick.on(joystick.UP)
def handle_joystick_up(pin):
print("Joystick up!")
```
Changelog
---------
2.0.1
-----
* Now handles reset pin for Display-o-Tron HAT
* Added cap1xxx as a dependency
2.0.0
-----
* Added support for Display-o-Tron HAT
* Misc fixes and improvements
1.9.0
-----
* Added new MenuIcon class with pre-made icons for use in plugins/menus
* Added "cancel" method which can be called to immediately exit any menu item
1.8.2
-----
* Fixed bug in screensaver functionality so it works with non-keyword args
* Added new "add_item" feature so that menu items can be kept in order
1.8.1
-----
* Backlight now has off() method shortcut for turning lights off
* Added a use_brg() method for old Dot3ks with different pixel order
1.8.0
-----
* Significant, possibly breaking, change to __init__.py to remove redundant imports
* lcd and joystick should work with Python 3, backlight still requires smbus
1.7.1
-----
* Sane defaults for write_option(), now no longer defauts to 1 margin and blank icon
1.7
---
* Added input handling plugin support
* Remapped parameters to args/kwargs to make menu initialisation less mystifying
1.6.1
-----
* Fixed bug in set_bar which cased the left blue backlight to light
1.6
---
* Added support for an "idle" plugin which shows after a customisable amount of seconds
1.5
---
* Fixed joystick repeat using delta timing instead of delays
1.4
---
* Bugfix of menu.py line-endings
* Attempt to fix joystick.repeat to prevent multiple repeats firing at once
1.3
---
* Removed plugins from dot3k.menu into examples/plugins folder
1.2
---
* Breaking changes with plugin compatibility vs version 1.1
* Many fixes to redraw calls
* Plugin redraw method is now passed the "menu" instance
1.1
---
* Fix for joystick on Rev 1 Pi
1.0dev
------
* Initial Release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
dot3k-2.0.1.tar.gz
(11.8 kB
view details)
File details
Details for the file dot3k-2.0.1.tar.gz
.
File metadata
- Download URL: dot3k-2.0.1.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b091dab8da80f271c0771ac334e5a07a7e9f8c391d8dca59a07d9a272ba868da |
|
MD5 | 9c8032289b1b730899ac871c0c4601fa |
|
BLAKE2b-256 | 1680b53d14422b7cb7f3a00b3f50cbe4fe238d04c1226fe443eba9b12f8bee79 |