1172 lines
32 KiB
C
1172 lines
32 KiB
C
/****************************************************************************
|
|
* drivers/lcd/ht16k33_14seg.c
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/* Alphanumeric display driver for HOLTEK HT16K33 (and VINKA VK16K33 clone)
|
|
* This driver is specific for a 0.54" 14-segment LED HT16K33 Backpack
|
|
* module with 4 14-segment digits (2 Kingbright 5241AS display).
|
|
* Note: the model I'm testing uses the VK16K33.
|
|
*
|
|
* This is how the displays are connected:
|
|
* Left Display: Digit 1: Catode connected to COM3
|
|
* Left Display: Digit 2: Catode connected to COM2
|
|
* Right Display: Digit 1: Catode connected to COM1
|
|
* Right Display: Digit 2: Catode connected to COM0
|
|
*
|
|
* 14-Segment | LED Controller
|
|
* -------------------------------
|
|
* 8 - DP | ROW14 - 11
|
|
* 13 - p | ROW6 - 19
|
|
* 2 - n | ROW11 - 14
|
|
* 4 - m | ROW12 - 13
|
|
* 5 - l | ROW13 - 12
|
|
* 6 - k | ROW7 - 18
|
|
* 14 - j | ROW10 - 15
|
|
* 15 - h | ROW9 - 16
|
|
* 17 - g | ROW8 - 17
|
|
* 18 - f | ROW5 - 20
|
|
* 1 - e | ROW4 - 21
|
|
* 7 - d | ROW3 - 22
|
|
* 9 - c | ROW2 - 23
|
|
* 10 - b | ROW1 - 24
|
|
* 12 - a | ROW0 - 25
|
|
*/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <stdlib.h>
|
|
#include <errno.h>
|
|
#include <debug.h>
|
|
#include <string.h>
|
|
|
|
#include <nuttx/kmalloc.h>
|
|
#include <nuttx/signal.h>
|
|
#include <nuttx/ascii.h>
|
|
#include <nuttx/fs/fs.h>
|
|
#include <nuttx/lcd/slcd_codec.h>
|
|
#include <nuttx/lcd/slcd_ioctl.h>
|
|
#include <nuttx/i2c/i2c_master.h>
|
|
#include <nuttx/lcd/ht16k33.h>
|
|
|
|
#ifndef CONFIG_LIB_SLCDCODEC
|
|
# error please also select Library Routines, Segment LCD CODEC
|
|
#endif
|
|
|
|
#if defined(CONFIG_I2C) && defined(CONFIG_LCD_HT16K33)
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* I2C frequency */
|
|
|
|
#ifndef CONFIG_HT16K33_I2C_FREQ
|
|
# define CONFIG_HT16K33_I2C_FREQ 400000
|
|
#endif
|
|
|
|
#ifndef CONFIG_LCD_HT16K33_NUMBER_MODULES
|
|
# define CONFIG_LCD_HT16K33_NUMBER_MODULES 1
|
|
#endif
|
|
|
|
#define HT16K33_MAX_ROW 1
|
|
#define HT16K33_MAX_COL 4 * CONFIG_LCD_HT16K33_NUMBER_MODULES
|
|
|
|
/* Device naming ************************************************************/
|
|
|
|
#define DEVNAME_FMT "/dev/slcd%d"
|
|
#define DEVNAME_FMTLEN (9 + 3 + 1)
|
|
|
|
/****************************************************************************
|
|
* Private Types
|
|
****************************************************************************/
|
|
|
|
struct ht16k33_dev_s
|
|
{
|
|
FAR struct i2c_master_s *i2c; /* I2C interface */
|
|
uint8_t row; /* Current row position to write on display */
|
|
uint8_t col; /* Current col position to write on display */
|
|
uint8_t buffer[HT16K33_MAX_COL];
|
|
bool pendscroll;
|
|
sem_t sem_excl;
|
|
};
|
|
|
|
struct lcd_instream_s
|
|
{
|
|
struct lib_instream_s stream;
|
|
FAR const char *buffer;
|
|
ssize_t nbytes;
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Function Prototypes
|
|
****************************************************************************/
|
|
|
|
static inline void ht16k33_write_cmd(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, uint8_t cmd);
|
|
|
|
static inline void ht16k33_write_data(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, uint8_t cmd,
|
|
uint8_t *values, int nbytes);
|
|
|
|
static inline void ht16k33_setcontrast(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, int8_t contrast);
|
|
|
|
static void lcd_scroll_up(FAR struct ht16k33_dev_s *priv);
|
|
|
|
static void ht16k33_clear_display(FAR struct ht16k33_dev_s *priv);
|
|
|
|
/* Character driver methods */
|
|
|
|
static int ht16k33_open(FAR struct file *filep);
|
|
static int ht16k33_close(FAR struct file *filep);
|
|
static ssize_t ht16k33_read(FAR struct file *filep, FAR char *buffer,
|
|
size_t buflen);
|
|
static ssize_t ht16k33_write(FAR struct file *filep, FAR const char *buffer,
|
|
size_t buflen);
|
|
static off_t ht16k33_seek(FAR struct file *filep, off_t offset,
|
|
int whence);
|
|
static int ht16k33_ioctl(FAR struct file *filep, int cmd,
|
|
unsigned long arg);
|
|
|
|
/****************************************************************************
|
|
* Private Data
|
|
****************************************************************************/
|
|
|
|
static const struct file_operations g_ht16k33fops =
|
|
{
|
|
ht16k33_open, /* open */
|
|
ht16k33_close, /* close */
|
|
ht16k33_read, /* read */
|
|
ht16k33_write, /* write */
|
|
ht16k33_seek, /* seek */
|
|
ht16k33_ioctl, /* ioctl */
|
|
NULL, /* poll */
|
|
#ifndef CONFIG_DISABLE_PSEUDOFS_OPERATIONS
|
|
NULL /* unlink */
|
|
#endif
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_write_cmd
|
|
*
|
|
* Description:
|
|
* Write an Instruction command to HT16K33
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline void ht16k33_write_cmd(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, uint8_t cmd)
|
|
{
|
|
struct i2c_msg_s msg;
|
|
uint8_t data[1];
|
|
int ret;
|
|
|
|
/* Prepare data to send */
|
|
|
|
data[0] = cmd;
|
|
|
|
/* Setup the HT16K33 Command */
|
|
|
|
msg.frequency = CONFIG_HT16K33_I2C_FREQ; /* I2C frequency */
|
|
msg.addr = HT16K33_I2C_ADDR + dev_id; /* 7-bit address */
|
|
msg.flags = 0; /* Write transaction */
|
|
msg.buffer = (FAR uint8_t *) data; /* Transfer from this address */
|
|
msg.length = 1; /* Send one byte */
|
|
|
|
/* Perform the transfer */
|
|
|
|
ret = I2C_TRANSFER(priv->i2c, &msg, 1);
|
|
if (ret < 0)
|
|
{
|
|
lcderr("ERROR: I2C_TRANSFER failed: %d\n", ret);
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_write_data
|
|
*
|
|
* Description:
|
|
* Write a Data command to HT16K33
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline void ht16k33_write_data(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, uint8_t cmd,
|
|
uint8_t *values, int nbytes)
|
|
{
|
|
struct i2c_msg_s msg;
|
|
uint8_t data[16];
|
|
int ret;
|
|
int i;
|
|
|
|
/* Prepare data to send */
|
|
|
|
data[0] = cmd;
|
|
|
|
for (i = 0; i < nbytes; i++)
|
|
{
|
|
data[i + 1] = values[i];
|
|
}
|
|
|
|
/* Setup the message to write data to HT16K33 */
|
|
|
|
msg.frequency = CONFIG_HT16K33_I2C_FREQ; /* I2C frequency */
|
|
msg.addr = HT16K33_I2C_ADDR + dev_id; /* 7-bit address */
|
|
msg.flags = 0; /* Write transaction */
|
|
msg.buffer = (FAR uint8_t *) data; /* Transfer from here */
|
|
msg.length = nbytes + 1; /* Send cmd + nbytes */
|
|
|
|
/* Perform the transfer */
|
|
|
|
ret = I2C_TRANSFER(priv->i2c, &msg, 1);
|
|
if (ret < 0)
|
|
{
|
|
lcderr("ERROR: I2C_TRANSFER failed: %d\n", ret);
|
|
}
|
|
}
|
|
|
|
static inline void ht16k33_setcontrast(FAR struct ht16k33_dev_s *priv,
|
|
int dev_id, int8_t contrast)
|
|
{
|
|
int i;
|
|
|
|
if (contrast < HT16K33_CONTRAST_MIN)
|
|
{
|
|
contrast = HT16K33_CONTRAST_MIN;
|
|
}
|
|
else if (contrast > HT16K33_CONTRAST_MAX)
|
|
{
|
|
contrast = HT16K33_CONTRAST_MAX;
|
|
}
|
|
|
|
for (i = 0; i < CONFIG_LCD_HT16K33_NUMBER_MODULES; i++)
|
|
{
|
|
ht16k33_write_cmd(priv, i, HT16K33_DIMMING_SET | (contrast & 0x0f));
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_getdata
|
|
*
|
|
* Description:
|
|
* Simulate reading data from LCD, we are reading from internal buffer
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline uint8_t lcd_getdata(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
uint8_t data;
|
|
data = priv->buffer[priv->row * priv->col];
|
|
return data;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: rc2addr
|
|
*
|
|
* Description:
|
|
* This converts a row/column pair to a screen memory address.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline uint8_t rc2addr(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
/* Each module has 4 digits they correspond to these columns:
|
|
*
|
|
* col0: 0x00 - 0x01, col1: 0x02 - 0x03,
|
|
* col2: 0x04 - 0x05, col3: 0x06 - 0x07
|
|
*/
|
|
|
|
return (priv->col % 4) * 0x02;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: addr2rc
|
|
*
|
|
* Description:
|
|
* This converts a screen memory address to a row/column pair.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline void addr2rc(FAR struct ht16k33_dev_s *priv, uint8_t addr,
|
|
FAR uint8_t *row, FAR uint8_t *col)
|
|
{
|
|
*row = 0;
|
|
*col = addr / 2;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_set_curpos
|
|
*
|
|
* Description:
|
|
* This sets the cursor position based on row, column addressing.
|
|
*
|
|
* Input Parameters:
|
|
* priv - device instance
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void lcd_set_curpos(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
uint8_t addr;
|
|
int dev_id;
|
|
|
|
addr = rc2addr(priv);
|
|
dev_id = priv->col / 4;
|
|
|
|
/* Define the memory address position */
|
|
|
|
ht16k33_write_cmd(priv, dev_id, HT16K33_DISP_DATA_ADDR | addr);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_putdata
|
|
*
|
|
* Description:
|
|
* Write a byte to the LCD and update column/row position
|
|
*
|
|
****************************************************************************/
|
|
|
|
static inline void lcd_putdata(FAR struct ht16k33_dev_s *priv, uint8_t data)
|
|
{
|
|
uint8_t segment[2];
|
|
uint8_t addr;
|
|
uint8_t cmd;
|
|
int dev_id;
|
|
|
|
/* Get current display memory position */
|
|
|
|
addr = rc2addr(priv);
|
|
|
|
/* Setup the memory command */
|
|
|
|
cmd = HT16K33_DISP_DATA_ADDR | addr;
|
|
|
|
/* Get the segments setting */
|
|
|
|
segment[0] = asciito14seg[data - 32] & 0xff;
|
|
segment[1] = (asciito14seg[data - 32] & 0xff00) >> 8;
|
|
|
|
dev_id = priv->col / 4;
|
|
|
|
/* Send data to display */
|
|
|
|
ht16k33_write_data(priv, dev_id, cmd, segment, 2);
|
|
|
|
/* Save it in the buffer because we cannot read from display */
|
|
|
|
priv->buffer[priv->col * priv->row] = data;
|
|
|
|
/* Update col/row positions */
|
|
|
|
priv->col++;
|
|
|
|
if (priv->col >= HT16K33_MAX_COL)
|
|
{
|
|
priv->col = 0;
|
|
priv->row++;
|
|
}
|
|
|
|
if (priv->row >= HT16K33_MAX_ROW)
|
|
{
|
|
priv->pendscroll = true;
|
|
priv->row = HT16K33_MAX_ROW - 1;
|
|
}
|
|
|
|
/* Update cursor position */
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_scroll_up
|
|
*
|
|
* Description:
|
|
* Scroll the display up, and clear the new (last) line.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void lcd_scroll_up(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
FAR uint8_t *data;
|
|
int currow;
|
|
int curcol;
|
|
|
|
data = (FAR uint8_t *)kmm_malloc(HT16K33_MAX_COL);
|
|
if (NULL == data)
|
|
{
|
|
lcdinfo("Failed to allocate buffer in lcd_scroll_up()\n");
|
|
return;
|
|
}
|
|
|
|
for (currow = 1; currow < HT16K33_MAX_ROW; ++currow)
|
|
{
|
|
priv->row = currow;
|
|
for (curcol = 0; curcol < HT16K33_MAX_COL; ++curcol)
|
|
{
|
|
priv->col = curcol;
|
|
data[curcol] = lcd_getdata(priv);
|
|
}
|
|
|
|
priv->col = 0;
|
|
priv->row = currow - 1;
|
|
lcd_set_curpos(priv);
|
|
for (curcol = 0; curcol < HT16K33_MAX_COL; ++curcol)
|
|
{
|
|
lcd_putdata(priv, data[curcol]);
|
|
}
|
|
}
|
|
|
|
ht16k33_clear_display(priv);
|
|
|
|
kmm_free(data);
|
|
return;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_clear_display
|
|
*
|
|
* Description:
|
|
* Clear the display writing space (' ') to all positions
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void ht16k33_clear_display(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
int curcol;
|
|
|
|
priv->col = 0;
|
|
priv->row = HT16K33_MAX_ROW - 1;
|
|
lcd_set_curpos(priv);
|
|
for (curcol = 0; curcol < HT16K33_MAX_COL; ++curcol)
|
|
{
|
|
lcd_putdata(priv, ' ');
|
|
}
|
|
|
|
priv->col = 0;
|
|
priv->row = HT16K33_MAX_ROW - 1;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_codec_action
|
|
*
|
|
* Description:
|
|
* Perform an 'action' as per the Segment LCD codec.
|
|
*
|
|
* Input Parameters:
|
|
* priv - device instance
|
|
* code - SLCD code action code
|
|
* count - count param for those actions that take it
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void lcd_codec_action(FAR struct ht16k33_dev_s *priv,
|
|
enum slcdcode_e code, uint8_t count)
|
|
{
|
|
switch (code)
|
|
{
|
|
/* Erasure */
|
|
|
|
case SLCDCODE_BACKDEL: /* Backspace (backward delete)
|
|
* N characters
|
|
*/
|
|
{
|
|
if (count <= 0) /* we need to delete more 0 positions */
|
|
{
|
|
break;
|
|
}
|
|
else
|
|
{
|
|
if (count > priv->col) /* saturate to preceding columns
|
|
* available
|
|
*/
|
|
{
|
|
count = priv->col;
|
|
}
|
|
|
|
priv->col = priv->col - count;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
|
|
/* ... and conscientiously fall through to next case ... */
|
|
}
|
|
|
|
case SLCDCODE_FWDDEL: /* Delete (forward delete) N characters
|
|
* moving text
|
|
*/
|
|
{
|
|
if (count <= 0) /* we need to delete more 0 positions */
|
|
{
|
|
break;
|
|
}
|
|
else
|
|
{
|
|
uint8_t start;
|
|
uint8_t end;
|
|
uint8_t i;
|
|
uint8_t data;
|
|
|
|
start = priv->col + count;
|
|
|
|
if (start >= HT16K33_MAX_COL) /* nothing left */
|
|
{
|
|
break;
|
|
}
|
|
|
|
end = start + count;
|
|
if (end > HT16K33_MAX_COL) /* saturate */
|
|
{
|
|
end = HT16K33_MAX_COL;
|
|
}
|
|
|
|
for (i = priv->col; i < end; ++start, ++i) /* like memmove */
|
|
{
|
|
priv->col = start;
|
|
lcd_set_curpos(priv);
|
|
data = lcd_getdata(priv);
|
|
priv->col = i;
|
|
lcd_set_curpos(priv);
|
|
lcd_putdata(priv, data);
|
|
}
|
|
|
|
for (; i < HT16K33_MAX_COL; ++i) /* much like memset */
|
|
{
|
|
lcd_putdata(priv, ' ');
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_ERASE: /* Erase N characters from the cursor
|
|
* position
|
|
*/
|
|
if (count > 0)
|
|
{
|
|
uint8_t end;
|
|
uint8_t i;
|
|
|
|
end = priv->col + count;
|
|
if (end > HT16K33_MAX_COL)
|
|
{
|
|
end = HT16K33_MAX_COL;
|
|
}
|
|
|
|
for (i = priv->col; i < end; ++i)
|
|
{
|
|
lcd_putdata(priv, ' ');
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_CLEAR: /* Home the cursor and erase the entire
|
|
* display
|
|
*/
|
|
{
|
|
/* ht16k33_write_cmd(priv, HT16K33_CLEAR_DISPLAY); */
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_ERASEEOL: /* Erase from the cursor position to
|
|
* the end of line
|
|
*/
|
|
{
|
|
uint8_t i;
|
|
|
|
for (i = priv->col; i < HT16K33_MAX_COL; ++i)
|
|
{
|
|
lcd_putdata(priv, ' ');
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
/* Cursor movement */
|
|
|
|
case SLCDCODE_LEFT: /* Cursor left by N characters */
|
|
{
|
|
if (count > priv->col)
|
|
{
|
|
priv->col = 0;
|
|
}
|
|
else
|
|
{
|
|
priv->col -= count;
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_RIGHT: /* Cursor right by N characters */
|
|
{
|
|
priv->col += count;
|
|
if (priv->col >= HT16K33_MAX_COL)
|
|
{
|
|
priv->col = HT16K33_MAX_COL - 1;
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_UP: /* Cursor up by N lines */
|
|
{
|
|
if (count > priv->row)
|
|
{
|
|
priv->row = 0;
|
|
}
|
|
else
|
|
{
|
|
priv->row -= count;
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_DOWN: /* Cursor down by N lines */
|
|
{
|
|
priv->row += count;
|
|
if (priv->row >= HT16K33_MAX_ROW)
|
|
{
|
|
priv->row = HT16K33_MAX_ROW - 1;
|
|
}
|
|
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_HOME: /* Cursor home */
|
|
{
|
|
priv->col = 0;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_END: /* Cursor end */
|
|
{
|
|
priv->col = HT16K33_MAX_COL - 1;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
break;
|
|
|
|
case SLCDCODE_PAGEUP: /* Cursor up by N pages */
|
|
case SLCDCODE_PAGEDOWN: /* Cursor down by N pages */
|
|
break; /* Not supportable on this SLCD */
|
|
|
|
/* Blinking */
|
|
|
|
case SLCDCODE_BLINKSTART: /* Start blinking with current cursor
|
|
* position
|
|
*/
|
|
ht16k33_write_cmd(priv, 0, HT16K33_DISPLAY_SETUP |
|
|
DISPLAY_SETUP_BLINK_2HZ);
|
|
break;
|
|
|
|
case SLCDCODE_BLINKEND: /* End blinking after the current cursor
|
|
* position
|
|
*/
|
|
case SLCDCODE_BLINKOFF: /* Turn blinking off */
|
|
ht16k33_write_cmd(priv, 0, HT16K33_DISPLAY_SETUP |
|
|
DISPLAY_SETUP_BLINK_OFF);
|
|
break; /* Not implemented */
|
|
|
|
/* These are actually unreportable errors */
|
|
|
|
default:
|
|
case SLCDCODE_NORMAL: /* Not a special keycode */
|
|
break;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_getstream
|
|
*
|
|
* Description:
|
|
* Get one character from the LCD codec stream.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int lcd_getstream(FAR struct lib_instream_s *instream)
|
|
{
|
|
FAR struct lcd_instream_s *lcdstream =
|
|
(FAR struct lcd_instream_s *)instream;
|
|
|
|
if (lcdstream->nbytes > 0)
|
|
{
|
|
lcdstream->nbytes--;
|
|
lcdstream->stream.nget++;
|
|
return (int)*lcdstream->buffer++;
|
|
}
|
|
|
|
return EOF;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_init
|
|
*
|
|
* Description:
|
|
* perform the initialization sequence to get the LCD into a known state.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void lcd_init(FAR struct ht16k33_dev_s *priv)
|
|
{
|
|
uint8_t data;
|
|
int i;
|
|
|
|
for (i = 0; i < CONFIG_LCD_HT16K33_NUMBER_MODULES; i++)
|
|
{
|
|
/* Initialize the Display: Turn ON Oscillator */
|
|
|
|
data = HT16K33_SYSTEM_SETUP | SYSTEM_SETUP_OSC_ON;
|
|
|
|
ht16k33_write_cmd(priv, i, data);
|
|
|
|
/* Clear display */
|
|
|
|
ht16k33_clear_display(priv);
|
|
|
|
/* Display ON */
|
|
|
|
data = HT16K33_DISPLAY_SETUP | DISPLAY_SETUP_DISP_ON;
|
|
|
|
ht16k33_write_cmd(priv, i, data);
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: lcd_curpos_to_fpos
|
|
*
|
|
* Description:
|
|
* Convert a screen cursor pos (row,col) to a file logical offset. This
|
|
* includes 'synthesized' line feeds at the end of screen lines.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void lcd_curpos_to_fpos(FAR struct ht16k33_dev_s *priv,
|
|
uint8_t row, uint8_t col, FAR off_t *fpos)
|
|
{
|
|
/* the logical file position is the linear position plus any synthetic LF */
|
|
|
|
*fpos = (row * HT16K33_MAX_COL) + col + row;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_open
|
|
*
|
|
* Description:
|
|
* This function is called whenever the HT16K33 device is opened.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int ht16k33_open(FAR struct file *filep)
|
|
{
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_close
|
|
*
|
|
* Description:
|
|
* This routine is called when the LM-75 device is closed.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int ht16k33_close(FAR struct file *filep)
|
|
{
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_read
|
|
****************************************************************************/
|
|
|
|
static ssize_t ht16k33_read(FAR struct file *filep, FAR char *buffer,
|
|
size_t buflen)
|
|
{
|
|
return -ENOSYS;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_write
|
|
****************************************************************************/
|
|
|
|
static ssize_t ht16k33_write(FAR struct file *filep, FAR const char *buffer,
|
|
size_t buflen)
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct ht16k33_dev_s *priv = inode->i_private;
|
|
struct lcd_instream_s instream;
|
|
struct slcdstate_s state;
|
|
enum slcdret_e result;
|
|
uint8_t ch;
|
|
uint8_t count;
|
|
|
|
nxsem_wait(&priv->sem_excl);
|
|
|
|
/* Initialize the stream for use with the SLCD CODEC */
|
|
|
|
instream.stream.get = lcd_getstream;
|
|
instream.stream.nget = 0;
|
|
instream.buffer = buffer;
|
|
instream.nbytes = buflen;
|
|
|
|
/* Now decode and process every byte in the input buffer */
|
|
|
|
memset(&state, 0, sizeof(struct slcdstate_s));
|
|
while ((result = slcd_decode(&instream.stream, &state, &ch, &count)) !=
|
|
SLCDRET_EOF)
|
|
{
|
|
/* Is there some pending scroll? */
|
|
|
|
if (priv->pendscroll)
|
|
{
|
|
lcd_scroll_up(priv);
|
|
priv->pendscroll = false;
|
|
}
|
|
|
|
if (result == SLCDRET_CHAR) /* A normal character was returned */
|
|
{
|
|
/* Check for ASCII control characters */
|
|
|
|
if (ch == ASCII_TAB)
|
|
{
|
|
/* TODO: define what TAB should do */
|
|
}
|
|
else if (ch == ASCII_VT)
|
|
{
|
|
/* Turn the backlight on */
|
|
|
|
/* TODO: lcd_backlight(priv, true); */
|
|
}
|
|
else if (ch == ASCII_FF)
|
|
{
|
|
/* Turn the backlight off */
|
|
|
|
/* TODO: lcd_backlight(priv, false); */
|
|
}
|
|
else if (ch == ASCII_CR)
|
|
{
|
|
/* Perform a Home */
|
|
|
|
priv->col = 0;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
else if (ch == ASCII_SO)
|
|
{
|
|
/* TODO: We don't have cursor */
|
|
}
|
|
else if (ch == ASCII_SI)
|
|
{
|
|
/* Perform the re-initialize */
|
|
|
|
lcd_init(priv);
|
|
priv->row = 0;
|
|
priv->col = 0;
|
|
}
|
|
else if (ch == ASCII_LF)
|
|
{
|
|
/* unixian line term; go to start of next line */
|
|
|
|
priv->row += 1;
|
|
if (priv->row >= HT16K33_MAX_ROW)
|
|
{
|
|
priv->pendscroll = true;
|
|
priv->row = HT16K33_MAX_ROW - 1;
|
|
}
|
|
|
|
priv->col = 0;
|
|
lcd_set_curpos(priv);
|
|
}
|
|
else if (ch == ASCII_BS)
|
|
{
|
|
/* Perform the backward deletion */
|
|
|
|
lcd_codec_action(priv, SLCDCODE_BACKDEL, 1);
|
|
}
|
|
else if (ch == ASCII_DEL)
|
|
{
|
|
/* Perform the forward deletion */
|
|
|
|
lcd_codec_action(priv, SLCDCODE_FWDDEL, 1);
|
|
}
|
|
else
|
|
{
|
|
/* Just print it! */
|
|
|
|
lcd_putdata(priv, ch);
|
|
}
|
|
}
|
|
else /* (result == SLCDRET_SPEC) */ /* A special SLCD action was returned */
|
|
{
|
|
lcd_codec_action(priv, (enum slcdcode_e)ch, count);
|
|
}
|
|
}
|
|
|
|
/* Wherever we wound up, update our logical file pos to reflect it */
|
|
|
|
lcd_curpos_to_fpos(priv, priv->row, priv->col, &filep->f_pos);
|
|
|
|
nxsem_post(&priv->sem_excl);
|
|
return buflen;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_seek
|
|
*
|
|
* Description:
|
|
* Seek the logical file pointer to the specified position. This is
|
|
* probably not very interesting except possibly for (SEEK_SET, 0) to
|
|
* rewind the pointer for a subsequent read().
|
|
* The file pointer is logical, and includes synthesized LF chars at the
|
|
* end of the display lines.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static off_t ht16k33_seek(FAR struct file *filep, off_t offset, int whence)
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct ht16k33_dev_s *priv =
|
|
(FAR struct ht16k33_dev_s *)inode->i_private;
|
|
off_t maxpos;
|
|
off_t pos;
|
|
|
|
nxsem_wait(&priv->sem_excl);
|
|
|
|
maxpos = HT16K33_MAX_ROW * HT16K33_MAX_COL + (HT16K33_MAX_ROW - 1);
|
|
pos = filep->f_pos;
|
|
|
|
switch (whence)
|
|
{
|
|
case SEEK_CUR:
|
|
pos += offset;
|
|
if (pos > maxpos)
|
|
{
|
|
pos = maxpos;
|
|
}
|
|
else if (pos < 0)
|
|
{
|
|
pos = 0;
|
|
}
|
|
|
|
filep->f_pos = pos;
|
|
break;
|
|
|
|
case SEEK_SET:
|
|
pos = offset;
|
|
if (pos > maxpos)
|
|
{
|
|
pos = maxpos;
|
|
}
|
|
else if (pos < 0)
|
|
{
|
|
pos = 0;
|
|
}
|
|
|
|
filep->f_pos = pos;
|
|
break;
|
|
|
|
case SEEK_END:
|
|
pos = maxpos + offset;
|
|
if (pos > maxpos)
|
|
{
|
|
pos = maxpos;
|
|
}
|
|
else if (pos < 0)
|
|
{
|
|
pos = 0;
|
|
}
|
|
|
|
filep->f_pos = pos;
|
|
break;
|
|
|
|
default:
|
|
|
|
/* Return EINVAL if the whence argument is invalid */
|
|
|
|
pos = (off_t)-EINVAL;
|
|
break;
|
|
}
|
|
|
|
nxsem_post(&priv->sem_excl);
|
|
return pos;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_ioctl
|
|
*
|
|
* Description:
|
|
* Perform device operations that are outside the standard I/O model.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int ht16k33_ioctl(FAR struct file *filep, int cmd,
|
|
unsigned long arg)
|
|
{
|
|
switch (cmd)
|
|
{
|
|
case SLCDIOC_GETATTRIBUTES: /* Get the attributes of the SLCD */
|
|
{
|
|
FAR struct slcd_attributes_s *attr =
|
|
(FAR struct slcd_attributes_s *)((uintptr_t)arg);
|
|
|
|
lcdinfo("SLCDIOC_GETATTRIBUTES:\n");
|
|
|
|
if (!attr)
|
|
{
|
|
return -EINVAL;
|
|
}
|
|
|
|
attr->nrows = HT16K33_MAX_ROW;
|
|
attr->ncolumns = HT16K33_MAX_COL;
|
|
attr->nbars = 0;
|
|
attr->maxcontrast = 0;
|
|
attr->maxbrightness = 16; /* 'brightness' for us is the backlight */
|
|
}
|
|
break;
|
|
|
|
case SLCDIOC_CURPOS: /* Get the SLCD cursor position */
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct ht16k33_dev_s *priv =
|
|
(FAR struct ht16k33_dev_s *)inode->i_private;
|
|
FAR struct slcd_curpos_s *attr =
|
|
(FAR struct slcd_curpos_s *)((uintptr_t)arg);
|
|
|
|
attr->row = priv->row;
|
|
attr->column = priv->col;
|
|
}
|
|
break;
|
|
|
|
case SLCDIOC_GETBRIGHTNESS: /* Get the current brightness setting */
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct ht16k33_dev_s *priv =
|
|
(FAR struct ht16k33_dev_s *)inode->i_private;
|
|
|
|
nxsem_wait(&priv->sem_excl);
|
|
*(FAR int *)((uintptr_t)arg) = 1; /* Hardcoded */
|
|
nxsem_post(&priv->sem_excl);
|
|
}
|
|
break;
|
|
|
|
case SLCDIOC_SETBRIGHTNESS: /* Set the brightness to a new value */
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct ht16k33_dev_s *priv =
|
|
(FAR struct ht16k33_dev_s *)inode->i_private;
|
|
|
|
nxsem_wait(&priv->sem_excl);
|
|
|
|
ht16k33_setcontrast(priv, 0, (uint8_t)arg);
|
|
|
|
nxsem_post(&priv->sem_excl);
|
|
}
|
|
break;
|
|
|
|
case SLCDIOC_SETBAR: /* Set bars on a bar display */
|
|
case SLCDIOC_GETCONTRAST: /* Get the current contrast setting */
|
|
case SLCDIOC_SETCONTRAST: /* Set the contrast to a new value */
|
|
default:
|
|
return -ENOTTY;
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: ht16k33_register
|
|
*
|
|
* Description:
|
|
* Register the HT16K33 character device as 'devpath'
|
|
*
|
|
* Input Parameters:
|
|
* devno - The device number to register. E.g., "/dev/slcd0"
|
|
* i2c - An instance of the I2C interface to use to communicate with
|
|
* HT16K33
|
|
*
|
|
* Returned Value:
|
|
* Zero (OK) on success; a negated errno value on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
int ht16k33_register(int devno, FAR struct i2c_master_s *i2c)
|
|
{
|
|
FAR struct ht16k33_dev_s *priv;
|
|
char devname[DEVNAME_FMTLEN];
|
|
int ret;
|
|
|
|
/* Initialize the HT16K33 device structure */
|
|
|
|
priv = (FAR struct ht16k33_dev_s *)
|
|
kmm_malloc(sizeof(struct ht16k33_dev_s));
|
|
if (!priv)
|
|
{
|
|
snerr("ERROR: Failed to allocate instance\n");
|
|
return -ENOMEM;
|
|
}
|
|
|
|
/* Setup priv with initial values */
|
|
|
|
priv->i2c = i2c;
|
|
priv->col = 0;
|
|
priv->row = 0;
|
|
priv->pendscroll = false;
|
|
|
|
nxsem_init(&priv->sem_excl, 0, 1);
|
|
|
|
/* Initialize the display */
|
|
|
|
lcd_init(priv);
|
|
|
|
/* Create the character device name */
|
|
|
|
snprintf(devname, DEVNAME_FMTLEN, DEVNAME_FMT, devno);
|
|
|
|
/* Register the driver */
|
|
|
|
ret = register_driver(devname, &g_ht16k33fops, 0666, priv);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: Failed to register driver: %d\n", ret);
|
|
kmm_free(priv);
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
#endif /* CONFIG_SPI && CONFIG_HT16K33 */
|