Подключаем дисплей WH1604A к ATmega8 по шине I²C

В предыдущем уроке мы создали собственную библиотеку для аппаратного интерфейса I²C/TWI микроконтроллера ATmega8.

Теперь используем её для подключения символьного дисплея WH1604A — 16 символов × 4 строки. Между дисплеем и микроконтроллером установим модуль на базе PCF8574.

Зачем нужен PCF8574

Сам WH1604A имеет обычный параллельный интерфейс семейства HD44780. Даже в 4-битном режиме для его подключения требуется несколько выводов микроконтроллера.

PCF8574 представляет собой восьмиразрядный расширитель портов, которым можно управлять по I²C.

В результате для подключения дисплея к ATmega8 нужны только две сигнальные линии:

  • PC4 — SDA
  • PC5 — SCL
Переходник PCF8574 для LCD
Плата переходника I²C на базе PCF8574
Подключение дисплея WH1604A через PCF8574
Дисплей с установленным I²C-переходником

Настройку самой шины I²C мы уже разобрали в предыдущем уроке: AVR-7 — создаём библиотеку I²C/TWI.

Как PCF8574 подключён к дисплею

В используемом переходнике выводы PCF8574 распределены следующим образом:

PCF8574 LCD Назначение
P0 RS Выбор команды или данных
P1 R/W Чтение / запись
P2 E Enable
P3 LED Подсветка
P4 D4 4-битная шина данных
P5 D5
P6 D6
P7 D7
Такая разводка используется на нашем модуле. У другого варианта I²C-переходника назначение выводов PCF8574 теоретически может отличаться.

Адрес PCF8574

В старой версии программы использовался адрес:

0b01001110

В десятичном представлении байта это:

0b01001110 = 0x4E

Но это не 7-битный адрес устройства, а уже сформированный адресный байт для операции записи.

В новой библиотеке I²C мы используем обычный 7-битный адрес:

#define LCD_I2C_ADDRESS   0x27

Библиотека I²C сама преобразует его:

0x27 << 1 = 0x4E
Важно: адрес PCF8574 зависит от состояния выводов A0, A1 и A2. Поэтому значение 0x27 относится именно к используемому в нашем примере модулю. Если дисплей не отвечает, первым делом необходимо проверить фактический I²C-адрес переходника.

Работа дисплея в 4-битном режиме

Дисплей принимает 8-битные команды и символы, но физически мы используем только четыре линии данных:

D4
D5
D6
D7

Поэтому каждый байт передаём за два этапа. Сначала передаётся старшая половина:

D7 D6 D5 D4

Затем младшая половина байта.

После установки данных необходимо сформировать импульс на линии E.

RS, R/W и E

  • RS = 0 — передаём команду дисплею.
  • RS = 1 — передаём символ для отображения.
  • R/W = 0 — запись в дисплей.
  • E — импульс подтверждения передачи данных.

В этом уроке данные из дисплея не считываем, поэтому линию R/W всегда держим в нуле.

Адреса строк WH1604A

У дисплея 16×4 строки располагаются в памяти DDRAM не подряд.

Строка Первый адрес DDRAM Команда установки курсора
1 0x00 0x80
2 0x40 0xC0
3 0x10 0x90
4 0x50 0xD0
Именно поэтому нельзя вычислять адрес строки простой формулой номер строки × 16.

Для WH1604A используем таблицу:

0x00, 0x40, 0x10, 0x50

Из каких файлов будет состоять программа

  • i2c.h / i2c.c — библиотека I²C из урока AVR-7.
  • lcd.h / lcd.c — новая библиотека WH1604A.
  • main.c — пример использования дисплея.

Заголовочный файл lcd.h

#ifndef LCD_H_
#define LCD_H_


#include <stdint.h>

#include "i2c.h"


/* ----------------------------------------------------------
   Адрес PCF8574

   Старый адресный байт:
   0x4E

   7-битный адрес:
   0x27
   ---------------------------------------------------------- */

#define LCD_I2C_ADDRESS   0x27


/* ----------------------------------------------------------
   Размер дисплея
   ---------------------------------------------------------- */

#define LCD_COLUMNS       16
#define LCD_ROWS          4


/* ----------------------------------------------------------
   Функции
   ---------------------------------------------------------- */

I2C_Result LCD_Init(void);

I2C_Result LCD_Clear(void);

I2C_Result LCD_Home(void);

I2C_Result LCD_SetCursor(
    uint8_t x,
    uint8_t y
);

I2C_Result LCD_PutChar(
    char c
);

I2C_Result LCD_Print(
    const char *str
);

I2C_Result LCD_BacklightOn(void);

I2C_Result LCD_BacklightOff(void);


#endif /* LCD_H_ */

Рабочий файл lcd.c

#ifndef F_CPU
#define F_CPU 4000000UL
#endif


#include "lcd.h"

#include <util/delay.h>


/* ----------------------------------------------------------
   Биты PCF8574

   P0 = RS
   P1 = R/W
   P2 = E
   P3 = подсветка

   P4 = D4
   P5 = D5
   P6 = D6
   P7 = D7
   ---------------------------------------------------------- */

#define LCD_RS       0x01
#define LCD_RW       0x02
#define LCD_E        0x04
#define LCD_LED      0x08


/* ----------------------------------------------------------
   Команды HD44780
   ---------------------------------------------------------- */

#define LCD_CLEAR_DISPLAY     0x01
#define LCD_RETURN_HOME       0x02

#define LCD_ENTRY_MODE        0x06

#define LCD_DISPLAY_OFF       0x08
#define LCD_DISPLAY_ON        0x0C

#define LCD_FUNCTION_4BIT     0x28


/* ----------------------------------------------------------
   Состояние подсветки
   ---------------------------------------------------------- */

static uint8_t lcd_backlight =
    LCD_LED;


/* ----------------------------------------------------------
   Запись байта в PCF8574
   ---------------------------------------------------------- */

static I2C_Result LCD_ExpanderWrite(
    uint8_t value
)
{
    return I2C_WriteByte(
        LCD_I2C_ADDRESS,
        value
    );
}


/* ----------------------------------------------------------
   Импульс на линии E
   ---------------------------------------------------------- */

static I2C_Result LCD_PulseEnable(
    uint8_t value
)
{
    I2C_Result result;


    /*
        E = 1
    */
    result =
        LCD_ExpanderWrite(
            value | LCD_E
        );


    if (result != I2C_OK)
    {
        return result;
    }


    _delay_us(1);


    /*
        E = 0
    */
    result =
        LCD_ExpanderWrite(
            value & ~LCD_E
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Большинство обычных
        команд выполняются
        примерно за десятки мкс.
    */
    _delay_us(50);


    return I2C_OK;
}


/* ----------------------------------------------------------
   Передача одной половины байта

   nibble должен находиться
   в старших четырёх битах.
   ---------------------------------------------------------- */

static I2C_Result LCD_SendNibble(
    uint8_t nibble,
    uint8_t rs
)
{
    uint8_t value;


    value =
        (nibble & 0xF0)
        |
        lcd_backlight;


    /*
        Команда или данные
    */
    if (rs)
    {
        value |= LCD_RS;
    }


    /*
        R/W всегда равен 0,
        поскольку используем
        только запись.
    */
    value &= ~LCD_RW;


    return LCD_PulseEnable(value);
}


/* ----------------------------------------------------------
   Передача полного байта
   ---------------------------------------------------------- */

static I2C_Result LCD_SendByte(
    uint8_t value,
    uint8_t rs
)
{
    I2C_Result result;


    /*
        Старшие 4 бита
    */
    result =
        LCD_SendNibble(
            value & 0xF0,
            rs
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Младшие 4 бита
        переносим в D4...D7
    */
    result =
        LCD_SendNibble(
            value << 4,
            rs
        );


    return result;
}


/* ----------------------------------------------------------
   Команда
   ---------------------------------------------------------- */

static I2C_Result LCD_Command(
    uint8_t command
)
{
    return LCD_SendByte(
        command,
        0
    );
}


/* ----------------------------------------------------------
   Символ
   ---------------------------------------------------------- */

I2C_Result LCD_PutChar(
    char c
)
{
    return LCD_SendByte(
        (uint8_t)c,
        1
    );
}


/* ----------------------------------------------------------
   Инициализация WH1604A

   Последовательность перевода
   HD44780 в 4-битный режим.
   ---------------------------------------------------------- */

I2C_Result LCD_Init(void)
{
    I2C_Result result;


    /*
        После включения питания
        дисплею необходимо время.
    */
    _delay_ms(50);


    /*
        Начальное состояние PCF8574.

        Подсветка включена,
        E = 0,
        R/W = 0,
        RS = 0.
    */
    result =
        LCD_ExpanderWrite(
            lcd_backlight
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Инициализация согласно
        стандартной последовательности
        HD44780.
    */

    result =
        LCD_SendNibble(
            0x30,
            0
        );


    if (result != I2C_OK)
    {
        return result;
    }


    _delay_ms(5);


    result =
        LCD_SendNibble(
            0x30,
            0
        );


    if (result != I2C_OK)
    {
        return result;
    }


    _delay_us(150);


    result =
        LCD_SendNibble(
            0x30,
            0
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Переводим дисплей
        в 4-битный режим.
    */
    result =
        LCD_SendNibble(
            0x20,
            0
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        4-битный интерфейс,
        режим для многострочного LCD.
    */
    result =
        LCD_Command(
            LCD_FUNCTION_4BIT
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        На время настройки
        выключаем изображение.
    */
    result =
        LCD_Command(
            LCD_DISPLAY_OFF
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Очищаем дисплей.
    */
    result =
        LCD_Clear();


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        После записи символа
        курсор автоматически
        перемещается вправо.
    */
    result =
        LCD_Command(
            LCD_ENTRY_MODE
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Включаем экран.

        Курсор выключен.
        Мигание выключено.
    */
    result =
        LCD_Command(
            LCD_DISPLAY_ON
        );


    if (result != I2C_OK)
    {
        return result;
    }


    return LCD_Home();
}


/* ----------------------------------------------------------
   Очистка
   ---------------------------------------------------------- */

I2C_Result LCD_Clear(void)
{
    I2C_Result result;


    result =
        LCD_Command(
            LCD_CLEAR_DISPLAY
        );


    if (result != I2C_OK)
    {
        return result;
    }


    /*
        Clear Display —
        медленная команда.
    */
    _delay_ms(2);


    return I2C_OK;
}


/* ----------------------------------------------------------
   Курсор в начало
   ---------------------------------------------------------- */

I2C_Result LCD_Home(void)
{
    I2C_Result result;


    result =
        LCD_Command(
            LCD_RETURN_HOME
        );


    if (result != I2C_OK)
    {
        return result;
    }


    _delay_ms(2);


    return I2C_OK;
}


/* ----------------------------------------------------------
   Установка курсора

   x = 0...15
   y = 0...3
   ---------------------------------------------------------- */

I2C_Result LCD_SetCursor(
    uint8_t x,
    uint8_t y
)
{
    /*
        Карта DDRAM WH1604A
    */
    static const uint8_t row_address[4] =
    {
        0x00,
        0x40,
        0x10,
        0x50
    };


    /*
        Проверяем координаты.
    */
    if (x >= LCD_COLUMNS)
    {
        return I2C_ERROR_DATA;
    }


    if (y >= LCD_ROWS)
    {
        return I2C_ERROR_DATA;
    }


    /*
        Бит 7 = 1 —
        Set DDRAM Address.
    */
    return LCD_Command(
        0x80
        |
        row_address[y]
        |
        x
    );
}


/* ----------------------------------------------------------
   Вывод строки
   ---------------------------------------------------------- */

I2C_Result LCD_Print(
    const char *str
)
{
    I2C_Result result;


    while (*str)
    {
        result =
            LCD_PutChar(
                *str
            );


        if (result != I2C_OK)
        {
            return result;
        }


        str++;
    }


    return I2C_OK;
}


/* ----------------------------------------------------------
   Подсветка ON
   ---------------------------------------------------------- */

I2C_Result LCD_BacklightOn(void)
{
    lcd_backlight =
        LCD_LED;


    return LCD_ExpanderWrite(
        lcd_backlight
    );
}


/* ----------------------------------------------------------
   Подсветка OFF
   ---------------------------------------------------------- */

I2C_Result LCD_BacklightOff(void)
{
    lcd_backlight = 0;


    return LCD_ExpanderWrite(0);
}

Основная программа main.c

Теперь использование дисплея получается достаточно простым.

#define F_CPU 4000000UL


#include <avr/io.h>
#include <util/delay.h>


#include "i2c.h"
#include "lcd.h"


int main(void)
{
    I2C_Result result;


    /*
        Инициализация аппаратного I2C.
    */
    I2C_Init();


    /*
        Инициализация WH1604A.
    */
    result =
        LCD_Init();


    /*
        Если дисплей или PCF8574
        не ответил по I2C,
        сюда можно добавить
        обработку ошибки.
    */
    if (result != I2C_OK)
    {
        while (1)
        {
            /*
                Ошибка I2C.
            */
        }
    }


    /*
        Очищаем экран.
    */
    LCD_Clear();


    /*
        Первая строка.
    */
    LCD_SetCursor(0, 0);

    LCD_Print(
        "Hello World!"
    );


    /*
        Вторая строка.
    */
    LCD_SetCursor(0, 1);

    LCD_Print(
        "ATmega8 + I2C"
    );


    /*
        Третья строка.
    */
    LCD_SetCursor(0, 2);

    LCD_Print(
        "WH1604A"
    );


    /*
        Четвёртая строка.
    */
    LCD_SetCursor(0, 3);

    LCD_Print(
        "TexnoHelp"
    );


    while (1)
    {
        /*
            Основная программа
        */
    }
}

Как вывести текст в нужное место

Положение курсора задаётся функцией:

LCD_SetCursor(x, y);

Например:

LCD_SetCursor(5, 2);

LCD_Print("AVR");

В данном случае первый символ будет записан в третьей строке, начиная с позиции №6.

В программе координаты начинаются с нуля:

x = 0...15
y = 0...3

Управление подсветкой

Подсветку можно включать и выключать программно через P3 микросхемы PCF8574.

LCD_BacklightOn();

LCD_BacklightOff();

Почему новая версия лучше старой

В старом варианте управление RS, E и подсветкой выполнялось непосредственно макросами, например:

I2C_SendByteAdres(portlcd |= 0x04, 0x4E)

Теперь аппаратная часть PCF8574 полностью спрятана внутри библиотеки LCD. Основная программа работает уже с понятными функциями:

LCD_Init()
LCD_Clear()
LCD_SetCursor()
LCD_Print()
LCD_BacklightOn()
LCD_BacklightOff()

Структура передачи одного символа

Например, необходимо вывести символ:

'A' = 0x41

Библиотека выполняет следующую последовательность:

  • устанавливает RS = 1;
  • передаёт старшие четыре бита байта 0x41;
  • формирует импульс E;
  • передаёт младшие четыре бита;
  • снова формирует импульс E;
  • контроллер дисплея сохраняет полный 8-битный символ.

Что получили в результате

Теперь ATmega8 использует всего две сигнальные линии для управления четырёхстрочным LCD:

PC4 — SDA
PC5 — SCL

Через PCF8574 мы управляем четырьмя линиями данных, RS, E и подсветкой дисплея.

При этом основная программа вообще не работает напрямую с портами PCF8574 — вся низкоуровневая логика находится внутри библиотек I2C и LCD.