path: root/demos/STM32/RT-STM32F429-DISCOVERY-DMA2D/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_ */