不韋 呂 / UIT_AQM1602

I2C 接続の LCD AQM1602XA-RN-GBW 用のライブラリ． Library for LCD 1602XA-RN-GBW connected using I2C interface.

Dependents:   UIT2_MovingAv_Intr UIT2_VariableFIR UIT2_VowelSynthesizer UIT2_ALE_LeakyLMS ... more

AQM1602.hpp@10:6e6c0f24e81f, 2016-12-24 (annotated)

Committer:
MikamiUitOpen
Date:
Sat Dec 24 02:36:19 2016 +0000
Revision:
10:6e6c0f24e81f
Parent:
9:74a845df6e7a
Child:
11:f650f1e809a9
11

Who changed what in which revision?

UserRevisionLine numberNew contents of line
MikamiUitOpen 10:6e6c0f24e81f 1 //---------------------------------------------------------------
MikamiUitOpen 0:f177013dc4fc 2 // Class for LCD, AQM1602XA-RN-GBW (Header)
MikamiUitOpen 10:6e6c0f24e81f 3 // Use mbed Rev.129 for Nucleo-F401/446/746 and DISCO-F746
MikamiUitOpen 0:f177013dc4fc 4 //
MikamiUitOpen 10:6e6c0f24e81f 5 // Default pin assignments for Nucleo and DISCO-F746
MikamiUitOpen 0:f177013dc4fc 6 // D14 SDA ---- to pin4 of LCD module
MikamiUitOpen 0:f177013dc4fc 7 // D15 SCL ---- to pin3 of LCD module
MikamiUitOpen 0:f177013dc4fc 8 //
MikamiUitOpen 10:6e6c0f24e81f 9 // 2016/12/24, Copyright (c) 2016 MIKAMI, Naoki
MikamiUitOpen 10:6e6c0f24e81f 10 //---------------------------------------------------------------
MikamiUitOpen 0:f177013dc4fc 11
MikamiUitOpen 0:f177013dc4fc 12 #ifndef AQM1602I2C_HPP
MikamiUitOpen 0:f177013dc4fc 13 #define AQM1602I2C_HPP
MikamiUitOpen 0:f177013dc4fc 14
MikamiUitOpen 0:f177013dc4fc 15 #include "mbed.h"
MikamiUitOpen 1:18cd1c4212c3 16 #include <string>
MikamiUitOpen 0:f177013dc4fc 17
MikamiUitOpen 0:f177013dc4fc 18 namespace Mikami
MikamiUitOpen 0:f177013dc4fc 19 {
MikamiUitOpen 0:f177013dc4fc 20 class Aqm1602
MikamiUitOpen 0:f177013dc4fc 21 {
MikamiUitOpen 0:f177013dc4fc 22 public:
MikamiUitOpen 0:f177013dc4fc 23 // Constructor
MikamiUitOpen 10:6e6c0f24e81f 24 #if defined(STM32F4) || defined(STM32L0) || defined(__STM32F3xx_H) || \
MikamiUitOpen 10:6e6c0f24e81f 25 defined(STM32F7)
MikamiUitOpen 10:6e6c0f24e81f 26 #define STM_USER_BUTTON
MikamiUitOpen 0:f177013dc4fc 27 Aqm1602(PinName sda = D14, // SDA
MikamiUitOpen 0:f177013dc4fc 28 PinName scl = D15, // SCL
MikamiUitOpen 0:f177013dc4fc 29 uint32_t clock = 100000, // clock: 100 kHz
MikamiUitOpen 0:f177013dc4fc 30 bool cursor = false, // cursor: off
MikamiUitOpen 0:f177013dc4fc 31 bool blink = false); // blink: off
MikamiUitOpen 5:c44a3beb21f2 32 // Default constructor is defined for only Nucleo
MikamiUitOpen 5:c44a3beb21f2 33 #else
MikamiUitOpen 5:c44a3beb21f2 34 Aqm1602(PinName sda, // SDA
MikamiUitOpen 5:c44a3beb21f2 35 PinName scl, // SCL
MikamiUitOpen 5:c44a3beb21f2 36 uint32_t clock = 100000, // clock: 100 kHz
MikamiUitOpen 5:c44a3beb21f2 37 bool cursor = false, // cursor: off
MikamiUitOpen 5:c44a3beb21f2 38 bool blink = false); // blink: off
MikamiUitOpen 5:c44a3beb21f2 39 #endif
MikamiUitOpen 8:854c244a7863 40 Aqm1602(I2C &i2c, // Reference of I2C object
MikamiUitOpen 8:854c244a7863 41 uint32_t clock = 100000, // clock: 100 kHz
MikamiUitOpen 8:854c244a7863 42 bool cursor = false, // cursor: off
MikamiUitOpen 8:854c244a7863 43 bool blink = false); // blink: off
MikamiUitOpen 8:854c244a7863 44
MikamiUitOpen 10:6e6c0f24e81f 45 virtual ~Aqm1602()
MikamiUitOpen 8:854c244a7863 46 { if (NULL != i2cPtr_) delete i2cPtr_; }
MikamiUitOpen 8:854c244a7863 47
MikamiUitOpen 3:414f98234c94 48 // Return false if LCD is not connected
MikamiUitOpen 3:414f98234c94 49 bool IsConnected() { return connected_; }
MikamiUitOpen 3:414f98234c94 50
MikamiUitOpen 0:f177013dc4fc 51 // All clear
MikamiUitOpen 8:854c244a7863 52 bool Clear();
MikamiUitOpen 1:18cd1c4212c3 53
MikamiUitOpen 0:f177013dc4fc 54 // Send command
MikamiUitOpen 3:414f98234c94 55 bool WriteCmd(uint8_t cmd) { return LcdTx(0x00, cmd); }
MikamiUitOpen 1:18cd1c4212c3 56
MikamiUitOpen 0:f177013dc4fc 57 // Write character (Not 0x80 but 0x40)
MikamiUitOpen 3:414f98234c94 58 bool WriteChar(char data) { return LcdTx(0x40, data); }
MikamiUitOpen 1:18cd1c4212c3 59
MikamiUitOpen 0:f177013dc4fc 60 // Specify display position, x: 0 - 7, y: 0, 1
MikamiUitOpen 0:f177013dc4fc 61 void SetXY(uint8_t x = 0, uint8_t y = 0)
MikamiUitOpen 0:f177013dc4fc 62 { WriteCmd(x + y*0x40 | 0x80);}
MikamiUitOpen 1:18cd1c4212c3 63
MikamiUitOpen 0:f177013dc4fc 64 // Write string
MikamiUitOpen 0:f177013dc4fc 65 void WriteString(const char str[]);
MikamiUitOpen 1:18cd1c4212c3 66 void WriteString(const string str) { WriteString(str.c_str()); }
MikamiUitOpen 1:18cd1c4212c3 67
MikamiUitOpen 0:f177013dc4fc 68 // Write string from specified position
MikamiUitOpen 2:f496f85ce6f2 69 void WriteStringXY(const char str[], uint8_t x, uint8_t y);
MikamiUitOpen 1:18cd1c4212c3 70 void WriteStringXY(const string str, uint8_t x, uint8_t y)
MikamiUitOpen 1:18cd1c4212c3 71 { WriteStringXY(str.c_str(), x, y); }
MikamiUitOpen 1:18cd1c4212c3 72
MikamiUitOpen 9:74a845df6e7a 73 // Write numerical value
MikamiUitOpen 9:74a845df6e7a 74 template <typename T> void WriteValue(const char fmt[], T value)
MikamiUitOpen 9:74a845df6e7a 75 {
MikamiUitOpen 9:74a845df6e7a 76 char str[17];
MikamiUitOpen 9:74a845df6e7a 77 sprintf(str, fmt, value);
MikamiUitOpen 9:74a845df6e7a 78 WriteString(str);
MikamiUitOpen 9:74a845df6e7a 79 }
MikamiUitOpen 9:74a845df6e7a 80
MikamiUitOpen 9:74a845df6e7a 81 // Write numerical value from specified position
MikamiUitOpen 9:74a845df6e7a 82 template <typename T>
MikamiUitOpen 9:74a845df6e7a 83 void WriteValueXY(const char fmt[], T value, uint8_t x, uint8_t y)
MikamiUitOpen 9:74a845df6e7a 84 {
MikamiUitOpen 9:74a845df6e7a 85 SetXY(x, y);
MikamiUitOpen 9:74a845df6e7a 86 WriteValue(fmt, value);
MikamiUitOpen 9:74a845df6e7a 87 }
MikamiUitOpen 9:74a845df6e7a 88
MikamiUitOpen 0:f177013dc4fc 89 // Clear of specified line
MikamiUitOpen 0:f177013dc4fc 90 void ClearLine(uint8_t line);
MikamiUitOpen 1:18cd1c4212c3 91
MikamiUitOpen 0:f177013dc4fc 92 void SetContrast(uint8_t c);
MikamiUitOpen 0:f177013dc4fc 93
MikamiUitOpen 0:f177013dc4fc 94 private:
MikamiUitOpen 3:414f98234c94 95 // Slave address of AQM1602A
MikamiUitOpen 0:f177013dc4fc 96 // left-justified 7-bit address
MikamiUitOpen 0:f177013dc4fc 97 static const uint8_t LCD_ADDRESS_ = 0x7C;
MikamiUitOpen 0:f177013dc4fc 98 static const uint8_t N_CHR = 16;
MikamiUitOpen 0:f177013dc4fc 99
MikamiUitOpen 8:854c244a7863 100 I2C *i2cPtr_; // Pointer of I2C object
MikamiUitOpen 8:854c244a7863 101 I2C &i2c_; // Reference of I2C object
MikamiUitOpen 7:5375acc9a74a 102 bool connected_; // false: LCD is not connected
MikamiUitOpen 0:f177013dc4fc 103
MikamiUitOpen 8:854c244a7863 104 void Init(uint32_t clock, bool cursor, bool blink);
MikamiUitOpen 8:854c244a7863 105
MikamiUitOpen 3:414f98234c94 106 bool LcdTx(uint8_t cmdData, uint8_t data);
MikamiUitOpen 0:f177013dc4fc 107
MikamiUitOpen 7:5375acc9a74a 108 // disallow copy constructor and assignment operator
MikamiUitOpen 0:f177013dc4fc 109 Aqm1602(const Aqm1602&);
MikamiUitOpen 0:f177013dc4fc 110 Aqm1602& operator=(const Aqm1602&);
MikamiUitOpen 0:f177013dc4fc 111 };
MikamiUitOpen 0:f177013dc4fc 112 }
MikamiUitOpen 3:414f98234c94 113 #endif // AQM1602I2C_HPP