net.freeutils.scrollphat

Class MockDevice

java.lang.Object

net.freeutils.scrollphat.Device

net.freeutils.scrollphat.MockDevice

All Implemented Interfaces:

Closeable, AutoCloseable

public class MockDevice
extends Device

A Device implementation that writes to the console instead of to a real device. All writes to the device are logged, and display updates are printed out as ASCII art.

This class is extremely convenient to use for debugging, during development on a desktop PC, or on a Raspberry Pi which does not (yet) have a real device connected to it.

Field Summary

Fields inherited from class net.freeutils.scrollphat.Device

ADDR_GND, ADDR_SCL, ADDR_SDA, ADDR_VCC, CONFIG_AUDIO_INPUT, CONFIG_DISPLAY_MATRIX_1, CONFIG_DISPLAY_MATRIX_1_AND_2, CONFIG_DISPLAY_MATRIX_2, CONFIG_MATRIX_5X11, CONFIG_MATRIX_6X10, CONFIG_MATRIX_7X9, CONFIG_MATRIX_8X8, CONFIG_SOFTWARE_SHUTDOWN, errors, height, REG_BRIGHTNESS_CONFIG, REG_BRIGHTNESS_PWM, REG_CONFIG, REG_MATRIX1_DATA_START, REG_MATRIX2_DATA_START, REG_RESET, REG_UPDATE, shutdownHook, throwErrorCount, warnErrorCount, width

Constructor Summary

Constructors

Constructor and Description
MockDevice()

Method Summary

Modifier and Type	Method and Description
protected void	closeImpl() Closes the I2C bus and device.
static void	main(String[] args) The main command-line utility entry point.
protected Device	openImpl(int busNumber, int address) Opens the connection to the I2C bus and to the device at the given address.
void	update() Updates the display.
protected void	writeImpl(byte register, byte[] data, int offset, int length) Writes a series of bytes of data starting at the given register.

Methods inherited from class net.freeutils.scrollphat.Device

close, closeOnShutdown, configure, displayTestPatterns, getHeight, getWidth, handleError, init, newInstance, newInstance, open, open, reset, setBrightness, setDisplay, setDisplay, setDisplay, setDisplay, update, write, write, writeImpl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MockDevice

public MockDevice()

Method Detail

openImpl

protected Device openImpl(int busNumber,
                          int address)
                   throws IOException

Description copied from class: Device

Opens the connection to the I2C bus and to the device at the given address.

Specified by:

openImpl in class Device

Parameters:

busNumber - the I2C bus number to use

address - the I2C device address

Returns:

this device

Throws:

IOException - if an error occurs

closeImpl

protected void closeImpl()

Description copied from class: Device

Closes the I2C bus and device.

This method may be called multiple times, or without a successful call to Device.open(int) before it.

Specified by:

closeImpl in class Device

writeImpl

protected void writeImpl(byte register,
                         byte[] data,
                         int offset,
                         int length)
                  throws IOException

Description copied from class: Device

Writes a series of bytes of data starting at the given register. The register number is incremented by one after each written byte.

Specified by:

writeImpl in class Device

Parameters:

register - the register to write to

data - an array containing the data to write

offset - the offset within the array of the first byte to write

length - the number of bytes to write

Throws:

IOException - if an error occurs

update

public void update()
            throws IOException

Description copied from class: Device

Updates the display. This method must be called after modifying the display data in order for the changes to be applied.

Overrides:

update in class Device

Throws:

IOException - if an error occurs

main

public static void main(String[] args)
                 throws IOException,
                        InterruptedException

The main command-line utility entry point.

Parameters:

args - the arguments

Throws:

IOException - if an error occurs

InterruptedException - if the thread is interrupted