hiroyuki nagahama / LcdAcm1602ni

LCDモジュール ACM1602NI（I2C接続） を制御するライブラリ

Dependents:   scan2 BoxController

LcdAcm1602ni.h@4:7ec26f611f24, 2016-12-14 (annotated)

Committer:
orivant
Date:
Wed Dec 14 05:23:57 2016 +0000
Revision:
4:7ec26f611f24
Parent:
3:05e63be8d2b2
Child:
5:259e6482ac57
??????

Who changed what in which revision?

UserRevisionLine numberNew contents of line
orivant 2:1e305eaf6411 1 #if !defined(LCD_ACM1602NI_H)
orivant 0:c7da9183f23a 2
orivant 2:1e305eaf6411 3 #include "mbed.h"
orivant 2:1e305eaf6411 4
orivant 2:1e305eaf6411 5 #define LCD_ACM1602NI_H
orivant 0:c7da9183f23a 6
orivant 0:c7da9183f23a 7 /** LCDモジュール ACM1602NI を制御するクラス
orivant 1:6e4f2340d316 8 * @brief ACM1602NIをI2C通信で制御します。
orivant 0:c7da9183f23a 9 * @date 2016/12/14
orivant 0:c7da9183f23a 10 * @author H.Nagahama
orivant 4:7ec26f611f24 11 * @code
orivant 4:7ec26f611f24 12 * #include "mbed.h"
orivant 4:7ec26f611f24 13 * #include "LcdAcm1602ni.h"
orivant 4:7ec26f611f24 14 *
orivant 4:7ec26f611f24 15 * LcdAcm1602ni lcd(p9, p10);
orivant 4:7ec26f611f24 16 *
orivant 4:7ec26f611f24 17 * int main() {
orivant 4:7ec26f611f24 18 * wait_ms(15); //!< LCDの安定まで15ms以上待つ必要がある
orivant 4:7ec26f611f24 19 * lcd.puts("Hallow World!");
orivant 4:7ec26f611f24 20 * while(1) {
orivant 4:7ec26f611f24 21 * }
orivant 4:7ec26f611f24 22 * }
orivant 0:c7da9183f23a 23 */
orivant 0:c7da9183f23a 24 class LcdAcm1602ni
orivant 0:c7da9183f23a 25 {
orivant 0:c7da9183f23a 26 public:
orivant 0:c7da9183f23a 27 static const uint8_t SLAVE_ADDR = 0xa0; //!< スレーブアドレス（下位ビットに0を追加済み）
orivant 0:c7da9183f23a 28 static const uint8_t LINE_COUNT = 2; //!< 行数
orivant 0:c7da9183f23a 29 static const uint8_t LINE_CHARA_COUNT = 16; //!< 行の文字数
orivant 0:c7da9183f23a 30
orivant 0:c7da9183f23a 31 private:
orivant 0:c7da9183f23a 32 static const int32_t I2C_MAX_FREQUENCY = 100 * 1000; //!< I2C通信の最大周波数
orivant 0:c7da9183f23a 33 static const uint8_t LINE_HEAD_ADDR_TBL[LINE_COUNT]; //!< 行の先頭アドレス
orivant 0:c7da9183f23a 34
orivant 0:c7da9183f23a 35 static const uint8_t ADDR_BYTE_WRITE = SLAVE_ADDR; //!< アドレス指定用バイトデータ：書き込み用
orivant 0:c7da9183f23a 36 static const uint8_t ADDR_BYTE_READ = SLAVE_ADDR & 0x01; //!< アドレス指定用バイトデータ：読み込み用
orivant 0:c7da9183f23a 37 static const uint8_t CTRL_BYTE_COMMAND = 0x00; //!< 制御指定用バイトデータ：コマンド用
orivant 0:c7da9183f23a 38 static const uint8_t CTRL_BYTE_DATA = 0x80; //!< 制御指定用バイトデータ：データ用
orivant 0:c7da9183f23a 39
orivant 0:c7da9183f23a 40 private:
orivant 0:c7da9183f23a 41 PinName m_pinSDA; //!< SDAピン名
orivant 0:c7da9183f23a 42 PinName m_pinSCL; //!< SCLピン名
orivant 0:c7da9183f23a 43 I2C m_i2c; //!< I2C通信制御
orivant 0:c7da9183f23a 44
orivant 0:c7da9183f23a 45 uint8_t m_currentLineNo; //!< 現在位置：行番号
orivant 0:c7da9183f23a 46 uint8_t m_currentCharaNo; //!< 現在位置：文字番号
orivant 0:c7da9183f23a 47
orivant 0:c7da9183f23a 48 bool m_displayVisible; //!< ディスプレイ表示フラグ
orivant 0:c7da9183f23a 49 bool m_cursorVisible; //!< カーソル表示フラグ
orivant 0:c7da9183f23a 50 bool m_blinkEnable; //!< カーソル点滅フラグ
orivant 0:c7da9183f23a 51
orivant 0:c7da9183f23a 52 public:
orivant 0:c7da9183f23a 53 /** コンストラクタ
orivant 0:c7da9183f23a 54 * @param pinSDA SDAピン指定
orivant 0:c7da9183f23a 55 * @param pinSCL SCLピン指定
orivant 0:c7da9183f23a 56 */
orivant 0:c7da9183f23a 57 LcdAcm1602ni(PinName pinSDA, PinName pinSCL);
orivant 0:c7da9183f23a 58 /** デストラクタ
orivant 0:c7da9183f23a 59 */
orivant 0:c7da9183f23a 60 ~LcdAcm1602ni();
orivant 0:c7da9183f23a 61
orivant 0:c7da9183f23a 62
orivant 0:c7da9183f23a 63 /** 初期化
orivant 0:c7da9183f23a 64 * @brief LCDを初期化し、表示可能な状態にします。
orivant 0:c7da9183f23a 65 * 電源投入後、LCDが安定するまで15ms以上待ってから実行してください。
orivant 0:c7da9183f23a 66 */
orivant 0:c7da9183f23a 67 void initialize();
orivant 0:c7da9183f23a 68
orivant 0:c7da9183f23a 69
orivant 0:c7da9183f23a 70 /** 1文字描画
orivant 0:c7da9183f23a 71 * @brief 1文字描画します。
orivant 0:c7da9183f23a 72 * カーソル位置は一つ進みます。
orivant 0:c7da9183f23a 73 * 行端まで来た場合は自動で復帰・改行します。
orivant 0:c7da9183f23a 74 * @param c 文字コード
orivant 0:c7da9183f23a 75 */
orivant 0:c7da9183f23a 76 void putc(char c);
orivant 0:c7da9183f23a 77 /** 文字列描画
orivant 0:c7da9183f23a 78 * @brief 文字列の終端まで描画します。
orivant 0:c7da9183f23a 79 * カーソル位置は文字数分進みます。
orivant 0:c7da9183f23a 80 * 行端まで来た場合は自動で復帰・改行します。
orivant 0:c7da9183f23a 81 * @param pStr 文字列
orivant 0:c7da9183f23a 82 */
orivant 0:c7da9183f23a 83 void puts(const char* pStr);
orivant 0:c7da9183f23a 84 /** フォーマット指定描画
orivant 0:c7da9183f23a 85 * @brief フォーマットと可変長引数から生成した文字列を描画します。
orivant 0:c7da9183f23a 86 * 文字列生成後、puts()を内部で呼び出しています。
orivant 0:c7da9183f23a 87 * @param pFormat フォーマット
orivant 0:c7da9183f23a 88 * @param ... 可変長引数
orivant 0:c7da9183f23a 89 */
orivant 0:c7da9183f23a 90 void printf(const char* pFormat, ...);
orivant 0:c7da9183f23a 91
orivant 0:c7da9183f23a 92
orivant 0:c7da9183f23a 93 /** カーソル位置変更
orivant 0:c7da9183f23a 94 * @brief 指定位置までカーソルを移動させます。
orivant 0:c7da9183f23a 95 * @param lineNo 行番号（0～LINE_COUNT）
orivant 0:c7da9183f23a 96 * @param charaNo 文字番号（0～LINE_CHARA_COUNT）
orivant 0:c7da9183f23a 97 */
orivant 0:c7da9183f23a 98 void locate(uint8_t lineNo, uint8_t charaNo);
orivant 0:c7da9183f23a 99 /** カーソル位置取得：行番号
orivant 0:c7da9183f23a 100 * @return カーソルのある行番号
orivant 0:c7da9183f23a 101 */
orivant 0:c7da9183f23a 102 uint8_t getCurrentLineNo() const;
orivant 0:c7da9183f23a 103 /** カーソル位置取得：文字番号
orivant 0:c7da9183f23a 104 * @return カーソルのある文字番号
orivant 0:c7da9183f23a 105 */
orivant 0:c7da9183f23a 106 uint8_t getCurrentCharaNo() const;
orivant 0:c7da9183f23a 107
orivant 0:c7da9183f23a 108
orivant 0:c7da9183f23a 109 /** 画面クリア
orivant 0:c7da9183f23a 110 * @brief 画面全域をクリアし、カーソル位置を先頭に移動させます。
orivant 0:c7da9183f23a 111 */
orivant 0:c7da9183f23a 112 void clearDisplay();
orivant 0:c7da9183f23a 113 /** 行クリア
orivant 0:c7da9183f23a 114 * @brief 指定行をクリアし、カーソルを指定行の先頭に移動させます。
orivant 0:c7da9183f23a 115 * @param lineNo 行番号
orivant 0:c7da9183f23a 116 */
orivant 0:c7da9183f23a 117 void clearLine(uint8_t lineNo);
orivant 0:c7da9183f23a 118 /** 範囲クリア
orivant 0:c7da9183f23a 119 * @brief 指定範囲をクリアし、カーソルを指定範囲の開始位置に移動させます。
orivant 0:c7da9183f23a 120 * @param startLineNo 開始行番号
orivant 0:c7da9183f23a 121 * @param startCharaNo 開始文字番号
orivant 0:c7da9183f23a 122 * @param endLineNo; 終了行番号
orivant 0:c7da9183f23a 123 * @param endCharaNo 終了文字番号
orivant 0:c7da9183f23a 124 */
orivant 0:c7da9183f23a 125 void clearRange(uint8_t startLineNo, uint8_t startCharaNo, uint8_t endLineNo, uint8_t endCharaNo);
orivant 0:c7da9183f23a 126
orivant 0:c7da9183f23a 127
orivant 0:c7da9183f23a 128 /** 画面の表示設定
orivant 0:c7da9183f23a 129 * @param visible 表示フラグ
orivant 0:c7da9183f23a 130 */
orivant 0:c7da9183f23a 131 void setDisplayVisible(bool visible);
orivant 0:c7da9183f23a 132 /** 画面の表示設定取得
orivant 0:c7da9183f23a 133 * @return 表示フラグ
orivant 0:c7da9183f23a 134 */
orivant 0:c7da9183f23a 135 bool getDisplayVisible() const;
orivant 0:c7da9183f23a 136 /** カーソルの表示設定
orivant 0:c7da9183f23a 137 * @param visible 表示フラグ
orivant 0:c7da9183f23a 138 */
orivant 0:c7da9183f23a 139 void setCursorVisible(bool visible);
orivant 0:c7da9183f23a 140 /** カーソルの表示設定取得
orivant 0:c7da9183f23a 141 * @return 表示フラグ
orivant 0:c7da9183f23a 142 */
orivant 0:c7da9183f23a 143 bool getCursorVisible() const;
orivant 0:c7da9183f23a 144 /** カーソルの点滅設定
orivant 0:c7da9183f23a 145 * @param enable 点滅フラグ
orivant 0:c7da9183f23a 146 */
orivant 0:c7da9183f23a 147 void setBlinkEnable(bool enable);
orivant 0:c7da9183f23a 148 /** カーソルの点滅設定取得
orivant 0:c7da9183f23a 149 * @return 点滅フラグ
orivant 0:c7da9183f23a 150 */
orivant 0:c7da9183f23a 151 bool getBlinkEnable() const;
orivant 0:c7da9183f23a 152
orivant 0:c7da9183f23a 153 private:
orivant 0:c7da9183f23a 154 /** LCDコマンド書き込み
orivant 0:c7da9183f23a 155 * @brief LCDのコマンドを一つ書き込み（実行し）ます。
orivant 0:c7da9183f23a 156 * @param commandByte コマンド指定バイトデータ
orivant 0:c7da9183f23a 157 */
orivant 0:c7da9183f23a 158 void writeCommand(uint8_t commandByte);
orivant 0:c7da9183f23a 159 /** LCDデータ書き込み
orivant 0:c7da9183f23a 160 * @brief LCDへ文字データを一つ書き込みます。
orivant 0:c7da9183f23a 161 * @param dataByte データ指定バイト
orivant 0:c7da9183f23a 162 */
orivant 0:c7da9183f23a 163 void writeData(uint8_t dataByte);
orivant 0:c7da9183f23a 164
orivant 0:c7da9183f23a 165
orivant 0:c7da9183f23a 166 /** ディスプレイ制御コマンド指定バイトデータの生成
orivant 0:c7da9183f23a 167 * @param displayVisible ディスプレイ表示設定
orivant 0:c7da9183f23a 168 * @param cursorVisible カーソル表示設定
orivant 0:c7da9183f23a 169 * @param blinkEnable カーソル点滅設定
orivant 0:c7da9183f23a 170 * @return コマンド指定バイトデータ
orivant 0:c7da9183f23a 171 */
orivant 0:c7da9183f23a 172 uint8_t calcDisplayControlByteData(bool displayVisible, bool cursorVisible, bool blinkEnable) const;
orivant 0:c7da9183f23a 173 uint8_t calcDisplayControlByteData() const {
orivant 0:c7da9183f23a 174 return calcDisplayControlByteData(m_displayVisible, m_cursorVisible, m_blinkEnable);
orivant 0:c7da9183f23a 175 }
orivant 0:c7da9183f23a 176
orivant 0:c7da9183f23a 177
orivant 0:c7da9183f23a 178 /** カーソル位置移動管理
orivant 0:c7da9183f23a 179 * @brief カーソル位置を一つ進め、改行が発生するかを調べる
orivant 0:c7da9183f23a 180 * @return 改行が発生する場合はtrue
orivant 0:c7da9183f23a 181 */
orivant 0:c7da9183f23a 182 bool incCursorPos();
orivant 0:c7da9183f23a 183
orivant 0:c7da9183f23a 184 /** カーソル位置のアドレス計算
orivant 0:c7da9183f23a 185 * @param lineNo 行番号
orivant 0:c7da9183f23a 186 * @param charaNo 文字番号
orivant 0:c7da9183f23a 187 * @return アドレス
orivant 0:c7da9183f23a 188 */
orivant 0:c7da9183f23a 189 uint8_t calcCursorAddr(uint8_t lineNo, uint8_t charaNo);
orivant 0:c7da9183f23a 190 };
orivant 2:1e305eaf6411 191
orivant 2:1e305eaf6411 192 #endif //!defined(LCD_ACM1602NI_H)