uterm Module

Provides high level support for the µTerm LCD & keypad. Since there can be multiple µTerm modules on the uConnect bus, each function call must specify an I2C address for the target µTerm. These functions are complete, implementing all the I2C protocol necessary to complete their task, including starting & stopping the I2C transaction. Note that many of these functions are implemented as macros.

ut_cls

void ut_cls(addr);

Clears the screen of the µTerm specified by addr.

ut_move

void ut_move(addr,row,col);

Move the cursor on the µTerm specified by addr to location row,col.

ut_cursor_off

void ut_cursor_off(addr);

Turn the cursor off on the µTerm specified by addr.

ut_cursor_on

void ut_cursor_on(addr);

ut_cursor_flash

void ut_cursor_flash(addr);

Make the cursor flash on the µTerm specified by addr.

ut_display_off

void ut_display_off(addr);

Turns the display off (makes the contents invisible) on the µTerm specified by addr.

ut_display_on

void ut_display_on(addr);

Turns the display on (makes the contents visible) on the µTerm specified by addr.

ut_display_flash

void ut_display_flash(addr);

Makes the display flash on the µTerm specified by addr.

ut_plot

void ut_plot(addr,val);

Plot a bar of length val pixels, starting at the current cursor location on the µTerm specified by addr.

ut_buzzer

void ut_buzzer(addr,ptrn);

Set the buzzer pattern on the µTerm specified by addr.

ut_flush

void ut_flush(addr);

Flush the key buffer on the µTerm specified by addr.

ut_bell

void ut_bell(addr);

Sound the buzzer for a short single beep.

ut_putc

void ut_putc(BYTE addr,BYTE a);

Send a single character to the µTerm specified by addr. Note this may be a character for display or part of a control string.

ut_puts

void ut_puts(BYTE addr,char *x);

Send a string of characters to the µTerm specified by addr. Note that the string may contain both characters for display and control characters. However since the string is null terminated it cannot contain any null characters as part of a control sequence.

ut_printf

void ut_printf(BYTE addr,char *f,...);

Send a formatted string to the µTerm specified by addr. See the xprintf module for the specification of the format.

ut_get_key

BYTE ut_get_key(BYTE addr);

Returns the next key from the key buffer on the specified µTerm.This function returns 0 if the keybuff is empty, else it returns the scan code of the next key.

ut_custom

void ut_custom(BYTE addr,BYTE *def);

Defines a custom character on the µTerm specified by addr. def is a pointer to a 9 element array of bytes, Element 0 should contain the code for the custom character to write, the following 8 elements contain the bit pattern for the custom character. Please see the µTerm manual for details of the construction of custom character bit patterns.