Документы по использованию i2C LCD с библиотекой Newliquidcrystal_1.3.5

Часто при разработке программного обеспечения код является документацией. Достоинства этого обсуждаются до отвращения в других местах.

Поскольку вы предоставили ссылку на репозиторий GitHub используемой вами библиотеки, у вас есть все, что вам нужно, хотя предоставленный путь utility/docs не полностью документирует интерфейс I2C.

Прототип функции (то есть функция, тип возвращаемого значения и параметры, но без фактического кода) находится в заголовочных файлах, которые обычно имеют .h суффикс.

Поскольку у вас ЖК-дисплей с интерфейсом I2C, вы можете посмотреть в репозитории GitHub файл LiquidCrystal_I2C.h

В этом файле видно, что класс определен с именем LiquidCrystal_I2C и имеет несколько конструкторов, каждый из которых имеет свой список параметров. Конкретный используемый конструктор класса — это тот, который соответствует количеству и типу, указанным в вашем объявлении объекта этого класса.

Код в заголовочном файле хорошо документирован. Первый из перечисленных прототипов включает в себя хорошие комментарии:

/*!
@метод
@abstract Конструктор класса.
@discussion Инициализирует переменные класса и определяет I2C-адрес
ЖК. Конструктор не инициализирует LCD.

@param lcd_Addr[in] I2C-адрес модуля расширения ввода-вывода. Для I2CLCDextraIO,
адрес можно настроить с помощью перемычек на плате.
*/
   LiquidCrystal_I2C (uint8_t lcd_Addr);
   // Конструктор с управлением подсветкой
   LiquidCrystal_I2C (uint8_t lcd_Addr, uint8_t backlighPin, t_backlighPol pol);

В этом блоке показаны первые 2 параметра конструктора: с типом uint8_t, который определяет адрес I2C модуля расширения ввода-вывода (это то, чем являются многие «ЖК-рюкзаки» — это или регистры сдвига) и один с адресом I2C, выводом подсветки и полярностью подсветки.

Двигаясь вниз, мы находим параметр с 10 параметрами, который вы в итоге и использовали:

 /*!
@метод
@abstract Конструктор класса.
@discussion Инициализирует переменные класса и определяет I2C-адрес
ЖК. Конструктор не инициализирует LCD.

@param lcd_Addr[in] I2C-адрес модуля расширения ввода-вывода. Для I2CLCDextraIO,
адрес можно настроить с помощью перемычек на плате.
@param En[in] LCD En (Enable) контакт, подключенный к модулю расширения ввода-вывода
@param Rw[in] LCD Rw (чтение/запись) вывод, подключенный к модулю расширения ввода-вывода
@param Rs[in] ЖК-вывод Rs (сброс), подключенный к модулю расширения ввода-вывода
@param d4[in] LCD data 0 pin map on module extension IO
@param d5[in] LCD data 1 pin map on module extension IO
@param d6[in] 2-контактная карта данных ЖК-дисплея на модуле расширения ввода-вывода
@param d7[in] 3-контактная карта данных ЖК-дисплея на модуле расширения ввода-вывода
*/
   LiquidCrystal_I2C(uint8_t lcd_Addr, uint8_t En, uint8_t Rw, uint8_t Rs, 
                     uint8_t d4, uint8_t d5, uint8_t d6, uint8_t d7 );
   // Конструктор с управлением подсветкой
   LiquidCrystal_I2C(uint8_t lcd_Addr, uint8_t En, uint8_t Rw, uint8_t Rs, 
                     uint8_t d4, uint8_t d5, uint8_t d6, uint8_t d7,
                     uint8_t backlighPin, t_backlighPol pol);

Последний конструктор используется для переопределения сопоставления контактов по умолчанию от расширителя ввода-вывода до ЖК-дисплея. Это сложно — на чем основывались сопоставления? Расширитель ввода-вывода — это, по сути, способ доступа к нескольким контактам на внешнем чипе через один двухпроводной интерфейс (I2C). Способ подключения ЖК-дисплея зависит от того, какие контакты расширителя ввода-вывода подключены к каким контактам ЖК-дисплея. Формального стандарта не существует, хотя могут существовать соглашения.

Читая страницу GitHub, вы видите, что это

Клон новой библиотеки жидких кристаллов из: https://bitbucket.org/fmalpartida/new-liquidcrystal

По этой ссылке мы попадаем в какую-то документацию, отмечая, что один из типов подключения:

Плата расширения шины ввода-вывода I2C со специализированной микросхемой расширения ввода-вывода I2C PCF8574*, такой как ЖК-дисплей I2C дополнительные операции ввода-вывода.

Ссылка на это оборудование очень кстати! Мы можем перейти по ссылке, чтобы увидеть, что аппаратное обеспечение снято с производства, но полезно задокументировано с некоторыми схемами и макетами печатных плат, которые говорят нам, какие контакты расширителя ввода-вывода подключены к каким контактам ЖК-дисплея:

P0 — это контакт 0 модуля расширения ввода-вывода. В верхнем ряду расположены контакты модуля расширения ввода-вывода. Vo, RS, R/W и т. д. – это контакты ЖК-дисплея.

LCD Pin  |  I/O Expander Pin
     En  |  P4
    R/W  |  P5
E (rst)  |  P6
     D4  |  P0
     D5  |  P1
     D6  |  P2
     D7  |  P3

(Подсветка — это сквозной контакт, а не на расширителе ввода-вывода. Похоже, что определение контакта подсветки и полярность относятся к контактам расширителя ввода-вывода.)

Это тот момент, когда вы должны выяснить, имеет ли купленный вами расширитель ввода-вывода ту же распиновку, что и продукт, для которого была написана эта библиотека.

Ваш "рабочий" экземпляр вызывается как (с аннотациями к вызываемому конструктору)

LiquidCrystal_I2C lcd(
  0x27,       // lcd_Addr
  2,          // En (включить контакт)
  1,          // Rw (вывод чтения/записи)
  0,          // Rs (контакт сброса)
  4,          // d4 (данные)
  5,          // d5 (данные)
  6,          // d6 (данные)
  7,          // d7 (данные)
  3,          // подсветка
  POSITIVE    // полярность подсветки
);

Это указывает на то, что расширитель ввода-вывода на вашем ЖК-дисплее не имеет те же соединения контактов, что и у того, для которого была написана библиотека, поэтому вы добились успеха только при переназначении их в конструкторе. .

Все это только для того, чтобы еще раз повторить, что вам пришлось дергать за волосы!

Фактические доступные функции отмечены:

Эта библиотека предоставляет тот же интерфейс для приложений, что и библиотека LiquidCrystal, входящая в состав Arduino SDK.

Но для верности их прототипы также можно увидеть в заголовочном файле: https: //github.com/fmalpartida/New-LiquidCrystal/blob/master/LCD.h

Он обеспечивает прокрутку, мигание, включение/отключение и т. д.