2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
[![Arduino CI](https://github.com/RobTillaart/PAR27979/workflows/Arduino%20CI/badge.svg)](https://github.com/marketplace/actions/arduino_ci)
|
2021-11-11 06:31:09 -05:00
|
|
|
[![Arduino-lint](https://github.com/RobTillaart/PAR27979/actions/workflows/arduino-lint.yml/badge.svg)](https://github.com/RobTillaart/PAR27979/actions/workflows/arduino-lint.yml)
|
|
|
|
[![JSON check](https://github.com/RobTillaart/PAR27979/actions/workflows/jsoncheck.yml/badge.svg)](https://github.com/RobTillaart/PAR27979/actions/workflows/jsoncheck.yml)
|
2021-01-29 06:31:58 -05:00
|
|
|
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RobTillaart/PAR27979/blob/master/LICENSE)
|
|
|
|
[![GitHub release](https://img.shields.io/github/release/RobTillaart/PAR27979.svg?maxAge=3600)](https://github.com/RobTillaart/PAR27979/releases)
|
|
|
|
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
# PAR27979
|
2013-09-30 12:12:19 -04:00
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
Arduino library for the Parallax 27979 serial display.
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
The library is essentially a wrapper around a Stream, typically Serial,
|
|
|
|
Serial2 (3,4..) or newSoftSerial or equivalent.
|
|
|
|
This stream is given as parameter in the constructor.
|
|
|
|
|
2021-12-22 08:08:07 -05:00
|
|
|
Should work for 27976 and 27977 display although not tested.
|
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
## Interface
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
The library implements the **Print** interface to print integers
|
|
|
|
floats and strings and all printable types.
|
|
|
|
|
|
|
|
The library does not keep any state information, it only implements a few
|
2021-01-29 06:31:58 -05:00
|
|
|
methods to make working with it easier.
|
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### Base
|
|
|
|
|
|
|
|
- **PAR27979(Stream \* str)** constructor, used stream as parameter.
|
2021-11-11 06:31:09 -05:00
|
|
|
- **void on()** switch display on.
|
|
|
|
- **void off()** switch display off.
|
|
|
|
- **void clearHome()** clear the display.
|
|
|
|
- **void backlightOn()** enable the backlight.
|
|
|
|
- **void backLightOff()** disable the backlight.
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
### Cursor Movement
|
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
- **void left()** move cursor.
|
|
|
|
- **void right()** move cursor.
|
|
|
|
- **void down()** move cursor.
|
|
|
|
- **void gotoXY(uint8_t x, uint8_t y)** idem.
|
|
|
|
|
|
|
|
|
|
|
|
### Custom chars
|
|
|
|
|
|
|
|
see datasheet.
|
|
|
|
|
|
|
|
- **void defineCustomChar(uint8_t idx, uint8_t \* arr)** array will need to be 8 bytes.
|
|
|
|
- **void customChar(uint8_t idx)** idem.
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
### Sound support
|
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
- **void octave(uint8_t octave)** octave = 3 4 5 6 7
|
|
|
|
- **void duration(uint8_t duration)** duration = 1 2 4 8 16 32 64
|
2021-12-22 08:08:07 -05:00
|
|
|
- **void play(uint8_t note)** note = 0 1 2 3 4 5 6 7 8 9 10 11 0=A 1=A# etc.
|
2021-11-11 06:31:09 -05:00
|
|
|
- **void noSound()** idem.
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
## Support Parallax 27976 & 27977
|
|
|
|
|
|
|
|
Although not tested, the functions should work with the
|
|
|
|
Parallax 27976 and 27977 displays too.
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
## Operation
|
|
|
|
|
2021-11-11 06:31:09 -05:00
|
|
|
See examples.
|
|
|
|
|
|
|
|
## Future
|
|
|
|
|
|
|
|
only extend on a per request basis
|
|
|
|
|
|
|
|
- documentation
|
|
|
|
- different baud rates?
|
|
|
|
- test custom chars
|
|
|
|
- more testing.
|
|
|
|
- test 27976 and 27977 display
|
|
|
|
- extend unit test
|
|
|
|
|