CFAH2004AC_I2C.ino

//===========================================================================
//
//  Written for Seeeduino v4.2 runnung at 5v
//
//  CRYSTALFONTZ CFAH2004AC 20x4 Character in I2C mode
//
//  ref: https://www.crystalfontz.com/product/CFAH2004AC
//
//  2017-10-09 Max / Crystalfontz
//===========================================================================
//  This is free and unencumbered software released into the public domain.
//
//  AnyLINE_ONE is free to copy, modify, publish, use, compile, sell, or
//  distribute this software, either in source form or as a compiled
//  binary, for any purpose, commercial or non-commercial, and by any
//  means.
//
//  In jurisdictions that recognize copyright laws, the author or authors
//  of this software dedicate any and all copyright interest in the
//  software to the public domain. We make this dedication for the benefit
//  of the public at large and to the detriment of our heirs and
//  successors. We intend this dedication to be an overt act of
//  relinquishment in perpetuity of all present and future rights to this
//  software under copyright law.
//
//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
//  IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
//  OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
//  ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
//  OTHER DEALINGS IN THE SOFTWARE.
//
//  For more information, please refer to <http://unlicense.org/>
//===========================================================================
#include <Wire.h>
//----------------------------------------------------------------------------
#define Cword 0x14  //20
#define LINE_ONE    0x80  // DD RAM Address The starting position of the first line is 0x00
                          // set the DD RAM address to 0x80 + 0x00 = 0x80
#define LINE_TWO    0xc0  // DD RAM Address The starting position of the second line is 0x40
                          // set the DD RAM address to 0x80 + 0x40 = 0xc0
#define LINE_THREE  0x94  // DD RAM Address The starting position of the second line is 0x14
                          // set the DD RAM address to 0x80 + 0x14 = 0x94
#define LINE_FOUR   0xD4  // DD RAM Address The starting position of the second line is 0x54
                          // set the DD RAM address to 0x80 + 0x54 = 0xD4
//============================================================================
// LCD SPI & control lines
//   ARD      | Port | LCD
// -----------+------+-------------------------
//  #13/D13   |  PB5 | SD_CS

#define LCD_CS 0x20
#define CLR_CS    (PORTB &= ~(LCD_CS))
#define SET_CS    (PORTB |=  (LCD_CS))

// Four 7-bit slave addresses (0111100, 0111101, 0111110 and 0111111) are reserved for the RW1063. The least
// significant bit of the slave address is set by connecting the input SA0 (DB0) and SA1 (DB1) to either logic 0
// (VSS) or logic 1 (VDD).
#define I2C_ADDRESS 0x3C //0b0111100
// #define I2C_ADDRESS 0x3D //0b0111101
// #define I2C_ADDRESS 0x3E //0b0111110
// #define I2C_ADDRESS 0x3F //0b0111111

//                  //00000000001111111111
//                  //01234567890123456789
uint8_t MSG1[20]    ="**  CRYSTALFONTZ  **";
uint8_t MSG2[20]    ="** CFAH2004AC-TFH **";
uint8_t MSG3_1[20]  ="**  20 Characters **";
uint8_t MSG3_2[20]  ="** 8  CUSTOM CHAR **";
uint8_t MSG4[20]    ="**   by 4 lines   **";

uint8_t CGRAM[8][8] = {
  {21, 42, 21, 42, 21, 42, 21, 42},
  {42, 21, 42, 21, 42, 21, 42, 21},
  {63, 31, 15,  7,  3,  1,  0,  0},
  { 0,  0, 32, 48, 56, 60, 62, 63},
  { 1,  2,  4,  8,  8,  4,  2,  1},
  {32, 16,  8,  4,  4,  8, 16, 32},
  {62, 61, 59, 55, 47, 31, 47, 55},
  {59, 61, 62, 61, 59, 55, 47, 31},
};
//============================================================================
void writeCommand(uint8_t command);
void writeData(uint8_t data);
void writeString(uint8_t count, uint8_t *MSG);
void Initialize_CFAH2004AC(void);
void Initialize_CGRAM(void);
//============================================================================
void writeCommand(uint8_t command)
{
  //Assert the CS
  CLR_CS;

  Wire.beginTransmission(I2C_ADDRESS);  
  
  //Send the command via I2C:
  Wire.write(0x00);
  Wire.write(command);


  Wire.endTransmission();

  //Deassert the CS
  SET_CS;

  delay(1);
}
//============================================================================
void writeData(uint8_t data)
{
  //Assert the CS
  CLR_CS;
  
  Wire.beginTransmission(I2C_ADDRESS);  
  
  //Send the data via I2C:
  Wire.write(0xC0);		        //Control Byte - Data (non-continued)
  Wire.write(data);
  
  Wire.endTransmission();
  
  //Deassert the CS
  SET_CS;

  delay(1);
}
//============================================================================
void writeString(uint8_t count,uint8_t *MSG)
{
  for(uint8_t i = 0; i<count;i++)
  {
    writeData(MSG[i]);
  }
}
//============================================================================
void Initialize_CFAH2004AC()
{
  //LCD Init
  delay(50);
  writeCommand(0x38); // Function set
  delay(1);
  writeCommand(0x0C); // Display ON/OFF
  delay(1);
  writeCommand(0x01); // Clear display
  delay(10);
  writeCommand(0x06); // Entry mode set
  delay(1);
}
//============================================================================
void Initialize_CGRAM(void)
{
  Serial.println(F("CGRAM()"));
  
  unsigned char i, j;

  // The first graph of the CGRAM Address start address
  //  is 000000 (0x00) CGRAM address is set to 0x40 + 0x00 = 0x40
  // The second graph's CGRAM Address starts with address 001000 (0x08)
  // etc.
  for (i = 0; i < 8; i ++)
  {
    writeCommand(0x40 + (0x08 * i));
    for (j = 0; j < 8; j ++)
    {
      writeData(CGRAM[i][j]);
    }      
  }
}
//============================================================================
void setup( void )
{
  DDRB |= 0xFF;

  //debug console
  Serial.begin(115200);
  Serial.println(F("setup()"));

  Wire.begin(); // join i2c bus (address optional for master)
  
  //Fire up the I2C LCD
  Serial.println(F("Initialize_CFAH2004AC()"));
  Initialize_CFAH2004AC();
  Initialize_CGRAM();
  
  //From the init
  writeCommand(LINE_ONE);
	writeString(Cword,MSG1);
	writeCommand(LINE_TWO);
  writeString(Cword,MSG2);
	writeCommand(LINE_THREE);
	writeString(Cword,MSG3_1);
	writeCommand(LINE_FOUR);
	writeString(Cword,MSG4);
}
//============================================================================
uint8_t currentLine[20] = "** CFAH2004AC-TFH **";
uint8_t iteration = 0;
void loop(void)
{
  Serial.println(F("Loop()"));
  uint8_t temp;
  
  //This is the scrolling
  temp = currentLine[0];
  for(uint8_t thisChar = 1; thisChar < 20; thisChar++)
  {
    currentLine[thisChar - 1] = currentLine[thisChar];
  }
  currentLine[19] = temp;
	writeCommand(LINE_TWO);
  writeString(Cword,currentLine);
  iteration++;
  delay(150);

  //Scrolling is done
  if(iteration == 20)
  {
    Serial.println(F("20x Loop()"));
    delay(1000);

    //Show off the CGRAM
	  writeCommand(LINE_THREE);
	  writeString(Cword,MSG3_2);
    
    writeCommand(LINE_FOUR);
    writeData('*');
    writeData('*');
    writeData(' ');
    writeData(' ');
    writeData(' ');
    writeData(' ');
    for(uint8_t thisChar = 0; thisChar < 8; thisChar++)
    {
      writeData(thisChar);
    }
    writeData(' ');
    writeData(' ');
    writeData(' ');
    writeData(' ');
    writeData('*');
    writeData('*');
    delay(10000);

    //Put the text back
    writeCommand(LINE_THREE);
    writeString(Cword,MSG3_1);
    writeCommand(LINE_FOUR);
    writeString(Cword,MSG4);
    delay(1000);
    iteration = 0;
  }
}
//============================================================================