# lcd_sterm_master

STERM Master library for JALLIB

Author | Javier Martnez & Eur Van Andel Copyright © 2003-2009 All rights reserved
Adapted-by | William Welch
Compiler | 2.4

Description

    Sterm (Serial Terminal) is a protocol to write to an standard HD44780 LCD
    and read from a 4x4 matrix keyboard. It was developed for easy debugging of JAL programs.
    With Sterm and a single PIC pin you can do a  lot of human interfacing, often to the point that
    nothing else is needed. Especially usefull for projects "beyond the PC", that have to work in the field.

Dependencies

- delay
- lcd_hd44780_common

## Summary

### Global variables/contants

- `var byte lastkey = 0xff`

### Procedures

- `lcd_init()`

Private

- `_lcd_write_data( byte in data3 )`
- `_lcd_write_command( byte in instr )`

### Functions

- `lcd_key'get() return byte`
- `lcd_buflag() return byte`
- `getkey() return byte`
- `getkey_once() return byte`

Private

- `__term_byte( byte in command1 , byte in data1 ) return byte`

## API details

### Global variables/contants

- `var byte lastkey = 0xff`

  No documentation found

### Procedures

- `lcd_init()`

      Send reset to Terminal:
      Clear the LCD and makes a sw reset of the PIC.

Private

- `_lcd_write_data( byte in data3 )`

      Send 'hd447804 data' command to Terminal:

- `_lcd_write_command( byte in instr )`

      Send 'hd447804 instruction' command to Terminal:

### Functions

- `lcd_key'get() return byte`

      Send 'input keyboard' command to Terminal:

- `lcd_buflag() return byte`

      Send 'input buffer' command to Terminal:

- `getkey() return byte`

      getkey - return the key pressed (until it is released)

- `getkey_once() return byte`

      getkey_once - return the value of a key pressed only once

Private

- `__term_byte( byte in command1 , byte in data1 ) return byte`

  No documentation found

## Related samples

Here are the list of samples which use this library:

16f819 | 16f819_mcp2515_can_monitor.jal
16f819 | 16f819_ee25aa02e48_lcd.jal
16f819 | 16f819_mcp2515_canid4_monitor.jal
18f2585 | 18f2585_1wire_ds1820.jal
18f2585 | 18f2585_canid4_serial_adapter.jal
18f2585 | 18f2585_can_serial_adapter.jal
18f2585 | 18f2585_can_monitor.jal
18f2585 | 18f2585_canid4_monitor.jal
18f2620 | 18f2620_rtc_tmr3.jal
18f2685 | 18f2685_math.jal
18f452 | 18f452_pressure.jal
18f4585 | 18f4585_canid4_monitor.jal
18f67k22 | 18f67k22_co2_i2c.jal