- DEVICE MODELS
Device::Chip::SSD1306 - chip driver for monochrome OLED modules
This abstract Device::Chip subclass provides communication to an SSD1306 or SH1106 chip attached by an adapter. To actually use it, you should use one of the subclasses for the various interface types.
The reader is presumed to be familiar with the general operation of this chip; the documentation here will not attempt to explain or define chip-specific concepts or features, only the use of this module to access them.
This module supports a variety of actual chip modules with different display sizes. The specific display module is selected by the
model argument to the constructor, which should take one of the following values:
An SSD1306 driving a display with 128 columns and 64 rows. The most common of the display modules, often found with a 0.96 inch display.
An SSD1306 driving a display with 128 columns and 32 rows. This is the usual "half-height" display.
An SH1106 driving a display with 128 columns and 64 rows. This is the chip that's usually found in the larger display modules, such as 1.3 and 1.6 inch.
$chip = Device::Chip::SSD1306->new( model => $model, )
Returns a new
Device::Chip::SSD1306 driver instance for the given model name, which must be one of the models listed in "DEVICE MODELS". If no model option is chosen, the default of
SSD1306-128x64 will apply.
The following methods documented with a trailing call to
->get return Future instances.
$n = $chip->rows $n = $chip->columns
Simple accessors that return the number of rows or columns present on the physical display.
Initialise the display after reset to some sensible defaults.
$chip->display( $on )->get
Turn on or off the display.
$chip->display_lamptest( $enable )->get
Turn on or off the all-pixels-lit lamptest mode.
$chip->send_display( $pixels )->get
Sends an entire screen-worth of pixel data. The
$pixels should be in a packed binary string containing one byte per 8 pixels.
More interfaces - 3-wire SPI
Maintain a framebuffer. Add some drawing commands like pixels and lines.
Paul Evans <email@example.com>