ra8-firmware 0.1.0
Bare-metal firmware for the Renesas RA8 family (RA8D2 / RA8P1)
Loading...
Searching...
No Matches
ra8_epaper_dev_info_t Struct Reference

Decoded GET_DEV_INFO (0x0302) response. More...

#include <ra8_epaper.h>

Data Fields

uint16_t panel_width
 Reported panel width (px).
uint16_t panel_height
 Reported panel height (px).
uint32_t image_buf_base
 Controller frame-RAM base.
char fw_version [k_ra8_epaper_ver_chars+1U]
 Firmware version, NUL-term.
char lut_version [k_ra8_epaper_ver_chars+1U]
 LUT version, NUL-terminated.

Detailed Description

Decoded GET_DEV_INFO (0x0302) response.

The controller answers GET_DEV_INFO with 20 16-bit words: panel width, panel height, image-buffer base address low half, image-buffer base address high half, then eight words of firmware-version string and eight words of waveform-LUT-version string (IT8951 I80/SPI/I2C programming guide, I80_GET_DEV_INFO). The LUT version is the value that decides waveform mode numbering – feed it to ra8_epaper_waveform_cfg_for_lut.

Invariant
fw_version and lut_version are always NUL-terminated.
Populated once by ra8_epaper_init and read-only after.
Example:
if (ra8_epaper_dev_info(&info) == k_ra8_ok) {
}
ra8_err_t ra8_epaper_dev_info(ra8_epaper_dev_info_t *out_info)
Hand back the GET_DEV_INFO block captured during init.
Definition ra8_epaper.c:701
ra8_err_t ra8_epaper_waveform_cfg_for_lut(const char *lut_version, ra8_epaper_waveform_cfg_t *out_cfg)
Fill a waveform map from a controller-reported LUT version.
@ k_ra8_ok
Success – operation completed with all postconditions satisfied.
Definition ra8_err.h:119
Decoded GET_DEV_INFO (0x0302) response.
Definition ra8_epaper.h:247
char lut_version[k_ra8_epaper_ver_chars+1U]
LUT version, NUL-terminated.
Definition ra8_epaper.h:252
Per-panel map from ra8_epaper_waveform_t onto LUT mode numbers.
Definition ra8_epaper.h:148
See also
ra8_epaper_dev_info
ra8_epaper_waveform_cfg_for_lut
Since
0.1.0

Definition at line 247 of file ra8_epaper.h.

Field Documentation

◆ fw_version

char ra8_epaper_dev_info_t::fw_version[k_ra8_epaper_ver_chars+1U]

Firmware version, NUL-term.

Definition at line 251 of file ra8_epaper.h.

Referenced by internal_ra8_epaper_decode_dev_word(), and ra8_epaper_decode_dev_info().

◆ image_buf_base

uint32_t ra8_epaper_dev_info_t::image_buf_base

Controller frame-RAM base.

Definition at line 250 of file ra8_epaper.h.

Referenced by internal_ra8_epaper_decode_dev_word().

◆ lut_version

char ra8_epaper_dev_info_t::lut_version[k_ra8_epaper_ver_chars+1U]

LUT version, NUL-terminated.

Definition at line 252 of file ra8_epaper.h.

Referenced by internal_ra8_epaper_decode_dev_word(), and ra8_epaper_decode_dev_info().

◆ panel_height

uint16_t ra8_epaper_dev_info_t::panel_height

Reported panel height (px).

Definition at line 249 of file ra8_epaper.h.

Referenced by internal_ra8_epaper_decode_dev_word(), and ra8_epaper_geometry_agrees().

◆ panel_width

uint16_t ra8_epaper_dev_info_t::panel_width

Reported panel width (px).

Definition at line 248 of file ra8_epaper.h.

Referenced by internal_ra8_epaper_decode_dev_word(), and ra8_epaper_geometry_agrees().


The documentation for this struct was generated from the following file: