NAME

Device::Chip::NoritakeGU_D - chip driver for Noritake GU-D display modules

SYNOPSIS

   use Device::Chip::NoritakeGU_D;
   use Future::AsyncAwait;

   my $chip = Device::Chip::NoritakeGU_D->new( interface => "UART" );
   await $chip->mount( Device::Chip::Adapter::...->new );

   await $chip->text( "Hello, world!" );

DESCRIPTION

This Device::Chip subclass provides communication to a display module in the GU-D family by Noritake.

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.

CONSTRUCTOR

new

   $chip = Device::Chip::NoritakeGU_D->new(
      interface => $iface,
      ...
   )

Constructs a new driver instance for the given interface type. The type must be one of UART, I2C or SPI.

METHODS

The following methods documented in an await expression return Future instances.

text

   await $chip->text( $str );

Draw text at the cursor position.

cursor_left

cursor_right

cursor_home

   await $chip->cursor_left;
   await $chip->cursor_right;

   await $chip->cursor_linehome;

   await $chip->cursor_home;

Move the cursor left or right one character position, to the beginning of the line, or to the home position (top left corner).

cursor_goto

   await $chip->cursor_goto( $x, $y );

Moves the cursor to the $x'th column of the $y'th line (zero-indexed).

linefeed

   await $chip->linefeed;

Move the cursor down to the next line.

clear

   $chip->clear

Clear the display.

select_window

   await $chip->select_window( $win );

Select the main window (when $win is 0), or one of the four numbered sub-windows.

initialise

   $chip->initialise

Reset all settings to their default values.

set_cursor_visible

   await $chip->set_cursor_visible( $bool );

Set whether the cursor is visible.

set_brightness

   await $chip->set_brightness( $val );

Set the display brightness, from 1 to 8.

set_reverse

   await $chip->set_reverse( $bool );

Sets whether subsequent text will be rendered in "reverse video" (clear pixels on a set background) effect.

set_write_mixture_display_mode

   await $chip->set_write_mixture_display_mode( $mode );

Set the combining mode for newly-added display content. $mode must be one of

   set or and xor

set_font_size

   await $chip->set_font_size( $size );

Set the font size. $size must be one of

   5x7 8x16

set_font_width

   await $chip->set_font_width( $width );

Set the font width. $width must be one of

   fixed fixed2 prop prop2

set_font_magnification

   await $chip->set_font_magnification( $xscale, $yscale );

Set the font scaling factor. $xscale must be between 1 to 4, and $yscale must be 1 or 2.

realtime_image_display_columns

   await $chip->realtime_image_display_columns( @columns );

Sends a bitmapped image to the display, at the cursor position. The cursor is not moved.

@columns should be a list of strings of equal length, containing bytes of pixel data to represent each vertical column of the image content.

set_gpio_direction

   await $chip->set_gpio_direction( $dir );

Configure the GPIO pins for input or output. $dir is bitmask of four bits. Low bits correspond to input, high bits to output.

set_gpio_output

   await $chip->set_gpio_output( $value );

Write the value to the GPIO pins.

read_gpio

   $value = await $chip->read_gpio;

Returns the current state of the GPIO pins.

read_touchswitches

   $switches = await $chip->read_touchswitches;

Reads the status of the panel touch switches. Returns a hash reference whose keys are the names of the touch areas (SW1, SW2, ...) and values are booleans indicating whether that area currently detects a touch.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>

cpanm Device::Chip::NoritakeGU_D

perl -MCPAN -e shell
install Device::Chip::NoritakeGU_D