lcd_acm1602.h

   1 /*
   2  * OpenI2CRADIO
   3  * I2C/Parallel LCD ACM1602 Handler, variant of ST7066U.
   4  * Copyright (C) 2013-06-10 K.Ohta <whatisthis.sowhat ai gmail.com>
   5  * License: GPL2+LE
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License as published by
   9  *  the Free Software Foundation; either version 2,
  10  *  or (at your option) any later version.
  11  *  This library / program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14  *  See the GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this library; see the file COPYING. If not, write to the
  18  *  Free Software Foundation, 51 Franklin Street, Fifth Floor, Boston,
  19  *  MA 02110-1301, USA.
  20  *
  21  *  As a special exception, if you link this(includeed from sdcc) library
  22  *  with other files, some of which are compiled with SDCC,
  23  *  to produce an executable, this library does not by itself cause
  24  *  the resulting executable to be covered by the GNU General Public License.
  25  *  This exception does not however invalidate any other reasons why
  26  *  the executable file might be covered by the GNU General Public License.
  27  */
  28 #ifndef LCD_ACM1602_H
  29 #define LCD_ACM1602_H
  30
  31 #include <stdarg.h>
  32 #include <stdio.h>
  33 #ifdef __SDCC
  34 #include <delay.h>
  35 #else
  36 #include <xc.h>
  37 #endif
  38
  39 #include <string.h>
  40
  41 #include "iodef.h"
  42 #include "i2c_io.h"
  43 #include "idle.h"
  44
  45
  46 #ifdef  __cplusplus
  47 extern "C" {
  48 #endif
  49
  50 #ifndef LCD_I2CADDR
  51 #define LCD_I2CADDR 0xa0
  52 #endif
  53 // Notes: Master clock = 8MHz(0.125uS)
  54 // Wait 5us
  55 #ifdef __SDCC
  56 // Wait 50us
  57 #define _ACM1602_SHORT_WAIT()     delay100tcy(4)
  58 // Wait 5ms
  59 #define _ACM1602_LONG_WAIT()     delay10ktcy(40)
  60 // Wait 200ms
  61 //#define _ACM1602_LONG_LONG_WAIT()     delay100ktcy(10)
  62 #define _ACM1602_LONG_LONG_WAIT()     idle_time_ms(125)
  63 // Wait 5.5ms
  64 #define _ACM1602_I2C_WAIT()     delay1ktcy(44)
  65 #else  // XC8
  66 // Wait 50us
  67 #define _ACM1602_SHORT_WAIT()     __delay_us(50)
  68 // Wait 5ms
  69 #define _ACM1602_LONG_WAIT()     __delay_ms(50)
  70 // Wait 125ms
  71 #define _ACM1602_LONG_LONG_WAIT()     idle_time_ms(125)
  72 // Wait 5.5ms
  73 #define _ACM1602_I2C_WAIT()     __delay_us(5500)
  74 #endif
  75
  76
  77 extern void acm1602_cls(unsigned char addr);
  78 extern void acm1602_putchar(unsigned char addr, unsigned char c);
  79 extern void acm1602_locate_16x2(unsigned char addr, char x, char y);
  80 extern void acm1602_locate_8x2(unsigned char addr, char x, char y);
  81 extern void acm1602_home(unsigned char addr);
  82 extern void acm1602_cursordir(unsigned char addr, unsigned char right);
  83 extern void acm1602_dispcursor(unsigned char addr, unsigned char flag);
  84 extern void acm1602_init(unsigned char addr, unsigned char cls);
  85 extern void acm1602_suspend(unsigned char addr);
  86 extern void acm1602_resume(unsigned char addr);
  87
  88 //extern unsigned char acm1602_getchar(unsigned char addr);
  89
  90 #ifdef _USE_I2C_1602
  91 /*
  92  * ST7032 extension functions
  93  */
  94 extern void st7032_extcmd(unsigned char addr, unsigned char mode,
  95         unsigned char cmd, unsigned char busyf);
  96 extern void st7032_setcontrast(unsigned char addr, unsigned char value,
  97         unsigned char busyf);
  98 #endif
  99 #ifdef  __cplusplus
 100 }
 101 #endif
 102
 103 #endif  /* LCD_ACM1602_H */
 104