aboutsummaryrefslogtreecommitdiffstats
path: root/os/various/devices_lib/lcd/ili9341.h
blob: 007c4fd674498ae4e6f3aa30f258ca97789247dd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
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_ */