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 :

  • keypadPort - Keypad port
  • keypadPort_Direction - Direction of the Keypad port
must be defined before using this function.

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 Keypad_Key_Click is a blocking call: the function waits until some key is pressed and released. When released, the function returns 1 to 16, depending on the key. If more than one key is pressed simultaneously the function will wait until all pressed keys are released. After that the function will return the code of the first pressed key.

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.

Copy Code To ClipboardCopy Code To Clipboard
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

4x4 Keypad connection scheme

Copyright (c) 2002-2012 mikroElektronika. All rights reserved.
What do you think about this topic ? Send us feedback!
Want more examples and libraries? 
Find them on LibStock - A place for the code