lcdproxima.c

Go to the documentation of this file.

/**
 * @file        lcdproxima.c
 * @brief       LCD handling functions for Proxima-01 LCD.
 * @author      Copyright (C) Peter Ivanov, 2008
 *
 * Created:     2008-03-31 10:19:22 
 * Last modify: 2010-08-08 06:54:19 ivanovp {Time-stamp}
 * Licence:     GPL
 */

#include <avr/io.h>
#include <avr/interrupt.h>
#include <util/delay.h>
#include "common.h"
#include "lcdproxima.h"

/** 
 * Internal mirror of latches in PCF2111. Upper 32-bit is latch A, lower 32-bit is latch B.
 */
uint64_t latches = 0;
/**
 * Array to store the numbers for the four digit of LCD
 */
//                      .----- column
//                      |  .-- characters: 0123456789ABCDEF
//                      V  V
const uint64_t LCDP_characters[4][16] =
{
    {
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F,      // 0
        LCDP_SEGMENT_0B | LCDP_SEGMENT_0C,                                                                              // 1
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0G,                        // 2
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0G,                        // 3
        LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,                                          // 4
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,                        // 5
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,      // 6
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C,                                                            // 7
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,    // 8
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,      // 9
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,      // A
        LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,                        // B
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F,                                          // C
        LCDP_SEGMENT_0B | LCDP_SEGMENT_0C | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0G,                        // D
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0D | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,                        // E
        LCDP_SEGMENT_0A | LCDP_SEGMENT_0E | LCDP_SEGMENT_0F | LCDP_SEGMENT_0G,                                          // F
    },
    {
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F,      // 0
        LCDP_SEGMENT_1B | LCDP_SEGMENT_1C,                                                                              // 1
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1G,                        // 2
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1G,                        // 3
        LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,                                          // 4
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,                        // 5
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,      // 6
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C,                                                            // 7
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,    // 8
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,      // 9
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,      // A
        LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,                        // B
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F,                                          // C
        LCDP_SEGMENT_1B | LCDP_SEGMENT_1C | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1G,                        // D
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1D | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,                        // E
        LCDP_SEGMENT_1A | LCDP_SEGMENT_1E | LCDP_SEGMENT_1F | LCDP_SEGMENT_1G,                                          // F
    },
    {
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F,      // 0
        LCDP_SEGMENT_2B | LCDP_SEGMENT_2C,                                                                              // 1
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2G,                        // 2
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2G,                        // 3
        LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,                                          // 4
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,                        // 5
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,      // 6
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C,                                                            // 7
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,    // 8
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,      // 9
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,      // A
        LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,                        // B
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F,                                          // C
        LCDP_SEGMENT_2B | LCDP_SEGMENT_2C | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2G,                        // D
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2D | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,                        // E
        LCDP_SEGMENT_2A | LCDP_SEGMENT_2E | LCDP_SEGMENT_2F | LCDP_SEGMENT_2G,                                          // F
    },
    {
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F,      // 0
        LCDP_SEGMENT_3B | LCDP_SEGMENT_3C,                                                                              // 1
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3G,                        // 2
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3G,                        // 3
        LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,                                          // 4
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,                        // 5
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,      // 6
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C,                                                            // 7
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,    // 8
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,      // 9
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,      // A
        LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,                        // B
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F,                                          // C
        LCDP_SEGMENT_3B | LCDP_SEGMENT_3C | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3G,                        // D
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3D | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,                        // E
        LCDP_SEGMENT_3A | LCDP_SEGMENT_3E | LCDP_SEGMENT_3F | LCDP_SEGMENT_3G,                                          // F
    },
};

/**
 * Initialize ports.
 */
void LCDP_init (void)
{
    LCDP_DDR |= LCDP_DATA | LCDP_CLB | LCDP_DLEN; // configured as outputs
    LCDP_PORT &= ~(LCDP_DATA | LCDP_CLB | LCDP_DLEN);
}

/**
 * Toggle clock burst pin of PCF2111.
 */
void LCDP_toggleCLB (void)
{
    LCDP_PORT |= LCDP_CLB;
    _delay_us (10); /* wait 10 us */
    LCDP_PORT &= ~LCDP_CLB;
    _delay_us (10); /* wait 10 us */
}

/**
 * Put data to latch A or latch B. Both latches have 32 bits.
 *
 * Input:
 *   @param segments Latch data: which segments should be enabled.
 *   @param latchA Select latch. TRUE: latch A, FALSE: latch B.
 */
void LCDP_writeLatch (uint32_t segments, bool_t latchA)
{
    uint8_t i;

    LCDP_PORT |= LCDP_DLEN;
    LCDP_PORT &= ~(LCDP_DATA | LCDP_CLB);
    LCDP_toggleCLB ();
    /* Shift out bits to the right. (LSB first) */
    for (i = 0; i < 32; i++)
    {
        if (segments & 0x0001)
        {
            LCDP_PORT |= LCDP_DATA;
        }
        else
        {
            LCDP_PORT &= ~LCDP_DATA;
        }
        segments >>= 1;
        LCDP_toggleCLB ();
    }
    /* Select latch with the last bit */
    if (latchA)
    {
        LCDP_PORT |= LCDP_DATA;
    }
    else
    {
        LCDP_PORT &= ~LCDP_DATA;
    }
    LCDP_toggleCLB ();
    LCDP_PORT &= ~LCDP_DLEN;
    LCDP_toggleCLB ();
}

/**
 * Write internal latches to PCF2111's latches.
 */
void LCDP_writeLatches (void)
{
    LCDP_writeLatch (latches >> 32, TRUE);
    LCDP_writeLatch (latches & 0xFFFFFFFFul, FALSE);
}

/**
 * Clear all segment of LCD.
 *
 * @author Peter Ivanov
 */
void LCDP_clear (void)
{
    latches = (uint64_t) 0;
    LCDP_writeLatches ();
}

/**
 * Shows all segment of LCD. Useful for testing the LCD.
 *
 * @author Peter Ivanov
 */
void LCDP_all (void)
{
    latches = (uint64_t) 0xFFFFFFFFFFFFFFFFul;
    LCDP_writeLatches ();
}

/**
 * Print number to LCD in decimal format.
 *
 * Input:
 *   @param number Number to print.
 *   @param leadingZeros TRUE: print leading zeros. FALSE: don't print zeros.
 */
void LCDP_printNumber (uint16_t number, bool_t leadingZeros)
{
    uint8_t digit = 0;
    // Clearing all numbers
    latches &= ~(LCDP_characters[0][8] | 
            LCDP_characters[1][8] | 
            LCDP_characters[2][8] | 
            LCDP_characters[3][8]);
    if (number < 10000u)
    {
        if (number == 0u)
        {
            if (leadingZeros)
            {
                latches |= LCDP_characters[0][0] | LCDP_characters[1][0] | LCDP_characters[2][0] | 
                    LCDP_characters[3][0];
            }
            else
            {
                latches |= LCDP_characters[0][0];
            }
        }
        else
        {
            while ((leadingZeros && digit < 4u) || number > 0)
            {
                latches |= LCDP_characters[digit][number % 10u];
                number /= 10u;
                digit++;
            }
        }
    }
    else
    {
        // error!
        latches |= LCDP_characters[0][0xE] | LCDP_SEGMENT_MAX; // display alphabet E
    }
    LCDP_writeLatches ();
}

/**
 * Print number to LCD in hexadecimal format.
 *
 * Input:
 *   @param number Number to print.
 */
void LCDP_printNumberHex (uint16_t number)
{
    uint8_t digit = 0;
    // Clearing all segments of numbers
    latches &= ~(LCDP_characters[0][8] | 
            LCDP_characters[1][8] | 
            LCDP_characters[2][8] | 
            LCDP_characters[3][8]);
    if (number == 0)
    {
        /* 0 will be displayed */
        latches |= LCDP_characters[0][0];
    }
    else
    {
        while (number > 0)
        {
            latches |= LCDP_characters[digit][number & 0xF];
            number >>= 4;
            digit++;
        }
    }
    LCDP_writeLatches ();
}

/**
 * Print number to LCD in hexadecimal format.
 *
 * Input:
 *   @param number Number to print.
 */
void LCDP_printNumberHexLZ (uint16_t number)
{
    uint8_t digit = 0;
    // Clearing all segments of numbers
    latches &= ~(LCDP_characters[0][8] | 
            LCDP_characters[1][8] | 
            LCDP_characters[2][8] | 
            LCDP_characters[3][8]);
    while (digit < 4)
    {
        latches |= LCDP_characters[digit][number & 0xF];
        number >>= 4;
        digit++;
    }
    LCDP_writeLatches ();
}

#if 0
/**
 * Switches LCD's backlight on/off.
 *
 * @author Peter Ivanov
 *
 * Input:
 *    @param on TRUE: switch on, FALSE: switch off.
 */
void LCDP_setBacklight (bool_t on)
{
    if (on)
    {
        //LCDP_PORT |= LCDP_BACKLIGHT;
    }
    else  
    {
        //LCDP_PORT &= ~LCDP_BACKLIGHT;
    }
}
#endif

---