c9562e8bfd
- HAL re-organized - FreeRTOS running stable - UART finished - SPI1 & SPI3 finished and functional - Display driver added (functional) git-svn-id: https://svn.vbchaos.nl/svn/hsb/trunk@172 05563f52-14a8-4384-a975-3d1654cca0fa
243 lines
9.8 KiB
C
243 lines
9.8 KiB
C
// -----------------------------------------------------------------------------
|
|
/// @file nhd0420.h
|
|
/// @brief File description
|
|
// -----------------------------------------------------------------------------
|
|
// Micro-Key bv
|
|
// Industrieweg 28, 9804 TG Noordhorn
|
|
// Postbus 92, 9800 AB Zuidhorn
|
|
// The Netherlands
|
|
// Tel: +31 594 503020
|
|
// Fax: +31 594 505825
|
|
// Email: support@microkey.nl
|
|
// Web: www.microkey.nl
|
|
// -----------------------------------------------------------------------------
|
|
/// $Revision: $
|
|
/// $Author: $
|
|
/// $Date: $
|
|
// (c) 2017 Micro-Key bv
|
|
// -----------------------------------------------------------------------------
|
|
|
|
/// @defgroup {group_name} {group_description}
|
|
/// Description
|
|
|
|
/// @file nhd0420.h
|
|
/// @ingroup {group_name}
|
|
|
|
|
|
#ifndef DISPLAY_INC_NHD0420_H_
|
|
#define DISPLAY_INC_NHD0420_H_
|
|
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Include files
|
|
// -----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Constant and macro definitions
|
|
// -----------------------------------------------------------------------------
|
|
|
|
#define NHD0420_NUMBER_OF_ROWS (4)
|
|
#define NHD0420_NUMBER_OF_COLUMNS (20)
|
|
|
|
#define NHD0420_CONTRAST_MIN (1)
|
|
#define NHD0420_CONTRAST_MAX (50)
|
|
|
|
#define NHD0420_BRIGHTNESS_MIN (1)
|
|
#define NHD0420_BRIGHTNESS_MAX (8)
|
|
|
|
#define NHD0420_BAUDRATE_MIN (1)
|
|
#define NHD0420_BAUDRATE_MAX (8)
|
|
|
|
#define NHD0420_CMD_LENGTH (2)
|
|
|
|
#define NHD0420_CMD_PREFIX (0xFE)
|
|
|
|
#define NHD0420_CMD_DISPLAY_ON (0x41)
|
|
#define NHD0420_CMD_DISPLAY_OFF (0x42)
|
|
#define NHD0420_CMD_CURSOR_SET (0x45)
|
|
#define NHD0420_CMD_CURSOR_HOME (0x46)
|
|
#define NHD0420_CMD_CURSOR_UL_ON (0x47)
|
|
#define NHD0420_CMD_CURSOR_UL_OFF (0x48)
|
|
#define NHD0420_CMD_CURSOR_MV_LEFT (0x49)
|
|
#define NHD0420_CMD_CURSOR_MV_RIGHT (0x4A)
|
|
#define NHD0420_CMD_CURSOR_BLK_ON (0x4B)
|
|
#define NHD0420_CMD_CURSOR_BLK_OFF (0x4C)
|
|
#define NHD0420_CMD_CURSOR_BACKSPACE (0x4E)
|
|
#define NHD0420_CMD_CLR_SCREEN (0x51)
|
|
#define NHD0420_CMD_SET_CONTRAST (0x52)
|
|
#define NHD0420_CMD_SET_BRIGHTNESS (0x53)
|
|
#define NHD0420_CMD_LOAD_CSTM_CHAR (0x54)
|
|
#define NHD0420_CMD_MV_DISPLAY_LEFT (0x55)
|
|
#define NHD0420_CMD_MV_DISPLAY_RIGHT (0x56)
|
|
#define NHD0420_CMD_CHANGE_RS232_BR (0x61)
|
|
#define NHD0420_CMD_CHANGE_I2C_ADDRSS (0x62)
|
|
#define NHD0420_CMD_SHOW_VERSION (0x70)
|
|
#define NHD0420_CMD_SHOW_RS232_BR (0x71)
|
|
#define NHD0420_CMD_SHOW_I2C_ADDRSS (0x72)
|
|
|
|
#define NHD0420_turnOnDisplay() NHD0420_sendCommand(NHD0420_CMD_DISPLAY_ON)
|
|
#define NHD0420_turnOffDisplay() NHD0420_sendCommand(NHD0420_CMD_DISPLAY_OFF)
|
|
|
|
#define NHD0420_setCursorToHome() NHD0420_sendCommand(NHD0420_CMD_CURSOR_HOME)
|
|
#define NHD0420_setUnderlineCursorOn() NHD0420_sendCommand(NHD0420_CMD_CURSOR_UL_ON)
|
|
#define NHD0420_setUnderlineCursorOff() NHD0420_sendCommand(NHD0420_CMD_CURSOR_UL_OFF)
|
|
#define NHD0420_moveCursorToLeft() NHD0420_sendCommand(NHD0420_CMD_CURSOR_MV_LEFT)
|
|
#define NHD0420_moveCursorToRight() NHD0420_sendCommand(NHD0420_CMD_CURSOR_MV_RIGHT)
|
|
#define NHD0420_turnOnBlinkingCursor() NHD0420_sendCommand(NHD0420_CMD_CURSOR_BLK_ON)
|
|
#define NHD0420_turnOffBlinkingCursor() NHD0420_sendCommand(NHD0420_CMD_CURSOR_BLK_OFF)
|
|
#define NHD0420_useBackspace() NHD0420_sendCommand(NHD0420_CMD_CURSOR_BACKSPACE)
|
|
#define NHD0420_clearScreen() NHD0420_sendCommand(NHD0420_CMD_CLR_SCREEN)
|
|
|
|
#define NHD0420_moveDisplayToLeft() NHD0420_sendCommand(NHD0420_CMD_MV_DISPLAY_LEFT)
|
|
#define NHD0420_moveDisplayToRight() NHD0420_sendCommand(NHD0420_CMD_MV_DISPLAY_RIGHT)
|
|
|
|
#define NHD0420_showFirmwareVersion() NHD0420_sendCommand(NHD0420_CMD_SHOW_VERSION)
|
|
#define NHD0420_showRS232Baudrate() NHD0420_sendCommand(NHD0420_CMD_SHOW_RS232_BR)
|
|
#define NHD0420_showI2CAddress() NHD0420_sendCommand(NHD0420_CMD_SHOW_I2C_ADDRSS)
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Type definitions.
|
|
// -----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Function declarations
|
|
// -----------------------------------------------------------------------------
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_Init
|
|
* Initialises the NewHeaven Display 0420
|
|
*
|
|
* @param interface The interface to use
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_construct(void* interface);
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_setCursorToPosition
|
|
* Sets the cursor of the display to the specified row and column
|
|
*
|
|
* @param row The Row to set - between 1 and 4
|
|
* @param column The column to set - between 1 and 20
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_setCursorToPosition(uint8_t row, uint8_t column);
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_setContrast
|
|
* Sets the contrast of the display
|
|
*
|
|
* @param contrast The contrast to set - between 1 and 50.
|
|
* If passed value is outside the boundaries
|
|
* this function will return ERROR
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_setContrast(uint8_t contrast);
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_setBacklightBrightness
|
|
* Sets the backlight brightness of the display
|
|
*
|
|
* @param brightness The contrast to set - between 1 and 8
|
|
* If passed value is outside the boundaries
|
|
* this function will return ERROR
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_setBacklightBrightness(uint8_t brightness);
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_setRS232Baudrate
|
|
* Sets the baudrate of the display
|
|
*
|
|
* @param baudrate The baudrate to set - between 1 and 8
|
|
* 1 = 300 baud
|
|
* 2 = 1200 baud
|
|
* 3 = 2400 baud
|
|
* 4 = 9600 baud
|
|
* 5 = 14400 baud
|
|
* 6 = 19200 baud
|
|
* 7 = 57600 baud
|
|
* 8 = 115200 baud
|
|
* If passed value is outside the boundaries
|
|
* this function will return ERROR
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_setRS232Baudrate(uint8_t baudrate);
|
|
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_setI2CAddress
|
|
* Sets the I2C address of the display
|
|
*
|
|
* @param address The address to set
|
|
* This command sets the I2C address. The
|
|
* address must be an even number (LSB = 0)
|
|
* and must not be 0xFF.
|
|
* The address change requires 20 us to
|
|
* take effect; therefore, the subsequent
|
|
* input must have an appropriate delay.
|
|
* The default I2C address can be
|
|
* restored if SPI or RS-232 is selected as
|
|
* the communication mode.
|
|
* Default: 0x50
|
|
*
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_setI2CAddress(uint8_t address);
|
|
|
|
/** ----------------------------------------------------------------------------
|
|
* NHD0420_SendCommand
|
|
* Send a command to the display
|
|
*
|
|
* @param command
|
|
*
|
|
* @return ErrorStatus SUCCESS if initialisation was successful
|
|
* ERROR otherwise
|
|
*
|
|
* @todo
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
extern ErrorStatus NHD0420_sendCommand(uint8_t command);
|
|
|
|
extern ErrorStatus NHD0420_sendData(const uint8_t* buffer, size_t length);
|
|
|
|
#endif /* DISPLAY_INC_NHD0420_H_ */
|