Keypad Library
The mikroPascal PRO for AVR provides a library for working with 4x4 keypad. The library routines can also be used with 4x1, 4x2, or 4x3 keypad. For connections explanation see schematic at the bottom of this page.
External dependencies of Keypad Library
The following variable must be defined in all projects using Keypad Library: | Description : | Example : |
---|---|---|
var keypadPort : byte; sfr; external; |
Keypad Port. | var keypadPort : byte at PORTB; |
var keypadPort_Direction : byte; sfr; external; |
Direction of the Keypad Port. | var keypadPort_Direction : byte at DDRB; |
Library Routines
Keypad_Init
Prototype |
procedure Keypad_Init(); |
---|---|
Returns |
Nothing. |
Description |
Initializes port for working with keypad. |
Requires |
Global variables :
|
Example |
// Initialize PORTB for communication with keypad var keypadPort : byte at PORTB; var keypadPort_Direction : byte at DDRB; ... Keypad_Init(); |
Keypad_Key_Press
Prototype |
function Keypad_Key_Press(): byte; |
---|---|
Returns |
The code of a pressed key (1..16). If no key is pressed, returns 0. |
Description |
Reads the key from keypad when key gets pressed. |
Requires |
Port needs to be initialized for working with the Keypad library, see Keypad_Init. |
Example |
var kp : byte; ... kp := Keypad_Key_Press(); |
Keypad_Key_Click
Prototype |
function Keypad_Key_Click(): byte; |
---|---|
Returns |
The code of a clicked key (1..16). If no key is clicked, returns 0. |
Description |
Call to |
Requires |
Port needs to be initialized for working with the Keypad library, see Keypad_Init. |
Example |
var kp : byte; ... kp := Keypad_Key_Click(); |
Library Example
This is a simple example of using the Keypad Library. It supports keypads with 1..4 rows and 1..4 columns. The code being returned by Keypad_Key_Click() function is in range from 1..16. In this example, the code returned is transformed into ASCII codes [0..9,A..F] and displayed on Lcd. In addition, a small single-byte counter displays in the second Lcd row number of key presses.
program Keypad_Test; var kp, cnt, oldstate : byte; txt : string[6]; // Keypad module connections var keypadPort : byte at PORTC; var keypadPort_Direction : byte at DDRC; // End Keypad module connections // LCD pinout definition var LCD_RS : sbit at PORTD2_bit; var LCD_EN : sbit at PORTD3_bit; LCD_D4 : sbit at PORTD4_bit; LCD_D5 : sbit at PORTD5_bit; LCD_D6 : sbit at PORTD6_bit; LCD_D7 : sbit at PORTD7_bit; var LCD_RS_Direction : sbit at DDD2_bit; LCD_EN_Direction : sbit at DDD3_bit; LCD_D4_Direction : sbit at DDD4_bit; LCD_D5_Direction : sbit at DDD5_bit; LCD_D6_Direction : sbit at DDD6_bit; LCD_D7_Direction : sbit at DDD7_bit; // end LCD pinout definitions begin oldstate := 0; cnt := 0; // Reset counter Keypad_Init(); // Initialize Keypad Lcd_Init(); // Initialize LCD Lcd_Cmd(_LCD_CLEAR); // Clear display Lcd_Cmd(_LCD_CURSOR_OFF); // Cursor off Lcd_Out(1, 1, 'Key :'); // Write message text on LCD Lcd_Out(2, 1, 'Times:'); while TRUE do begin kp := 0; // Reset key code variable // Wait for key to be pressed and released while ( kp = 0 ) do kp := Keypad_Key_Click(); // Store key code in kp variable // Prepare value for output, transform key to it's ASCII value case kp of 1: kp := 49; // 1 2: kp := 50; // 2 3: kp := 51; // 3 4: kp := 65; // A 5: kp := 52; // 4 6: kp := 53; // 5 7: kp := 54; // 6 8: kp := 66; // B 9: kp := 55; // 7 10: kp := 56; // 8 11: kp := 57; // 9 12: kp := 67; // C 13: kp := 42; // * 14: kp := 48; // 0 15: kp := 35; // # 16: kp := 68; // D end; if (kp <> oldstate) then // Pressed key differs from previous begin cnt := 1; oldstate := kp; end else // Pressed key is same as previous Inc(cnt); Lcd_Chr(1, 10, kp); // Print key ASCII value on LCD if (cnt = 255) then // If counter varialble overflow begin cnt := 0; Lcd_Out(2, 10, ' '); end; WordToStr(cnt, txt); // Transform counter value to string Lcd_Out(2, 10, txt); // Display counter value on LCD end; end.
HW Connection
4x4 Keypad connection scheme
What do you think about this topic ? Send us feedback!