osd-contiki/platform/avr-ravenlcd/lcd.h

352 lines
9.3 KiB
C
Raw Permalink Normal View History

/*
* Copyright (c) 2008 Swedish Institute of Computer Science
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
* * Neither the name of the copyright holders nor the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
/**
* \file
*
* \brief
* This file provides Raven LCD support.
*
* \author
* Mike Vidales mavida404@gmail.com
*
*/
#ifndef LCD_H_
#define LCD_H_
#include <avr/io.h>
#include <avr/interrupt.h>
#include <avr/pgmspace.h>
#include <stdint.h>
#include <stdbool.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#define LCD_SYMBOL_FISRT 0
#define LCD_SYMBOL_COUNT 34
/* Duplicate usage of segments */
#define LCD_SYMBOL_ARR_UP LCD_SYMBOL_ENV_OP
#define LCD_SYMBOL_ARR_DN LCD_SYMBOL_ENV_CL
#define LCD_CLCK_FRQ 32768
/** @name Constant defines for making seg_map[] table */
/** @{ */
/*
- a -
f b
|-g-|
e c
- d -
*/
#define NUM_LCD_SYMBOL_A 0x01
#define NUM_LCD_SYMBOL_B 0x02
#define NUM_LCD_SYMBOL_C 0x04
#define NUM_LCD_SYMBOL_D 0x08
#define NUM_LCD_SYMBOL_E 0x10
#define NUM_LCD_SYMBOL_F 0x20
#define NUM_LCD_SYMBOL_G 0x40
/** @} */
/** @name Constant defines for indexing seg_map[] table */
/** @{ */
#define LCD_SEV_SEG_INDEX_0 (0)
#define LCD_SEV_SEG_INDEX_1 (1)
#define LCD_SEV_SEG_INDEX_2 (2)
#define LCD_SEV_SEG_INDEX_3 (3)
#define LCD_SEV_SEG_INDEX_4 (4)
#define LCD_SEV_SEG_INDEX_5 (5)
#define LCD_SEV_SEG_INDEX_6 (6)
#define LCD_SEV_SEG_INDEX_7 (7)
#define LCD_SEV_SEG_INDEX_8 (8)
#define LCD_SEV_SEG_INDEX_9 (9)
#define LCD_SEV_SEG_INDEX_A (10)
#define LCD_SEV_SEG_INDEX_B (11)
#define LCD_SEV_SEG_INDEX_C (12)
#define LCD_SEV_SEG_INDEX_D (13)
#define LCD_SEV_SEG_INDEX_E (14)
#define LCD_SEV_SEG_INDEX_F (15)
#define LCD_SEV_SEG_INDEX_SPACE (16)
#define LCD_SEV_SEG_INDEX_MINUS (17)
/** @} */
#define lcd_symbol_set_all() lcd_symbol_set_group(0, sizeof(lcd_symbol_chart))
#define lcd_symbol_clr_all() lcd_symbol_clr_group(0, sizeof(lcd_symbol_chart))
typedef enum {
LCD_NUM_PADDING_ZERO,
LCD_NUM_PADDING_SPACE
} lcd_padding_t;
typedef enum {
/* name = (bit_number << bit_number_offset) | mem_offset*/
/* Raven */
LCD_SYMBOL_RAVEN = (7<<5) | 3,
/* Audio */
LCD_SYMBOL_BELL = (2<<5) | 17,
LCD_SYMBOL_TONE = (6<<5) | 17,
LCD_SYMBOL_MIC = (3<<5) | 3,
LCD_SYMBOL_SPEAKER = (2<<5) | 18,
/* Status */
LCD_SYMBOL_KEY = (3<<5) | 2,
LCD_SYMBOL_ATT = (7<<5) | 2,
/* Time */
LCD_SYMBOL_SUN = (6<<5) | 13,
LCD_SYMBOL_MOON = (6<<5) | 3,
LCD_SYMBOL_AM = (2<<5) | 15,
LCD_SYMBOL_PM = (6<<5) | 15,
/* Radio commuication status */
LCD_SYMBOL_RX = (6<<5) | 18,
LCD_SYMBOL_TX = (5<<5) | 13,
LCD_SYMBOL_IP = (7<<5) | 13,
LCD_SYMBOL_PAN = (7<<5) | 18,
LCD_SYMBOL_ZLINK = (5<<5) | 8,
LCD_SYMBOL_ZIGBEE = (5<<5) | 3,
/* Antenna status */
LCD_SYMBOL_ANT_FOOT= (5<<5) | 18,
LCD_SYMBOL_ANT_SIG1= (3<<5) | 0,
LCD_SYMBOL_ANT_SIG2= (7<<5) | 0,
LCD_SYMBOL_ANT_SIG3= (3<<5) | 1,
LCD_SYMBOL_ANT_DIS = (7<<5) | 1,
/* Battery status */
LCD_SYMBOL_BAT_CONT= (4<<5) | 18,
LCD_SYMBOL_BAT_CAP1= (4<<5) | 3,
LCD_SYMBOL_BAT_CAP2= (4<<5) | 8,
LCD_SYMBOL_BAT_CAP3= (4<<5) | 13,
/* Envelope status */
LCD_SYMBOL_ENV_OP = (6<<5) | 8,
LCD_SYMBOL_ENV_CL = (0<<5) | 4,
LCD_SYMBOL_ENV_MAIN= (2<<5) | 4,
/* Temperature */
LCD_SYMBOL_C = (6<<5) | 16,
LCD_SYMBOL_F = (2<<5) | 16,
/* Numeric */
LCD_SYMBOL_MINUS = (7<<5) | 8,
LCD_SYMBOL_DOT = (4<<5) | 4,
LCD_SYMBOL_COL = (6<<5) | 4,
} lcd_symbol_t;
typedef enum {
LCD_WAVE_DEFAULT = 0,
LCD_WAVE_LOW_POWER = 1
} lcd_wave_t;
typedef enum {
LCD_BUFFER_ON = 0,
LCD_BUFFER_OFF = 1
} lcd_buffer_t;
typedef enum {
LCD_BLANKING_OFF = 0,
LCD_BLANKING_ON = 1
} lcd_blanking_t;
typedef enum {
LCD_CLOCK_SYSTEM = 0,
LCD_CLOCK_EXTERN = 1
} lcd_clock_t;
typedef enum {
LCD_BIAS_THIRD = 0,
LCD_BIAS_HALF = 1
} lcd_bias_t;
typedef enum {
LCD_PRESCL_16 = 0x0,
LCD_PRESCL_64 = 0x1,
LCD_PRESCL_128 = 0x2,
LCD_PRESCL_256 = 0x3,
LCD_PRESCL_512 = 0x4,
LCD_PRESCL_1024 = 0x5,
LCD_PRESCL_2048 = 0x6,
LCD_PRESCL_4096 = 0x7,
} lcd_prescl_t;
typedef enum {
LCD_DIV_1 = 0,
LCD_DIV_2 = 1,
LCD_DIV_3 = 2,
LCD_DIV_4 = 3,
LCD_DIV_5 = 4,
LCD_DIV_6 = 5,
LCD_DIV_7 = 6,
LCD_DIV_8 = 7
} lcd_div_t;
/** Bit LCDDC2:0 and LCMDT */
typedef enum {
LCD_DRIVE_300 = 0x0,
LCD_DRIVE_70 = 0x2,
LCD_DRIVE_150 = 0x4,
LCD_DRIVE_450 = 0x6,
LCD_DRIVE_575 = 0x8,
LCD_DRIVE_850 = 0xA,
LCD_DRIVE_1150 = 0xC,
LCD_DRIVE_HALF = 0xE,
LCD_DRIVE_FULL = 0xF
} lcd_drive_t;
typedef enum {
LCD_CONTRAST_2_60 = 0x0,
LCD_CONTRAST_2_65 = 0x1,
LCD_CONTRAST_2_70 = 0x2,
LCD_CONTRAST_2_75 = 0x3,
LCD_CONTRAST_2_80 = 0x4,
LCD_CONTRAST_2_85 = 0x5,
LCD_CONTRAST_2_90 = 0x6,
LCD_CONTRAST_2_95 = 0x7,
LCD_CONTRAST_3_00 = 0x8,
LCD_CONTRAST_3_05 = 0x9,
LCD_CONTRAST_3_10 = 0xA,
LCD_CONTRAST_3_15 = 0xB,
LCD_CONTRAST_3_20 = 0xC,
LCD_CONTRAST_3_25 = 0xD,
LCD_CONTRAST_3_30 = 0xE,
LCD_CONTRAST_3_35 = 0xF
} lcd_contrast_t;
typedef struct {
union {
struct {
unsigned int blanking: 1;
unsigned int : 1;
unsigned int buffer : 1;
unsigned int : 3;
unsigned int wave : 1;
unsigned int : 1;
};
uint8_t lcdcra;
};
union {
struct {
unsigned int : 6;
unsigned int bias : 1;
unsigned int clock : 1;
};
uint8_t lcdcrb;
};
union {
struct {
unsigned int div : 3;
unsigned int : 1;
unsigned int prescl : 3;
unsigned int : 1;
};
uint8_t lcdfrr;
};
union {
struct {
unsigned int contrast: 4;
unsigned int drive : 4;
};
uint8_t lcdccr;
};
} lcd_config_t;
/*========================= PUBLIC VARIABLES =========================*/
/*========================= PUBLIC FUNCTIONS =========================*/
/** Initialization and configuration of the LCD controller
*
* Example:
* \code
*
* Configuring LCD with Extern clock (TOSC, 32.768kHz)
* 32786 Hz 32786 Hz
* frame_rate = ------------------ = ------------- = 32 Hz
* 8 * .prescl * .div 8 * 16 * 8
*
* lcd_config_t lcd_config = {
* .wave = LCD_WAVE_LOW_POWER,
* .buffer = LCD_BUFFER_ON,
* .blanking = LCD_BLANKING_OFF,
* .clock = LCD_CLOCK_EXTERN,
* .bias = LCD_BIAS_HALF,
* .prescl = LCD_PRESCL_16,
* .div = LCD_DIV_8,
* .drive = LCD_DRIVE_450,
* .contrast = LCD_CONTRAST_3_30
* };
*
* lcd_init(lcd_config);
* \endcode
*/
int lcd_init(void);
void lcd_deinit(void);
uint8_t itobcd(uint8_t inNumber);
/** @name Numeric functions */
/** @{ */
int lcd_num_puthex(uint16_t numb, lcd_padding_t padding);
int lcd_num_putdec(int numb, lcd_padding_t padding);
int lcd_num_clr(void);
void lcd_single_print_dig(uint8_t numb, uint8_t pos);
/** @} */
/** @name Text functions */
/** @{ */
int lcd_puts(const char* s);
int lcd_puts_P(const char *s);
int lcd_puta(size_t length, const uint8_t *s);
int lcd_putchar(unsigned char c);
/** @} */
/** @name Symbol functions */
/** @{ */
void lcd_symbol_set(lcd_symbol_t symbol);
void lcd_symbol_set_group(int start, int count);
void lcd_symbol_clr(lcd_symbol_t symbol);
void lcd_symbol_clr_group(int start, int count);
/** @} */
/** @name LED Functions */
/** @{ */
void led_on(void);
void led_off(void);
/** @} */
#endif /* LCD_H_ */