GY-63_MS5611/libraries/Par27979/readme.md

87 lines
2.5 KiB
Markdown
Raw Normal View History

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