diff options
| -rw-r--r-- | demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/Makefile | 3 | ||||
| -rw-r--r-- | os/hal/hal.mk | 6 | ||||
| -rw-r--r-- | os/various/devices_lib/others/ili9341.c (renamed from demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.c) | 836 | ||||
| -rw-r--r-- | os/various/devices_lib/others/ili9341.h (renamed from demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.h) | 1186 |
4 files changed, 1016 insertions, 1015 deletions
diff --git a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/Makefile b/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/Makefile index 3de08f4..c1fa53e 100644 --- a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/Makefile +++ b/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/Makefile @@ -116,8 +116,8 @@ CSRC = $(STARTUPSRC) \ $(CHIBIOS)/os/various/shell.c \
$(CHIBIOS)/os/hal/lib/streams/memstreams.c \
$(CHIBIOS)/os/hal/lib/streams/chprintf.c \
+ $(CHIBIOS)/community/os/various/devices_lib/others/ili9341.c \
./main.c \
- ./ili9341.c \
./wolf3d_palette.c \
./res/wolf3d_vgagraph_chunk87.c \
./stmdrivers/stm32f4xx_fmc.c \
@@ -155,6 +155,7 @@ INCDIR = $(STARTUPINC) $(KERNINC) $(PORTINC) $(OSALINC) \ $(HALINC) $(PLATFORMINC) $(BOARDINC) $(TESTINC) \
$(CHIBIOS)/os/various \
$(CHIBIOS)/os/hal/lib/streams \
+ $(CHIBIOS)/community/os/various/devices_lib/others \
./res \
./stmdrivers \
# eol
diff --git a/os/hal/hal.mk b/os/hal/hal.mk index 2508c90..51cda56 100644 --- a/os/hal/hal.mk +++ b/os/hal/hal.mk @@ -1,8 +1,8 @@ include ${CHIBIOS}/os/hal/hal.mk
HALSRC += ${CHIBIOS}/community/os/hal/src/hal_community.c \
- ${CHIBIOS}/community/os/hal/src/nand.c \
- ${CHIBIOS}/community/os/hal/src/onewire.c \
- ${CHIBIOS}/community/os/hal/src/eicu.c
+ ${CHIBIOS}/community/os/hal/src/nand.c \
+ ${CHIBIOS}/community/os/hal/src/onewire.c \
+ ${CHIBIOS}/community/os/hal/src/eicu.c
HALINC += ${CHIBIOS}/community/os/hal/include
diff --git a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.c b/os/various/devices_lib/others/ili9341.c index f2efa8d..979e502 100644 --- a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.c +++ b/os/various/devices_lib/others/ili9341.c @@ -1,418 +1,418 @@ -/*
- Copyright (C) 2013-2015 Andrea Zoppi
-
- Licensed 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.
-*/
-
-/**
- * @file ili9341.c
- * @brief ILI9341 TFT LCD diaplay controller driver.
- * @note Does not support multiple calling threads natively.
- */
-
-#include "ch.h"
-#include "hal.h"
-#include "ili9341.h"
-
-/**
- * @addtogroup ili9341
- * @{
- */
-
-/*===========================================================================*/
-/* Driver local definitions. */
-/*===========================================================================*/
-
-#if !ILI9341_USE_CHECKS && !defined(__DOXYGEN__)
-/* Disable checks as needed.*/
-
-#ifdef osalDbgCheck
-#undef osalDbgCheck
-#endif
-#define osalDbgCheck(c, func) { \
- (void)(c), (void)__QUOTE_THIS(func)"()"; \
-}
-
-#ifdef osalDbgAssert
-#undef osalDbgAssert
-#endif
-#define osalDbgAssert(c, m, r) { \
- (void)(c); \
-}
-
-#ifdef osalDbgCheckClassS
-#undef osalDbgCheckClassS
-#endif
-#define osalDbgCheckClassS() {}
-
-#ifdef osalDbgCheckClassS
-#undef osalDbgCheckClassS
-#endif
-#define osalDbgCheckClassI() {}
-
-#endif /* ILI9341_USE_CHECKS */
-
-/*===========================================================================*/
-/* Driver exported variables. */
-/*===========================================================================*/
-
-/** @brief ILI9341D1 driver identifier.*/
-ILI9341Driver ILI9341D1;
-
-/*===========================================================================*/
-/* Driver local variables and types. */
-/*===========================================================================*/
-
-/*===========================================================================*/
-/* Driver local functions. */
-/*===========================================================================*/
-
-/*===========================================================================*/
-/* Driver exported functions. */
-/*===========================================================================*/
-
-/**
- * @brief Initializes the standard part of a @p ILI9341Driver structure.
- *
- * @param[out] driverp pointer to the @p ILI9341Driver object
- *
- * @init
- */
-void ili9341ObjectInit(ILI9341Driver *driverp) {
-
- osalDbgCheck(driverp != NULL);
-
- driverp->state = ILI9341_STOP;
- driverp->config = NULL;
-#if (TRUE == ILI9341_USE_MUTUAL_EXCLUSION)
-#if (TRUE == CH_CFG_USE_MUTEXES)
- chMtxObjectInit(&driverp->lock);
-#else
- chSemObjectInit(&driverp->lock, 1);
-#endif
-#endif /* (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) */
-}
-
-/**
- * @brief Configures and activates the ILI9341 peripheral.
- * @pre ILI9341 is stopped.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- * @param[in] configp pointer to the @p ILI9341Config object
- *
- * @api
- */
-void ili9341Start(ILI9341Driver *driverp, const ILI9341Config *configp) {
-
- chSysLock();
- osalDbgCheck(driverp != NULL);
- osalDbgCheck(configp != NULL);
- osalDbgCheck(configp->spi != NULL);
- osalDbgAssert(driverp->state == ILI9341_STOP, "invalid state");
-
- spiSelectI(configp->spi);
- spiUnselectI(configp->spi);
- driverp->config = configp;
- driverp->state = ILI9341_READY;
- chSysUnlock();
-}
-
-/**
- * @brief Deactivates the ILI9341 peripheral.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @api
- */
-void ili9341Stop(ILI9341Driver *driverp) {
-
- chSysLock();
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_READY, "invalid state");
-
- driverp->state = ILI9341_STOP;
- chSysUnlock();
-}
-
-#if ILI9341_USE_MUTUAL_EXCLUSION
-
-/**
- * @brief Gains exclusive access to the ILI9341 module.
- * @details This function tries to gain ownership to the ILI9341 module, if the
- * module is already being used then the invoking thread is queued.
- * @pre In order to use this function the option
- * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @sclass
- */
-void ili9341AcquireBusS(ILI9341Driver *driverp) {
-
- osalDbgCheckClassS();
- osalDbgCheck(driverp == &ILI9341D1);
- osalDbgAssert(driverp->state == ILI9341_READY, "not ready");
-
-#if (TRUE == CH_CFG_USE_MUTEXES)
- chMtxLockS(&driverp->lock);
-#else
- chSemWaitS(&driverp->lock);
-#endif
-}
-
-/**
- * @brief Gains exclusive access to the ILI9341 module.
- * @details This function tries to gain ownership to the ILI9341 module, if the
- * module is already being used then the invoking thread is queued.
- * @pre In order to use this function the option
- * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @api
- */
-void ili9341AcquireBus(ILI9341Driver *driverp) {
-
- chSysLock();
- ili9341AcquireBusS(driverp);
- chSysUnlock();
-}
-
-/**
- * @brief Releases exclusive access to the ILI9341 module.
- * @pre In order to use this function the option
- * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @sclass
- */
-void ili9341ReleaseBusS(ILI9341Driver *driverp) {
-
- osalDbgCheckClassS();
- osalDbgCheck(driverp == &ILI9341D1);
- osalDbgAssert(driverp->state == ILI9341_READY, "not ready");
-
-#if (TRUE == CH_CFG_USE_MUTEXES)
- chMtxUnlockS(&driverp->lock);
-#else
- chSemSignalI(&driverp->lock);
-#endif
-}
-
-/**
- * @brief Releases exclusive access to the ILI9341 module.
- * @pre In order to use this function the option
- * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @api
- */
-void ili9341ReleaseBus(ILI9341Driver *driverp) {
-
- chSysLock();
- ili9341ReleaseBusS(driverp);
- chSysUnlock();
-}
-
-#endif /* ILI9341_USE_MUTUAL_EXCLUSION */
-
-#if ILI9341_IM == ILI9341_IM_4LSI_1 /* 4-wire, half-duplex */
-
-/**
- * @brief Asserts the slave select signal and prepares for transfers.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @iclass
- */
-void ili9341SelectI(ILI9341Driver *driverp) {
-
- osalDbgCheckClassI();
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_READY, "invalid state");
-
- driverp->state = ILI9341_ACTIVE;
- spiSelectI(driverp->config->spi);
-}
-
-/**
- * @brief Asserts the slave select signal and prepares for transfers.
- * @pre ILI9341 is ready.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @api
- */
-void ili9341Select(ILI9341Driver *driverp) {
-
- chSysLock();
- ili9341SelectI(driverp);
- chSysUnlock();
-}
-
-/**
- * @brief Deasserts the slave select signal.
- * @details The previously selected peripheral is unselected.
- * @pre ILI9341 is active.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @iclass
- */
-void ili9341UnselectI(ILI9341Driver *driverp) {
-
- osalDbgCheckClassI();
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- spiUnselectI(driverp->config->spi);
- driverp->state = ILI9341_READY;
-}
-
-/**
- * @brief Deasserts the slave select signal.
- * @details The previously selected peripheral is unselected.
- * @pre ILI9341 is active.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @iclass
- */
-void ili9341Unselect(ILI9341Driver *driverp) {
-
- chSysLock();
- ili9341UnselectI(driverp);
- chSysUnlock();
-}
-
-/**
- * @brief Write command byte.
- * @details Sends a command byte via SPI.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- * @param[in] cmd command byte
- *
- * @api
- */
-void ili9341WriteCommand(ILI9341Driver *driverp, uint8_t cmd) {
-
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- driverp->value = cmd;
- palClearPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* !Cmd */
- spiSend(driverp->config->spi, 1, &driverp->value);
-}
-
-/**
- * @brief Write data byte.
- * @details Sends a data byte via SPI.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- * @param[in] value data byte
- *
- * @api
- */
-void ili9341WriteByte(ILI9341Driver *driverp, uint8_t value) {
-
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- driverp->value = value;
- palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */
- spiSend(driverp->config->spi, 1, &driverp->value);
-}
-
-/**
- * @brief Read data byte.
- * @details Receives a data byte via SPI.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- *
- * @return data byte
- *
- * @api
- */
-uint8_t ili9341ReadByte(ILI9341Driver *driverp) {
-
- osalDbgAssert(FALSE, "should not be used");
-
- osalDbgCheck(driverp != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */
- spiReceive(driverp->config->spi, 1, &driverp->value);
- return driverp->value;
-}
-
-/**
- * @brief Write data chunk.
- * @details Sends a data chunk via SPI.
- * @pre The chunk must be accessed by DMA.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- * @param[in] chunk chunk bytes
- * @param[in] length chunk length
- *
- * @api
- */
-void ili9341WriteChunk(ILI9341Driver *driverp, const uint8_t chunk[],
- size_t length) {
-
- osalDbgCheck(driverp != NULL);
- osalDbgCheck(chunk != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- if (length != 0) {
- palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */
- spiSend(driverp->config->spi, length, chunk);
- }
-}
-
-/**
- * @brief Read data chunk.
- * @details Receives a data chunk via SPI.
- * @pre The chunk must be accessed by DMA.
- *
- * @param[in] driverp pointer to the @p ILI9341Driver object
- * @param[out] chunk chunk bytes
- * @param[in] length chunk length
- *
- * @api
- */
-void ili9341ReadChunk(ILI9341Driver *driverp, uint8_t chunk[],
- size_t length) {
-
- osalDbgCheck(driverp != NULL);
- osalDbgCheck(chunk != NULL);
- osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state");
-
- if (length != 0) {
- palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */
- spiReceive(driverp->config->spi, length, chunk);
- }
-}
-
-#else /* ILI9341_IM == * */
-#error "Only the ILI9341_IM_4LSI_1 interface mode is currently supported"
-#endif /* ILI9341_IM == * */
-
-/** @} */
+/* + Copyright (C) 2013-2015 Andrea Zoppi + + Licensed 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. +*/ + +/** + * @file ili9341.c + * @brief ILI9341 TFT LCD diaplay controller driver. + * @note Does not support multiple calling threads natively. + */ + +#include "ch.h" +#include "hal.h" +#include "ili9341.h" + +/** + * @addtogroup ili9341 + * @{ + */ + +/*===========================================================================*/ +/* Driver local definitions. */ +/*===========================================================================*/ + +#if !ILI9341_USE_CHECKS && !defined(__DOXYGEN__) +/* Disable checks as needed.*/ + +#ifdef osalDbgCheck +#undef osalDbgCheck +#endif +#define osalDbgCheck(c, func) { \ + (void)(c), (void)__QUOTE_THIS(func)"()"; \ +} + +#ifdef osalDbgAssert +#undef osalDbgAssert +#endif +#define osalDbgAssert(c, m, r) { \ + (void)(c); \ +} + +#ifdef osalDbgCheckClassS +#undef osalDbgCheckClassS +#endif +#define osalDbgCheckClassS() {} + +#ifdef osalDbgCheckClassS +#undef osalDbgCheckClassS +#endif +#define osalDbgCheckClassI() {} + +#endif /* ILI9341_USE_CHECKS */ + +/*===========================================================================*/ +/* Driver exported variables. */ +/*===========================================================================*/ + +/** @brief ILI9341D1 driver identifier.*/ +ILI9341Driver ILI9341D1; + +/*===========================================================================*/ +/* Driver local variables and types. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver local functions. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver exported functions. */ +/*===========================================================================*/ + +/** + * @brief Initializes the standard part of a @p ILI9341Driver structure. + * + * @param[out] driverp pointer to the @p ILI9341Driver object + * + * @init + */ +void ili9341ObjectInit(ILI9341Driver *driverp) { + + osalDbgCheck(driverp != NULL); + + driverp->state = ILI9341_STOP; + driverp->config = NULL; +#if (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) +#if (TRUE == CH_CFG_USE_MUTEXES) + chMtxObjectInit(&driverp->lock); +#else + chSemObjectInit(&driverp->lock, 1); +#endif +#endif /* (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) */ +} + +/** + * @brief Configures and activates the ILI9341 peripheral. + * @pre ILI9341 is stopped. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * @param[in] configp pointer to the @p ILI9341Config object + * + * @api + */ +void ili9341Start(ILI9341Driver *driverp, const ILI9341Config *configp) { + + chSysLock(); + osalDbgCheck(driverp != NULL); + osalDbgCheck(configp != NULL); + osalDbgCheck(configp->spi != NULL); + osalDbgAssert(driverp->state == ILI9341_STOP, "invalid state"); + + spiSelectI(configp->spi); + spiUnselectI(configp->spi); + driverp->config = configp; + driverp->state = ILI9341_READY; + chSysUnlock(); +} + +/** + * @brief Deactivates the ILI9341 peripheral. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @api + */ +void ili9341Stop(ILI9341Driver *driverp) { + + chSysLock(); + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_READY, "invalid state"); + + driverp->state = ILI9341_STOP; + chSysUnlock(); +} + +#if ILI9341_USE_MUTUAL_EXCLUSION + +/** + * @brief Gains exclusive access to the ILI9341 module. + * @details This function tries to gain ownership to the ILI9341 module, if the + * module is already being used then the invoking thread is queued. + * @pre In order to use this function the option + * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @sclass + */ +void ili9341AcquireBusS(ILI9341Driver *driverp) { + + osalDbgCheckClassS(); + osalDbgCheck(driverp == &ILI9341D1); + osalDbgAssert(driverp->state == ILI9341_READY, "not ready"); + +#if (TRUE == CH_CFG_USE_MUTEXES) + chMtxLockS(&driverp->lock); +#else + chSemWaitS(&driverp->lock); +#endif +} + +/** + * @brief Gains exclusive access to the ILI9341 module. + * @details This function tries to gain ownership to the ILI9341 module, if the + * module is already being used then the invoking thread is queued. + * @pre In order to use this function the option + * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @api + */ +void ili9341AcquireBus(ILI9341Driver *driverp) { + + chSysLock(); + ili9341AcquireBusS(driverp); + chSysUnlock(); +} + +/** + * @brief Releases exclusive access to the ILI9341 module. + * @pre In order to use this function the option + * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @sclass + */ +void ili9341ReleaseBusS(ILI9341Driver *driverp) { + + osalDbgCheckClassS(); + osalDbgCheck(driverp == &ILI9341D1); + osalDbgAssert(driverp->state == ILI9341_READY, "not ready"); + +#if (TRUE == CH_CFG_USE_MUTEXES) + chMtxUnlockS(&driverp->lock); +#else + chSemSignalI(&driverp->lock); +#endif +} + +/** + * @brief Releases exclusive access to the ILI9341 module. + * @pre In order to use this function the option + * @p ILI9341_USE_MUTUAL_EXCLUSION must be enabled. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @api + */ +void ili9341ReleaseBus(ILI9341Driver *driverp) { + + chSysLock(); + ili9341ReleaseBusS(driverp); + chSysUnlock(); +} + +#endif /* ILI9341_USE_MUTUAL_EXCLUSION */ + +#if ILI9341_IM == ILI9341_IM_4LSI_1 /* 4-wire, half-duplex */ + +/** + * @brief Asserts the slave select signal and prepares for transfers. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @iclass + */ +void ili9341SelectI(ILI9341Driver *driverp) { + + osalDbgCheckClassI(); + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_READY, "invalid state"); + + driverp->state = ILI9341_ACTIVE; + spiSelectI(driverp->config->spi); +} + +/** + * @brief Asserts the slave select signal and prepares for transfers. + * @pre ILI9341 is ready. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @api + */ +void ili9341Select(ILI9341Driver *driverp) { + + chSysLock(); + ili9341SelectI(driverp); + chSysUnlock(); +} + +/** + * @brief Deasserts the slave select signal. + * @details The previously selected peripheral is unselected. + * @pre ILI9341 is active. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @iclass + */ +void ili9341UnselectI(ILI9341Driver *driverp) { + + osalDbgCheckClassI(); + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + spiUnselectI(driverp->config->spi); + driverp->state = ILI9341_READY; +} + +/** + * @brief Deasserts the slave select signal. + * @details The previously selected peripheral is unselected. + * @pre ILI9341 is active. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @iclass + */ +void ili9341Unselect(ILI9341Driver *driverp) { + + chSysLock(); + ili9341UnselectI(driverp); + chSysUnlock(); +} + +/** + * @brief Write command byte. + * @details Sends a command byte via SPI. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * @param[in] cmd command byte + * + * @api + */ +void ili9341WriteCommand(ILI9341Driver *driverp, uint8_t cmd) { + + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + driverp->value = cmd; + palClearPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* !Cmd */ + spiSend(driverp->config->spi, 1, &driverp->value); +} + +/** + * @brief Write data byte. + * @details Sends a data byte via SPI. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * @param[in] value data byte + * + * @api + */ +void ili9341WriteByte(ILI9341Driver *driverp, uint8_t value) { + + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + driverp->value = value; + palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */ + spiSend(driverp->config->spi, 1, &driverp->value); +} + +/** + * @brief Read data byte. + * @details Receives a data byte via SPI. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * + * @return data byte + * + * @api + */ +uint8_t ili9341ReadByte(ILI9341Driver *driverp) { + + osalDbgAssert(FALSE, "should not be used"); + + osalDbgCheck(driverp != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */ + spiReceive(driverp->config->spi, 1, &driverp->value); + return driverp->value; +} + +/** + * @brief Write data chunk. + * @details Sends a data chunk via SPI. + * @pre The chunk must be accessed by DMA. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * @param[in] chunk chunk bytes + * @param[in] length chunk length + * + * @api + */ +void ili9341WriteChunk(ILI9341Driver *driverp, const uint8_t chunk[], + size_t length) { + + osalDbgCheck(driverp != NULL); + osalDbgCheck(chunk != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + if (length != 0) { + palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */ + spiSend(driverp->config->spi, length, chunk); + } +} + +/** + * @brief Read data chunk. + * @details Receives a data chunk via SPI. + * @pre The chunk must be accessed by DMA. + * + * @param[in] driverp pointer to the @p ILI9341Driver object + * @param[out] chunk chunk bytes + * @param[in] length chunk length + * + * @api + */ +void ili9341ReadChunk(ILI9341Driver *driverp, uint8_t chunk[], + size_t length) { + + osalDbgCheck(driverp != NULL); + osalDbgCheck(chunk != NULL); + osalDbgAssert(driverp->state == ILI9341_ACTIVE, "invalid state"); + + if (length != 0) { + palSetPad(driverp->config->dcx_port, driverp->config->dcx_pad); /* Data */ + spiReceive(driverp->config->spi, length, chunk); + } +} + +#else /* ILI9341_IM == * */ +#error "Only the ILI9341_IM_4LSI_1 interface mode is currently supported" +#endif /* ILI9341_IM == * */ + +/** @} */ diff --git a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.h b/os/various/devices_lib/others/ili9341.h index 3e34772..007c4fd 100644 --- a/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/ili9341.h +++ b/os/various/devices_lib/others/ili9341.h @@ -1,593 +1,593 @@ -/*
- Copyright (C) 2013-2015 Andrea Zoppi
-
- Licensed 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.
-*/
-
-/**
- * @file ili9341.h
- * @brief ILI9341 TFT LCD diaplay controller driver.
- */
-
-#ifndef _ILI9341_H_
-#define _ILI9341_H_
-
-/**
- * @addtogroup ili9341
- * @{
- */
-
-/*===========================================================================*/
-/* Driver constants. */
-/*===========================================================================*/
-
-/**
- * @name ILI9341 regulative commands
- * @{
- */
-#define ILI9341_CMD_NOP (0x00) /**< No operation.*/
-#define ILI9341_CMD_RESET (0x01) /**< Software reset.*/
-#define ILI9341_GET_ID_INFO (0x04) /**< Get ID information.*/
-#define ILI9341_GET_STATUS (0x09) /**< Get status.*/
-#define ILI9341_GET_PWR_MODE (0x0A) /**< Get power mode.*/
-#define ILI9341_GET_MADCTL (0x0B) /**< Get MADCTL.*/
-#define ILI9341_GET_PIX_FMT (0x0C) /**< Get pixel format.*/
-#define ILI9341_GET_IMG_FMT (0x0D) /**< Get image format.*/
-#define ILI9341_GET_SIG_MODE (0x0E) /**< Get signal mode.*/
-#define ILI9341_GET_SELF_DIAG (0x0F) /**< Get self-diagnostics.*/
-#define ILI9341_CMD_SLEEP_ON (0x10) /**< Enter sleep mode.*/
-#define ILI9341_CMD_SLEEP_OFF (0x11) /**< Exist sleep mode.*/
-#define ILI9341_CMD_PARTIAL_ON (0x12) /**< Enter partial mode.*/
-#define ILI9341_CMD_PARTIAL_OFF (0x13) /**< Exit partial mode.*/
-#define ILI9341_CMD_INVERT_ON (0x20) /**< Enter inverted mode.*/
-#define ILI9341_CMD_INVERT_OFF (0x21) /**< Exit inverted mode.*/
-#define ILI9341_SET_GAMMA (0x26) /**< Set gamma params.*/
-#define ILI9341_CMD_DISPLAY_OFF (0x28) /**< Disable display.*/
-#define ILI9341_CMD_DISPLAY_ON (0x29) /**< Enable display.*/
-#define ILI9341_SET_COL_ADDR (0x2A) /**< Set column address.*/
-#define ILI9341_SET_PAGE_ADDR (0x2B) /**< Set page address.*/
-#define ILI9341_SET_MEM (0x2C) /**< Set memory.*/
-#define ILI9341_SET_COLOR (0x2D) /**< Set color.*/
-#define ILI9341_GET_MEM (0x2E) /**< Get memory.*/
-#define ILI9341_SET_PARTIAL_AREA (0x30) /**< Set partial area.*/
-#define ILI9341_SET_VSCROLL (0x33) /**< Set vertical scroll def.*/
-#define ILI9341_CMD_TEARING_ON (0x34) /**< Tearing line enabled.*/
-#define ILI9341_CMD_TEARING_OFF (0x35) /**< Tearing line disabled.*/
-#define ILI9341_SET_MEM_ACS_CTL (0x36) /**< Set mem access ctl.*/
-#define ILI9341_SET_VSCROLL_ADDR (0x37) /**< Set vscroll start addr.*/
-#define ILI9341_CMD_IDLE_OFF (0x38) /**< Exit idle mode.*/
-#define ILI9341_CMD_IDLE_ON (0x39) /**< Enter idle mode.*/
-#define ILI9341_SET_PIX_FMT (0x3A) /**< Set pixel format.*/
-#define ILI9341_SET_MEM_CONT (0x3C) /**< Set memory continue.*/
-#define ILI9341_GET_MEM_CONT (0x3E) /**< Get memory continue.*/
-#define ILI9341_SET_TEAR_SCANLINE (0x44) /**< Set tearing scanline.*/
-#define ILI9341_GET_TEAR_SCANLINE (0x45) /**< Get tearing scanline.*/
-#define ILI9341_SET_BRIGHTNESS (0x51) /**< Set brightness.*/
-#define ILI9341_GET_BRIGHTNESS (0x52) /**< Get brightness.*/
-#define ILI9341_SET_DISPLAY_CTL (0x53) /**< Set display ctl.*/
-#define ILI9341_GET_DISPLAY_CTL (0x54) /**< Get display ctl.*/
-#define ILI9341_SET_CABC (0x55) /**< Set CABC.*/
-#define ILI9341_GET_CABC (0x56) /**< Get CABC.*/
-#define ILI9341_SET_CABC_MIN (0x5E) /**< Set CABC min.*/
-#define ILI9341_GET_CABC_MIN (0x5F) /**< Set CABC max.*/
-#define ILI9341_GET_ID1 (0xDA) /**< Get ID1.*/
-#define ILI9341_GET_ID2 (0xDB) /**< Get ID2.*/
-#define ILI9341_GET_ID3 (0xDC) /**< Get ID3.*/
-/** @} */
-
-/**
- * @name ILI9341 extended commands
- * @{
- */
-#define ILI9341_SET_RGB_IF_SIG_CTL (0xB0) /**< RGB IF signal ctl.*/
-#define ILI9341_SET_FRAME_CTL_NORMAL (0xB1) /**< Set frame ctl (normal).*/
-#define ILI9341_SET_FRAME_CTL_IDLE (0xB2) /**< Set frame ctl (idle).*/
-#define ILI9341_SET_FRAME_CTL_PARTIAL (0xB3) /**< Set frame ctl (partial).*/
-#define ILI9341_SET_INVERSION_CTL (0xB4) /**< Set inversion ctl.*/
-#define ILI9341_SET_BLANKING_PORCH_CTL (0xB5) /**< Set blanking porch ctl.*/
-#define ILI9341_SET_FUNCTION_CTL (0xB6) /**< Set function ctl.*/
-#define ILI9341_SET_ENTRY_MODE (0xB7) /**< Set entry mode.*/
-#define ILI9341_SET_LIGHT_CTL_1 (0xB8) /**< Set backlight ctl 1.*/
-#define ILI9341_SET_LIGHT_CTL_2 (0xB9) /**< Set backlight ctl 2.*/
-#define ILI9341_SET_LIGHT_CTL_3 (0xBA) /**< Set backlight ctl 3.*/
-#define ILI9341_SET_LIGHT_CTL_4 (0xBB) /**< Set backlight ctl 4.*/
-#define ILI9341_SET_LIGHT_CTL_5 (0xBC) /**< Set backlight ctl 5.*/
-#define ILI9341_SET_LIGHT_CTL_7 (0xBE) /**< Set backlight ctl 7.*/
-#define ILI9341_SET_LIGHT_CTL_8 (0xBF) /**< Set backlight ctl 8.*/
-#define ILI9341_SET_POWER_CTL_1 (0xC0) /**< Set power ctl 1.*/
-#define ILI9341_SET_POWER_CTL_2 (0xC1) /**< Set power ctl 2.*/
-#define ILI9341_SET_VCOM_CTL_1 (0xC5) /**< Set VCOM ctl 1.*/
-#define ILI9341_SET_VCOM_CTL_2 (0xC6) /**< Set VCOM ctl 2.*/
-#define ILI9341_SET_NVMEM (0xD0) /**< Set NVMEM data.*/
-#define ILI9341_GET_NVMEM_KEY (0xD1) /**< Get NVMEM protect key.*/
-#define ILI9341_GET_NVMEM_STATUS (0xD2) /**< Get NVMEM status.*/
-#define ILI9341_GET_ID4 (0xD3) /**< Get ID4.*/
-#define ILI9341_SET_PGAMMA (0xE0) /**< Set positive gamma.*/
-#define ILI9341_SET_NGAMMA (0xE1) /**< Set negative gamma.*/
-#define ILI9341_SET_DGAMMA_CTL_1 (0xE2) /**< Set digital gamma ctl 1.*/
-#define ILI9341_SET_DGAMMA_CTL_2 (0xE3) /**< Set digital gamma ctl 2.*/
-#define ILI9341_SET_IF_CTL (0xF6) /**< Set interface control.*/
-/** @} */
-
-/**
- * @name ILI9341 interface modes
- * @{
- */
-#define ILI9341_IM_3LSI_1 (0x5) /**< 3-line serial, mode 1.*/
-#define ILI9341_IM_3LSI_2 (0xD) /**< 3-line serial, mode 2.*/
-#define ILI9341_IM_4LSI_1 (0x6) /**< 4-line serial, mode 1.*/
-#define ILI9341_IM_4LSI_2 (0xE) /**< 4-line serial, mode 2.*/
-/** @} */
-
-/*===========================================================================*/
-/* Driver pre-compile time settings. */
-/*===========================================================================*/
-
-/**
- * @name ILI9341 configuration options
- * @{
- */
-
-/**
- * @brief Enables the @p ili9341AcquireBus() and @p ili9341ReleaseBus() APIs.
- * @note Disabling this option saves both code and data space.
- */
-#if !defined(ILI9341_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)
-#define ILI9341_USE_MUTUAL_EXCLUSION TRUE
-#endif
-
-/**
- * @brief ILI9341 Interface Mode.
- */
-#if !defined(ILI9341_IM) || defined(__DOXYGEN__)
-#define ILI9341_IM (ILI9341_IM_4LSI_1)
-#endif
-
-/**
- * @brief Enables checks for ILI9341 functions.
- * @note Disabling this option saves both code and data space.
- * @note Disabling checks by ChibiOS will automatically disable ILI9341
- * checks.
- */
-#if !defined(ILI9341_USE_CHECKS) || defined(__DOXYGEN__)
-#define ILI9341_USE_CHECKS TRUE
-#endif
-
-/** @} */
-
-/*===========================================================================*/
-/* Derived constants and error checks. */
-/*===========================================================================*/
-
-#if ((TRUE == ILI9341_USE_MUTUAL_EXCLUSION) && \
- (TRUE != CH_CFG_USE_MUTEXES) && \
- (TRUE != CH_CFG_USE_SEMAPHORES))
-#error "ILI9341_USE_MUTUAL_EXCLUSION requires CH_CFG_USE_MUTEXES and/or CH_CFG_USE_SEMAPHORES"
-#endif
-
-/* TODO: Add the remaining modes.*/
-#if (ILI9341_IM != ILI9341_IM_4LSI_1)
-#error "Only ILI9341_IM_4LSI_1 interface mode is supported currently"
-#endif
-
-/*===========================================================================*/
-/* Driver data structures and types. */
-/*===========================================================================*/
-
-/* Complex types forwarding.*/
-typedef struct ILI9341Config ILI9341Config;
-typedef enum ili9341state_t ili9341state_t;
-typedef struct ILI9341Driver ILI9341Driver;
-
-/**
- * @brief ILI9341 driver configuration.
- */
-typedef struct ILI9341Config {
- SPIDriver *spi; /**< SPI driver used by ILI9341.*/
-#if (ILI9341_IM == ILI9341_IM_4LSI_1)
- ioportid_t dcx_port; /**< <tt>D/!C</tt> signal port.*/
- uint16_t dcx_pad; /**< <tt>D/!C</tt> signal pad.*/
-#endif /* ILI9341_IM == * */ /* TODO: Add all modes.*/
-} ILI9341Config;
-
-/**
- * @brief ILI9341 driver state.
- */
-typedef enum ili9341state_t {
- ILI9341_UNINIT = (0), /**< Not initialized.*/
- ILI9341_STOP = (1), /**< Stopped.*/
- ILI9341_READY = (2), /**< Ready.*/
- ILI9341_ACTIVE = (3), /**< Exchanging data.*/
-} ili9341state_t;
-
-/**
- * @brief ILI9341 driver.
- */
-typedef struct ILI9341Driver {
- ili9341state_t state; /**< Driver state.*/
- const ILI9341Config *config; /**< Driver configuration.*/
-
- /* Multithreading stuff.*/
-#if (TRUE == ILI9341_USE_MUTUAL_EXCLUSION)
-#if (TRUE == CH_CFG_USE_MUTEXES)
- mutex_t lock; /**< Multithreading lock.*/
-#elif (TRUE == CH_CFG_USE_SEMAPHORES)
- semaphore_t lock; /**< Multithreading lock.*/
-#endif
-#endif /* (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) */
-
- /* Temporary variables.*/
- uint8_t value; /**< Non-stacked value, for SPI with CCM.*/
-} ILI9341Driver;
-
-/**
- * @name ILI9341 command params (little endian)
- * @{
- */
-#pragma pack(push, 1)
-
-typedef union {
- struct ILI9341ParamBits_GET_ID_INFO {
- uint8_t reserved_;
- uint8_t ID1;
- uint8_t ID2;
- uint8_t ID3;
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_GET_ID_INFO;
-
-typedef union {
- struct ILI9341ParamBits_GET_STATUS {
- unsigned _reserved_1 : 5; /* D[ 4: 0] */
- unsigned tearing_mode : 1; /* D[ 5] */
- unsigned gamma_curve : 3; /* D[ 8: 6] */
- unsigned tearing : 1; /* D[ 9] */
- unsigned display : 1; /* D[10] */
- unsigned all_on : 1; /* D[11] */
- unsigned all_off : 1; /* D[12] */
- unsigned invert : 1; /* D[13] */
- unsigned _reserved_2 : 1; /* D[14] */
- unsigned vscroll : 1; /* D[15] */
- unsigned normal : 1; /* D[16] */
- unsigned sleep : 1; /* D[17] */
- unsigned partial : 1; /* D[18] */
- unsigned idle : 1; /* D[19] */
- unsigned pixel_format : 3; /* D[22:20] */
- unsigned _reserved_3 : 2; /* D[24:23] */
- unsigned hrefr_rtl_nltr : 1; /* D[25] */
- unsigned bgr_nrgb : 1; /* D[26] */
- unsigned vrefr_btt_nttb : 1; /* D[27] */
- unsigned transpose : 1; /* D[28] */
- unsigned coladr_rtl_nltr : 1; /* D[29] */
- unsigned rowadr_btt_nttb : 1; /* D[30] */
- unsigned booster : 1; /* D[31] */
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_GET_STATUS;
-
-typedef union {
- struct ILI9341ParamBits_GET_PWR_MODE {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned display : 1; /* D[2] */
- unsigned normal : 1; /* D[3] */
- unsigned sleep : 1; /* D[4] */
- unsigned partial : 1; /* D[5] */
- unsigned idle : 1; /* D[6] */
- unsigned booster : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_PWR_MODE;
-
-typedef union {
- struct ILI9341ParamBits_GET_MADCTL {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned refr_rtl_nltr : 1; /* D[2] */
- unsigned bgr_nrgb : 1; /* D[3] */
- unsigned refr_btt_nttb : 1; /* D[4] */
- unsigned invert : 1; /* D[5] */
- unsigned rtl_nltr : 1; /* D[6] */
- unsigned btt_nttb : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_MADCTL;
-
-typedef union {
- struct ILI9341ParamBits_GET_PIX_FMT {
- unsigned DBI : 3; /* D[2:0] */
- unsigned _reserved_1 : 1; /* D[3] */
- unsigned DPI : 3; /* D[6:4] */
- unsigned RIM : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_PIX_FMT;
-
-typedef union {
- struct ILI9341ParamBits_GET_IMG_FMT {
- unsigned gamma_curve : 3; /* D[2:0] */
- unsigned _reserved_1 : 5; /* D[7:3] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_IMG_FMT;
-
-typedef union {
- struct ILI9341ParamBits_GET_SIG_MODE {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned data_enable : 1; /* D[2] */
- unsigned pixel_clock : 1; /* D[3] */
- unsigned vsync : 1; /* D[4] */
- unsigned hsync : 1; /* D[5] */
- unsigned tearing_mode : 1; /* D[6] */
- unsigned tearing : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_SIG_MODE;
-
-typedef union {
- struct ILI9341ParamBits_GET_SELF_DIAG {
- unsigned _reserved_1 : 6; /* D[5:0] */
- unsigned func_err : 1; /* D[6] */
- unsigned reg_err : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_SELF_DIAG;
-
-typedef union {
- struct ILI9341ParamBits_SET_GAMMA {
- uint8_t gamma_curve; /* D[7:0] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_GAMMA;
-
-typedef union {
- struct ILI9341ParamBits_SET_COL_ADDR {
- uint8_t SC_15_8; /* D[ 7: 0] */
- uint8_t SC_7_0; /* D[15: 8] */
- uint8_t EC_15_8; /* D[23:16] */
- uint8_t EC_7_0; /* D[31:24] */
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_SET_COL_ADDR;
-
-typedef union {
- struct ILI9341ParamBits_SET_PAGE_ADDR {
- uint8_t SP_15_8; /* D[ 7: 0] */
- uint8_t SP_7_0; /* D[15: 8] */
- uint8_t EP_15_8; /* D[23:16] */
- uint8_t EP_7_0; /* D[31:24] */
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_SET_PAGE_ADDR;
-
-typedef union {
- struct ILI9341ParamBits_SET_PARTIAL_AREA {
- uint8_t SR_15_8; /* D[ 7: 0] */
- uint8_t SR_7_0; /* D[15: 8] */
- uint8_t ER_15_8; /* D[23:16] */
- uint8_t ER_7_0; /* D[31:24] */
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_SET_PARTIAL_AREA;
-
-typedef union {
- struct ILI9341ParamBits_SET_VSCROLL {
- uint8_t TFA_15_8; /* D[ 7: 0] */
- uint8_t TFA_7_0; /* D[15: 8] */
- uint8_t VSA_15_8; /* D[23:16] */
- uint8_t VSA_7_0; /* D[31:24] */
- uint8_t BFA_15_8; /* D[39:32] */
- uint8_t BFA_7_0; /* D[47:40] */
- } bits;
- uint8_t bytes[6];
-} ILI9341Params_SET_VSCROLL;
-
-typedef union {
- struct ILI9341ParamBits_CMD_TEARING_ON {
- unsigned M : 1; /* D[0] */
- unsigned _reserved_1 : 7; /* D[7:1] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_CMD_TEARING_ON;
-
-typedef union {
- struct ILI9341ParamBits_SET_MEM_ACS_CTL {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned MH : 1; /* D[2] */
- unsigned BGR : 1; /* D[3] */
- unsigned ML : 1; /* D[4] */
- unsigned MV : 1; /* D[5] */
- unsigned MX : 1; /* D[6] */
- unsigned MY : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_MEM_ACS_CTL;
-
-typedef union {
- struct ILI9341ParamBits_SET_VSCROLL_ADDR {
- uint8_t VSP_15_8; /* D[ 7: 0] */
- uint8_t VSP_7_0; /* D[15: 8] */
- } bits;
- uint8_t bytes[2];
-} ILI9341Params_SET_VSCROLL_ADDR;
-
-typedef union {
- struct ILI9341ParamBits_SET_PIX_FMT {
- unsigned DBI : 3; /* D[2:0] */
- unsigned _reserved_1 : 1; /* D[3] */
- unsigned DPI : 3; /* D[4:6] */
- unsigned _reserved_2 : 1; /* D[7] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_PIX_FMT;
-
-typedef union {
- struct ILI9341ParamBits_SET_TEAR_SCANLINE {
- uint8_t STS_8; /* D[ 7: 0] */
- uint8_t STS_7_0; /* D[15: 8] */
- } bits;
- uint8_t bytes[4];
-} ILI9341Params_SET_TEAR_SCANLINE;
-
-typedef union {
- struct ILI9341ParamBits_GET_TEAR_SCANLINE {
- uint8_t GTS_9_8; /* D[ 7: 0] */
- uint8_t GTS_7_0; /* D[15: 8] */
- } bits;
- uint8_t bytes[2];
-} ILI9341Params_GET_TEAR_SCANLINE;
-
-typedef union {
- struct ILI9341ParamBits_SET_BRIGHTNESS {
- uint8_t DBV; /* D[7:0] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_BRIGHTNESS;
-
-typedef union {
- struct ILI9341ParamBits_GET_BRIGHTNESS {
- uint8_t DBV; /* D[7:0] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_BRIGHTNESS;
-
-typedef union {
- struct ILI9341ParamBits_SET_DISPLAY_CTL {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned BL : 1; /* D[2] */
- unsigned DD : 1; /* D[3] */
- unsigned _reserved_2 : 1; /* D[4] */
- unsigned BCTRL : 1; /* D[5] */
- unsigned _reserved_3 : 1; /* D[7:6] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_DISPLAY_CTL;
-
-typedef union {
- struct ILI9341ParamBits_GET_DISPLAY_CTL {
- unsigned _reserved_1 : 2; /* D[1:0] */
- unsigned BL : 1; /* D[2] */
- unsigned DD : 1; /* D[3] */
- unsigned _reserved_2 : 1; /* D[4] */
- unsigned BCTRL : 1; /* D[5] */
- unsigned _reserved_3 : 1; /* D[7:6] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_DISPLAY_CTL;
-
-typedef union {
- struct ILI9341ParamBits_SET_CABC {
- unsigned C : 2; /* D[1:0] */
- unsigned _reserved_1 : 6; /* D[7:2] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_CABC;
-
-typedef union {
- struct ILI9341ParamBits_GET_CABC {
- unsigned C : 2; /* D[1:0] */
- unsigned _reserved_1 : 6; /* D[7:2] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_CABC;
-
-typedef union {
- struct ILI9341ParamBits_SET_CABC_MIN {
- uint8_t CMB; /* D[7:0] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_SET_CABC_MIN;
-
-typedef union {
- struct ILI9341ParamBits_GET_CABC_MIN {
- uint8_t CMB; /* D[7:0] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_GET_CABC_MIN;
-
-#if 0 /* TODO: Extended command structs.*/
-
-typedef union {
- struct ILI9341ParamBits {
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_;
-
-typedef union {
- struct ILI9341ParamBits {
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- unsigned : 1; /* D[] */
- } bits;
- uint8_t bytes[1];
-} ILI9341Params_;
-
-#endif /*0*/
-
-#pragma pack(pop)
-
-/** @} */
-
-/*===========================================================================*/
-/* Driver macros. */
-/*===========================================================================*/
-
-/*===========================================================================*/
-/* External declarations. */
-/*===========================================================================*/
-
-extern ILI9341Driver ILI9341D1;
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
- void ili9341ObjectInit(ILI9341Driver *driverp);
- void ili9341Start(ILI9341Driver *driverp, const ILI9341Config *configp);
- void ili9341Stop(ILI9341Driver *driverp);
-#if (ILI9341_USE_MUTUAL_EXCLUSION == TRUE)
- void ili9341AcquireBusS(ILI9341Driver *driverp);
- void ili9341AcquireBus(ILI9341Driver *driverp);
- void ili9341ReleaseBusS(ILI9341Driver *driverp);
- void ili9341ReleaseBus(ILI9341Driver *driverp);
-#endif /* (ILI9341_USE_MUTUAL_EXCLUSION == TRUE) */
- void ili9341SelectI(ILI9341Driver *driverp);
- void ili9341Select(ILI9341Driver *driverp);
- void ili9341UnselectI(ILI9341Driver *driverp);
- void ili9341Unselect(ILI9341Driver *driverp);
- void ili9341WriteCommand(ILI9341Driver *driverp, uint8_t cmd);
- void ili9341WriteByte(ILI9341Driver *driverp, uint8_t value);
- uint8_t ili9341ReadByte(ILI9341Driver *driverp);
- void ili9341WriteChunk(ILI9341Driver *driverp, const uint8_t chunk[],
- size_t length);
- void ili9341ReadChunk(ILI9341Driver *driverp, uint8_t chunk[],
- size_t length);
-
-#ifdef __cplusplus
-}
-#endif
-
-/** @} */
-
-#endif /* _ILI9341_H_ */
+/* + Copyright (C) 2013-2015 Andrea Zoppi + + Licensed 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. +*/ + +/** + * @file ili9341.h + * @brief ILI9341 TFT LCD diaplay controller driver. + */ + +#ifndef _ILI9341_H_ +#define _ILI9341_H_ + +/** + * @addtogroup ili9341 + * @{ + */ + +/*===========================================================================*/ +/* Driver constants. */ +/*===========================================================================*/ + +/** + * @name ILI9341 regulative commands + * @{ + */ +#define ILI9341_CMD_NOP (0x00) /**< No operation.*/ +#define ILI9341_CMD_RESET (0x01) /**< Software reset.*/ +#define ILI9341_GET_ID_INFO (0x04) /**< Get ID information.*/ +#define ILI9341_GET_STATUS (0x09) /**< Get status.*/ +#define ILI9341_GET_PWR_MODE (0x0A) /**< Get power mode.*/ +#define ILI9341_GET_MADCTL (0x0B) /**< Get MADCTL.*/ +#define ILI9341_GET_PIX_FMT (0x0C) /**< Get pixel format.*/ +#define ILI9341_GET_IMG_FMT (0x0D) /**< Get image format.*/ +#define ILI9341_GET_SIG_MODE (0x0E) /**< Get signal mode.*/ +#define ILI9341_GET_SELF_DIAG (0x0F) /**< Get self-diagnostics.*/ +#define ILI9341_CMD_SLEEP_ON (0x10) /**< Enter sleep mode.*/ +#define ILI9341_CMD_SLEEP_OFF (0x11) /**< Exist sleep mode.*/ +#define ILI9341_CMD_PARTIAL_ON (0x12) /**< Enter partial mode.*/ +#define ILI9341_CMD_PARTIAL_OFF (0x13) /**< Exit partial mode.*/ +#define ILI9341_CMD_INVERT_ON (0x20) /**< Enter inverted mode.*/ +#define ILI9341_CMD_INVERT_OFF (0x21) /**< Exit inverted mode.*/ +#define ILI9341_SET_GAMMA (0x26) /**< Set gamma params.*/ +#define ILI9341_CMD_DISPLAY_OFF (0x28) /**< Disable display.*/ +#define ILI9341_CMD_DISPLAY_ON (0x29) /**< Enable display.*/ +#define ILI9341_SET_COL_ADDR (0x2A) /**< Set column address.*/ +#define ILI9341_SET_PAGE_ADDR (0x2B) /**< Set page address.*/ +#define ILI9341_SET_MEM (0x2C) /**< Set memory.*/ +#define ILI9341_SET_COLOR (0x2D) /**< Set color.*/ +#define ILI9341_GET_MEM (0x2E) /**< Get memory.*/ +#define ILI9341_SET_PARTIAL_AREA (0x30) /**< Set partial area.*/ +#define ILI9341_SET_VSCROLL (0x33) /**< Set vertical scroll def.*/ +#define ILI9341_CMD_TEARING_ON (0x34) /**< Tearing line enabled.*/ +#define ILI9341_CMD_TEARING_OFF (0x35) /**< Tearing line disabled.*/ +#define ILI9341_SET_MEM_ACS_CTL (0x36) /**< Set mem access ctl.*/ +#define ILI9341_SET_VSCROLL_ADDR (0x37) /**< Set vscroll start addr.*/ +#define ILI9341_CMD_IDLE_OFF (0x38) /**< Exit idle mode.*/ +#define ILI9341_CMD_IDLE_ON (0x39) /**< Enter idle mode.*/ +#define ILI9341_SET_PIX_FMT (0x3A) /**< Set pixel format.*/ +#define ILI9341_SET_MEM_CONT (0x3C) /**< Set memory continue.*/ +#define ILI9341_GET_MEM_CONT (0x3E) /**< Get memory continue.*/ +#define ILI9341_SET_TEAR_SCANLINE (0x44) /**< Set tearing scanline.*/ +#define ILI9341_GET_TEAR_SCANLINE (0x45) /**< Get tearing scanline.*/ +#define ILI9341_SET_BRIGHTNESS (0x51) /**< Set brightness.*/ +#define ILI9341_GET_BRIGHTNESS (0x52) /**< Get brightness.*/ +#define ILI9341_SET_DISPLAY_CTL (0x53) /**< Set display ctl.*/ +#define ILI9341_GET_DISPLAY_CTL (0x54) /**< Get display ctl.*/ +#define ILI9341_SET_CABC (0x55) /**< Set CABC.*/ +#define ILI9341_GET_CABC (0x56) /**< Get CABC.*/ +#define ILI9341_SET_CABC_MIN (0x5E) /**< Set CABC min.*/ +#define ILI9341_GET_CABC_MIN (0x5F) /**< Set CABC max.*/ +#define ILI9341_GET_ID1 (0xDA) /**< Get ID1.*/ +#define ILI9341_GET_ID2 (0xDB) /**< Get ID2.*/ +#define ILI9341_GET_ID3 (0xDC) /**< Get ID3.*/ +/** @} */ + +/** + * @name ILI9341 extended commands + * @{ + */ +#define ILI9341_SET_RGB_IF_SIG_CTL (0xB0) /**< RGB IF signal ctl.*/ +#define ILI9341_SET_FRAME_CTL_NORMAL (0xB1) /**< Set frame ctl (normal).*/ +#define ILI9341_SET_FRAME_CTL_IDLE (0xB2) /**< Set frame ctl (idle).*/ +#define ILI9341_SET_FRAME_CTL_PARTIAL (0xB3) /**< Set frame ctl (partial).*/ +#define ILI9341_SET_INVERSION_CTL (0xB4) /**< Set inversion ctl.*/ +#define ILI9341_SET_BLANKING_PORCH_CTL (0xB5) /**< Set blanking porch ctl.*/ +#define ILI9341_SET_FUNCTION_CTL (0xB6) /**< Set function ctl.*/ +#define ILI9341_SET_ENTRY_MODE (0xB7) /**< Set entry mode.*/ +#define ILI9341_SET_LIGHT_CTL_1 (0xB8) /**< Set backlight ctl 1.*/ +#define ILI9341_SET_LIGHT_CTL_2 (0xB9) /**< Set backlight ctl 2.*/ +#define ILI9341_SET_LIGHT_CTL_3 (0xBA) /**< Set backlight ctl 3.*/ +#define ILI9341_SET_LIGHT_CTL_4 (0xBB) /**< Set backlight ctl 4.*/ +#define ILI9341_SET_LIGHT_CTL_5 (0xBC) /**< Set backlight ctl 5.*/ +#define ILI9341_SET_LIGHT_CTL_7 (0xBE) /**< Set backlight ctl 7.*/ +#define ILI9341_SET_LIGHT_CTL_8 (0xBF) /**< Set backlight ctl 8.*/ +#define ILI9341_SET_POWER_CTL_1 (0xC0) /**< Set power ctl 1.*/ +#define ILI9341_SET_POWER_CTL_2 (0xC1) /**< Set power ctl 2.*/ +#define ILI9341_SET_VCOM_CTL_1 (0xC5) /**< Set VCOM ctl 1.*/ +#define ILI9341_SET_VCOM_CTL_2 (0xC6) /**< Set VCOM ctl 2.*/ +#define ILI9341_SET_NVMEM (0xD0) /**< Set NVMEM data.*/ +#define ILI9341_GET_NVMEM_KEY (0xD1) /**< Get NVMEM protect key.*/ +#define ILI9341_GET_NVMEM_STATUS (0xD2) /**< Get NVMEM status.*/ +#define ILI9341_GET_ID4 (0xD3) /**< Get ID4.*/ +#define ILI9341_SET_PGAMMA (0xE0) /**< Set positive gamma.*/ +#define ILI9341_SET_NGAMMA (0xE1) /**< Set negative gamma.*/ +#define ILI9341_SET_DGAMMA_CTL_1 (0xE2) /**< Set digital gamma ctl 1.*/ +#define ILI9341_SET_DGAMMA_CTL_2 (0xE3) /**< Set digital gamma ctl 2.*/ +#define ILI9341_SET_IF_CTL (0xF6) /**< Set interface control.*/ +/** @} */ + +/** + * @name ILI9341 interface modes + * @{ + */ +#define ILI9341_IM_3LSI_1 (0x5) /**< 3-line serial, mode 1.*/ +#define ILI9341_IM_3LSI_2 (0xD) /**< 3-line serial, mode 2.*/ +#define ILI9341_IM_4LSI_1 (0x6) /**< 4-line serial, mode 1.*/ +#define ILI9341_IM_4LSI_2 (0xE) /**< 4-line serial, mode 2.*/ +/** @} */ + +/*===========================================================================*/ +/* Driver pre-compile time settings. */ +/*===========================================================================*/ + +/** + * @name ILI9341 configuration options + * @{ + */ + +/** + * @brief Enables the @p ili9341AcquireBus() and @p ili9341ReleaseBus() APIs. + * @note Disabling this option saves both code and data space. + */ +#if !defined(ILI9341_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__) +#define ILI9341_USE_MUTUAL_EXCLUSION TRUE +#endif + +/** + * @brief ILI9341 Interface Mode. + */ +#if !defined(ILI9341_IM) || defined(__DOXYGEN__) +#define ILI9341_IM (ILI9341_IM_4LSI_1) +#endif + +/** + * @brief Enables checks for ILI9341 functions. + * @note Disabling this option saves both code and data space. + * @note Disabling checks by ChibiOS will automatically disable ILI9341 + * checks. + */ +#if !defined(ILI9341_USE_CHECKS) || defined(__DOXYGEN__) +#define ILI9341_USE_CHECKS TRUE +#endif + +/** @} */ + +/*===========================================================================*/ +/* Derived constants and error checks. */ +/*===========================================================================*/ + +#if ((TRUE == ILI9341_USE_MUTUAL_EXCLUSION) && \ + (TRUE != CH_CFG_USE_MUTEXES) && \ + (TRUE != CH_CFG_USE_SEMAPHORES)) +#error "ILI9341_USE_MUTUAL_EXCLUSION requires CH_CFG_USE_MUTEXES and/or CH_CFG_USE_SEMAPHORES" +#endif + +/* TODO: Add the remaining modes.*/ +#if (ILI9341_IM != ILI9341_IM_4LSI_1) +#error "Only ILI9341_IM_4LSI_1 interface mode is supported currently" +#endif + +/*===========================================================================*/ +/* Driver data structures and types. */ +/*===========================================================================*/ + +/* Complex types forwarding.*/ +typedef struct ILI9341Config ILI9341Config; +typedef enum ili9341state_t ili9341state_t; +typedef struct ILI9341Driver ILI9341Driver; + +/** + * @brief ILI9341 driver configuration. + */ +typedef struct ILI9341Config { + SPIDriver *spi; /**< SPI driver used by ILI9341.*/ +#if (ILI9341_IM == ILI9341_IM_4LSI_1) + ioportid_t dcx_port; /**< <tt>D/!C</tt> signal port.*/ + uint16_t dcx_pad; /**< <tt>D/!C</tt> signal pad.*/ +#endif /* ILI9341_IM == * */ /* TODO: Add all modes.*/ +} ILI9341Config; + +/** + * @brief ILI9341 driver state. + */ +typedef enum ili9341state_t { + ILI9341_UNINIT = (0), /**< Not initialized.*/ + ILI9341_STOP = (1), /**< Stopped.*/ + ILI9341_READY = (2), /**< Ready.*/ + ILI9341_ACTIVE = (3), /**< Exchanging data.*/ +} ili9341state_t; + +/** + * @brief ILI9341 driver. + */ +typedef struct ILI9341Driver { + ili9341state_t state; /**< Driver state.*/ + const ILI9341Config *config; /**< Driver configuration.*/ + + /* Multithreading stuff.*/ +#if (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) +#if (TRUE == CH_CFG_USE_MUTEXES) + mutex_t lock; /**< Multithreading lock.*/ +#elif (TRUE == CH_CFG_USE_SEMAPHORES) + semaphore_t lock; /**< Multithreading lock.*/ +#endif +#endif /* (TRUE == ILI9341_USE_MUTUAL_EXCLUSION) */ + + /* Temporary variables.*/ + uint8_t value; /**< Non-stacked value, for SPI with CCM.*/ +} ILI9341Driver; + +/** + * @name ILI9341 command params (little endian) + * @{ + */ +#pragma pack(push, 1) + +typedef union { + struct ILI9341ParamBits_GET_ID_INFO { + uint8_t reserved_; + uint8_t ID1; + uint8_t ID2; + uint8_t ID3; + } bits; + uint8_t bytes[4]; +} ILI9341Params_GET_ID_INFO; + +typedef union { + struct ILI9341ParamBits_GET_STATUS { + unsigned _reserved_1 : 5; /* D[ 4: 0] */ + unsigned tearing_mode : 1; /* D[ 5] */ + unsigned gamma_curve : 3; /* D[ 8: 6] */ + unsigned tearing : 1; /* D[ 9] */ + unsigned display : 1; /* D[10] */ + unsigned all_on : 1; /* D[11] */ + unsigned all_off : 1; /* D[12] */ + unsigned invert : 1; /* D[13] */ + unsigned _reserved_2 : 1; /* D[14] */ + unsigned vscroll : 1; /* D[15] */ + unsigned normal : 1; /* D[16] */ + unsigned sleep : 1; /* D[17] */ + unsigned partial : 1; /* D[18] */ + unsigned idle : 1; /* D[19] */ + unsigned pixel_format : 3; /* D[22:20] */ + unsigned _reserved_3 : 2; /* D[24:23] */ + unsigned hrefr_rtl_nltr : 1; /* D[25] */ + unsigned bgr_nrgb : 1; /* D[26] */ + unsigned vrefr_btt_nttb : 1; /* D[27] */ + unsigned transpose : 1; /* D[28] */ + unsigned coladr_rtl_nltr : 1; /* D[29] */ + unsigned rowadr_btt_nttb : 1; /* D[30] */ + unsigned booster : 1; /* D[31] */ + } bits; + uint8_t bytes[4]; +} ILI9341Params_GET_STATUS; + +typedef union { + struct ILI9341ParamBits_GET_PWR_MODE { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned display : 1; /* D[2] */ + unsigned normal : 1; /* D[3] */ + unsigned sleep : 1; /* D[4] */ + unsigned partial : 1; /* D[5] */ + unsigned idle : 1; /* D[6] */ + unsigned booster : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_PWR_MODE; + +typedef union { + struct ILI9341ParamBits_GET_MADCTL { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned refr_rtl_nltr : 1; /* D[2] */ + unsigned bgr_nrgb : 1; /* D[3] */ + unsigned refr_btt_nttb : 1; /* D[4] */ + unsigned invert : 1; /* D[5] */ + unsigned rtl_nltr : 1; /* D[6] */ + unsigned btt_nttb : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_MADCTL; + +typedef union { + struct ILI9341ParamBits_GET_PIX_FMT { + unsigned DBI : 3; /* D[2:0] */ + unsigned _reserved_1 : 1; /* D[3] */ + unsigned DPI : 3; /* D[6:4] */ + unsigned RIM : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_PIX_FMT; + +typedef union { + struct ILI9341ParamBits_GET_IMG_FMT { + unsigned gamma_curve : 3; /* D[2:0] */ + unsigned _reserved_1 : 5; /* D[7:3] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_IMG_FMT; + +typedef union { + struct ILI9341ParamBits_GET_SIG_MODE { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned data_enable : 1; /* D[2] */ + unsigned pixel_clock : 1; /* D[3] */ + unsigned vsync : 1; /* D[4] */ + unsigned hsync : 1; /* D[5] */ + unsigned tearing_mode : 1; /* D[6] */ + unsigned tearing : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_SIG_MODE; + +typedef union { + struct ILI9341ParamBits_GET_SELF_DIAG { + unsigned _reserved_1 : 6; /* D[5:0] */ + unsigned func_err : 1; /* D[6] */ + unsigned reg_err : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_SELF_DIAG; + +typedef union { + struct ILI9341ParamBits_SET_GAMMA { + uint8_t gamma_curve; /* D[7:0] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_GAMMA; + +typedef union { + struct ILI9341ParamBits_SET_COL_ADDR { + uint8_t SC_15_8; /* D[ 7: 0] */ + uint8_t SC_7_0; /* D[15: 8] */ + uint8_t EC_15_8; /* D[23:16] */ + uint8_t EC_7_0; /* D[31:24] */ + } bits; + uint8_t bytes[4]; +} ILI9341Params_SET_COL_ADDR; + +typedef union { + struct ILI9341ParamBits_SET_PAGE_ADDR { + uint8_t SP_15_8; /* D[ 7: 0] */ + uint8_t SP_7_0; /* D[15: 8] */ + uint8_t EP_15_8; /* D[23:16] */ + uint8_t EP_7_0; /* D[31:24] */ + } bits; + uint8_t bytes[4]; +} ILI9341Params_SET_PAGE_ADDR; + +typedef union { + struct ILI9341ParamBits_SET_PARTIAL_AREA { + uint8_t SR_15_8; /* D[ 7: 0] */ + uint8_t SR_7_0; /* D[15: 8] */ + uint8_t ER_15_8; /* D[23:16] */ + uint8_t ER_7_0; /* D[31:24] */ + } bits; + uint8_t bytes[4]; +} ILI9341Params_SET_PARTIAL_AREA; + +typedef union { + struct ILI9341ParamBits_SET_VSCROLL { + uint8_t TFA_15_8; /* D[ 7: 0] */ + uint8_t TFA_7_0; /* D[15: 8] */ + uint8_t VSA_15_8; /* D[23:16] */ + uint8_t VSA_7_0; /* D[31:24] */ + uint8_t BFA_15_8; /* D[39:32] */ + uint8_t BFA_7_0; /* D[47:40] */ + } bits; + uint8_t bytes[6]; +} ILI9341Params_SET_VSCROLL; + +typedef union { + struct ILI9341ParamBits_CMD_TEARING_ON { + unsigned M : 1; /* D[0] */ + unsigned _reserved_1 : 7; /* D[7:1] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_CMD_TEARING_ON; + +typedef union { + struct ILI9341ParamBits_SET_MEM_ACS_CTL { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned MH : 1; /* D[2] */ + unsigned BGR : 1; /* D[3] */ + unsigned ML : 1; /* D[4] */ + unsigned MV : 1; /* D[5] */ + unsigned MX : 1; /* D[6] */ + unsigned MY : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_MEM_ACS_CTL; + +typedef union { + struct ILI9341ParamBits_SET_VSCROLL_ADDR { + uint8_t VSP_15_8; /* D[ 7: 0] */ + uint8_t VSP_7_0; /* D[15: 8] */ + } bits; + uint8_t bytes[2]; +} ILI9341Params_SET_VSCROLL_ADDR; + +typedef union { + struct ILI9341ParamBits_SET_PIX_FMT { + unsigned DBI : 3; /* D[2:0] */ + unsigned _reserved_1 : 1; /* D[3] */ + unsigned DPI : 3; /* D[4:6] */ + unsigned _reserved_2 : 1; /* D[7] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_PIX_FMT; + +typedef union { + struct ILI9341ParamBits_SET_TEAR_SCANLINE { + uint8_t STS_8; /* D[ 7: 0] */ + uint8_t STS_7_0; /* D[15: 8] */ + } bits; + uint8_t bytes[4]; +} ILI9341Params_SET_TEAR_SCANLINE; + +typedef union { + struct ILI9341ParamBits_GET_TEAR_SCANLINE { + uint8_t GTS_9_8; /* D[ 7: 0] */ + uint8_t GTS_7_0; /* D[15: 8] */ + } bits; + uint8_t bytes[2]; +} ILI9341Params_GET_TEAR_SCANLINE; + +typedef union { + struct ILI9341ParamBits_SET_BRIGHTNESS { + uint8_t DBV; /* D[7:0] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_BRIGHTNESS; + +typedef union { + struct ILI9341ParamBits_GET_BRIGHTNESS { + uint8_t DBV; /* D[7:0] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_BRIGHTNESS; + +typedef union { + struct ILI9341ParamBits_SET_DISPLAY_CTL { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned BL : 1; /* D[2] */ + unsigned DD : 1; /* D[3] */ + unsigned _reserved_2 : 1; /* D[4] */ + unsigned BCTRL : 1; /* D[5] */ + unsigned _reserved_3 : 1; /* D[7:6] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_DISPLAY_CTL; + +typedef union { + struct ILI9341ParamBits_GET_DISPLAY_CTL { + unsigned _reserved_1 : 2; /* D[1:0] */ + unsigned BL : 1; /* D[2] */ + unsigned DD : 1; /* D[3] */ + unsigned _reserved_2 : 1; /* D[4] */ + unsigned BCTRL : 1; /* D[5] */ + unsigned _reserved_3 : 1; /* D[7:6] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_DISPLAY_CTL; + +typedef union { + struct ILI9341ParamBits_SET_CABC { + unsigned C : 2; /* D[1:0] */ + unsigned _reserved_1 : 6; /* D[7:2] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_CABC; + +typedef union { + struct ILI9341ParamBits_GET_CABC { + unsigned C : 2; /* D[1:0] */ + unsigned _reserved_1 : 6; /* D[7:2] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_CABC; + +typedef union { + struct ILI9341ParamBits_SET_CABC_MIN { + uint8_t CMB; /* D[7:0] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_SET_CABC_MIN; + +typedef union { + struct ILI9341ParamBits_GET_CABC_MIN { + uint8_t CMB; /* D[7:0] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_GET_CABC_MIN; + +#if 0 /* TODO: Extended command structs.*/ + +typedef union { + struct ILI9341ParamBits { + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_; + +typedef union { + struct ILI9341ParamBits { + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + unsigned : 1; /* D[] */ + } bits; + uint8_t bytes[1]; +} ILI9341Params_; + +#endif /*0*/ + +#pragma pack(pop) + +/** @} */ + +/*===========================================================================*/ +/* Driver macros. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* External declarations. */ +/*===========================================================================*/ + +extern ILI9341Driver ILI9341D1; + +#ifdef __cplusplus +extern "C" { +#endif + + void ili9341ObjectInit(ILI9341Driver *driverp); + void ili9341Start(ILI9341Driver *driverp, const ILI9341Config *configp); + void ili9341Stop(ILI9341Driver *driverp); +#if (ILI9341_USE_MUTUAL_EXCLUSION == TRUE) + void ili9341AcquireBusS(ILI9341Driver *driverp); + void ili9341AcquireBus(ILI9341Driver *driverp); + void ili9341ReleaseBusS(ILI9341Driver *driverp); + void ili9341ReleaseBus(ILI9341Driver *driverp); +#endif /* (ILI9341_USE_MUTUAL_EXCLUSION == TRUE) */ + void ili9341SelectI(ILI9341Driver *driverp); + void ili9341Select(ILI9341Driver *driverp); + void ili9341UnselectI(ILI9341Driver *driverp); + void ili9341Unselect(ILI9341Driver *driverp); + void ili9341WriteCommand(ILI9341Driver *driverp, uint8_t cmd); + void ili9341WriteByte(ILI9341Driver *driverp, uint8_t value); + uint8_t ili9341ReadByte(ILI9341Driver *driverp); + void ili9341WriteChunk(ILI9341Driver *driverp, const uint8_t chunk[], + size_t length); + void ili9341ReadChunk(ILI9341Driver *driverp, uint8_t chunk[], + size_t length); + +#ifdef __cplusplus +} +#endif + +/** @} */ + +#endif /* _ILI9341_H_ */ |