ra8-firmware/examples_2ek__ra8d2_2hw__validated_2hil_2sd__font__render_2src_2main_8c_source.html

#include <stdint.h>

#include <string.h>


#include "literata_latin1.h"

#include "ra8_board_ek_ra8d2.h"

#include "ra8_boot_entry.h"

#include "ra8_cgc.h"

#include "ra8_display_pal.h"

#include "ra8_display_pal_lcd.h"

#include "ra8_err.h"

#include "ra8_gfx.h"

#include "ra8_isr.h"

#include "ra8_mstp.h"

#include "ra8_panel.h"

#include "ra8_panel_timing.h"

#include "ra8_sdfont.h"

#include "ra8_sdramc.h"

#include "ra8_time.h"

#include "reflow.h"


/* ===========================================================================

 * Compile-time configuration -- typed enums per the no-magic-number rule.

 * =========================================================================== */


typedef enum : uint16_t {

  k_sfr_fb_w = k_panel_width_px,

  k_sfr_fb_h = k_panel_height_px,

} sfr_fb_dim_t;


typedef enum : uint16_t {

  k_sfr_settle_ms = 500U,

  k_sfr_frame_ms  = 100U,

} sfr_fb_misc_t;


typedef enum : uint32_t {

  k_sfr_font_cap     = 512U * 1024U,

  k_sfr_font_px      = 18U,

  k_sfr_spi_chan     = 0U,

  k_sfr_spi_idle     = 0xFFU,

  k_sfr_paper_argb   = 0xFFFFFFFFU,

  k_sfr_ink_argb     = 0xFF101010U,

  k_sfr_link_argb    = 0xFF2A52BEU,

  k_sfr_paper_rgb565 = 0xFFFFU,

} sfr_reflow_cfg_t;


typedef enum : uint32_t {

  k_sfr_diag_argb_opaque = 0xFF000000U,

  k_sfr_diag_lvl_base    = 0x10U,

  k_sfr_diag_lvl_step    = 0x20U,

  k_sfr_diag_lvl_mask    = 0x0FU,

  k_sfr_diag_shift_r     = 16U,

  k_sfr_diag_shift_g     = 8U,

} sfr_diag_fill_t;


typedef enum : uint32_t {

  k_sfr_stage_boot        = 0U,

  k_sfr_stage_panel_ok    = 1U,

  k_sfr_stage_card_ok     = 2U,

  k_sfr_stage_mount_ok    = 3U,

  k_sfr_stage_font_ok     = 4U,

  k_sfr_stage_layout_ok   = 5U,

  k_sfr_stage_render_ok   = 6U,

  k_sfr_stage_card_fail   = 0x80U,

  k_sfr_stage_mount_fail  = 0x81U,

  k_sfr_stage_font_fail   = 0x82U,

  k_sfr_stage_reflow_fail = 0x83U,

} sfr_stage_t;


static const ra8_port_pin_t k_sfr_pin_sck  = (ra8_port_pin_t)k_ra8_board_pmod2_spi_sck;

static const ra8_port_pin_t k_sfr_pin_cipo = (ra8_port_pin_t)k_ra8_board_pmod2_spi_cipo;

static const ra8_port_pin_t k_sfr_pin_copi = (ra8_port_pin_t)k_ra8_board_pmod2_spi_copi;

static const ra8_port_pin_t k_sfr_pin_cs   = (ra8_port_pin_t)k_ra8_board_pmod2_spi_cs;


static const char k_sfr_body[] = "<html><body><h1>SD font OK</h1>"

                                 "<p>Read off the card.</p></body></html>";


/* ===========================================================================

 * Static storage

 * =========================================================================== */


RA8_BOARD_PANEL_FRAMEBUFFER(s_framebuffer);


[[gnu::section(".sdram_data")]] static uint8_t s_font_buf[k_sfr_font_cap];


static reflow_t s_engine;


static const display_cfg_t k_sfr_display_cfg = {

  .iface             = &k_display_backend_lcd_ra8_glcdc,

  .framebuffer       = s_framebuffer,

  .framebuffer_bytes = sizeof(s_framebuffer),

  .width_px          = (uint16_t)k_sfr_fb_w,

  .height_px         = (uint16_t)k_sfr_fb_h,

  .pixfmt            = k_display_pixfmt_rgb565,

  .panel_timing      = &s_ra8_panel_ek_ra8d2_timing,

};


static display_handle_t* s_display = nullptr;


static display_fb_t s_fb;


static uint32_t s_pclka_hz = 0U;


/* ---- J-Link / ra8_emulator readable diagnostics ----------------------------- */


volatile uint32_t g_sfr_stage = k_sfr_stage_boot;

volatile uint32_t g_sfr_font_len = 0U;

volatile uint32_t g_sfr_pages = 0U;

volatile uint32_t g_sfr_ink = 0U;

volatile uint32_t g_sfr_source = 0U;

volatile uint32_t g_sfr_err = 0U;

volatile uint32_t g_sfr_heartbeat = 0U;


/* ===========================================================================

 * Boot helpers

 * =========================================================================== */


static void sfr_panic_halt(uint32_t stage)

{

  g_sfr_stage = stage;

  (void)ra8_board_led_on(k_ra8_board_led_red);

  const uint8_t lvl =

    (uint8_t)((uint32_t)k_sfr_diag_lvl_base +

              ((stage & (uint32_t)k_sfr_diag_lvl_mask) * (uint32_t)k_sfr_diag_lvl_step));

  const uint32_t argb = (uint32_t)k_sfr_diag_argb_opaque |

                        ((uint32_t)lvl << (uint32_t)k_sfr_diag_shift_r) |

                        ((uint32_t)lvl << (uint32_t)k_sfr_diag_shift_g) | (uint32_t)lvl;

  (void)ra8_gfx_clear(argb);

  while (1) {

    __asm__ volatile("wfi");

  }

}


static void sfr_bringup_clocks(void)

{

  uint32_t cpuclk0_hz = 0U;

  if (ra8_cgc_init() != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_cgc_get_clock_hz(k_ra8_clock_id_cpuclk0, &cpuclk0_hz) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_cgc_get_clock_hz(k_ra8_clock_id_pclka, &s_pclka_hz) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_mstp_init() != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_time_init(cpuclk0_hz) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_board_led_init(k_ra8_board_led_blue) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_board_led_init(k_ra8_board_led_red) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  ra8_isr_globals_enable();

}


static void sfr_bringup_panel(void)

{

  ra8_delay_ms((uint32_t)k_sfr_settle_ms);

  if (ra8_sdramc_init() != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (display_init(&k_sfr_display_cfg, &s_display) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (display_get_framebuffer(s_display, &s_fb) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  if (ra8_gfx_init(s_fb.pixels, s_fb.width_px, s_fb.height_px, k_ra8_gfx_format_rgb565) !=

      k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_boot);

  }

  (void)ra8_gfx_clear((uint32_t)k_sfr_paper_argb);

  g_sfr_stage = k_sfr_stage_panel_ok;

}


static void sfr_load_font_or_halt(void)

{

  const ra8_sdfont_cfg_t cfg = {

    .spi_channel    = (uint8_t)k_sfr_spi_chan,

    .sck            = k_sfr_pin_sck,

    .cipo           = k_sfr_pin_cipo,

    .copi           = k_sfr_pin_copi,

    .cs             = k_sfr_pin_cs,

    .pclka_hz       = s_pclka_hz,

    .filename       = "FONT.OTF",

    .provision_blob = g_ra8_font_literata_latin1,

    .provision_len  = g_ra8_font_literata_latin1_len,

  };

  uint32_t            got = 0U;

  ra8_sdfont_source_t src = k_ra8_sdfont_source_card;

  const ra8_err_t     err = ra8_sdfont_load(&cfg, s_font_buf, (uint32_t)k_sfr_font_cap, &got, &src);

  g_sfr_err               = (uint32_t)err;

  if (err != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_card_fail);

  }

  g_sfr_font_len = got;

  g_sfr_source   = (uint32_t)src;

  g_sfr_stage    = k_sfr_stage_font_ok;

}


static void sfr_render_or_halt(void)

{

  if (reflow_init((uint16_t)k_sfr_fb_w,

                  (uint16_t)k_sfr_fb_h,

                  s_font_buf,

                  g_sfr_font_len,

                  (uint16_t)k_sfr_font_px,

                  (uint32_t)k_sfr_ink_argb,

                  (uint32_t)k_sfr_link_argb,

                  &s_engine) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_reflow_fail);

  }

  uint32_t pages = 0U;

  if (reflow_layout_chapter(&s_engine,

                            (const uint8_t*)k_sfr_body,

                            (uint32_t)(sizeof(k_sfr_body) - 1U),

                            &pages) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_reflow_fail);

  }

  g_sfr_pages = pages;

  g_sfr_stage = k_sfr_stage_layout_ok;

  if (reflow_render_page(&s_engine, 0U, nullptr) != k_ra8_ok) {

    sfr_panic_halt(k_sfr_stage_reflow_fail);

  }


  /* Count inked pixels so a HIL probe / emulator can prove text actually landed. */

  uint32_t       ink      = 0U;

  const uint16_t paper565 = (uint16_t)k_sfr_paper_rgb565;

  for (size_t i = 0U; i < (size_t)k_sfr_fb_w * (size_t)k_sfr_fb_h; i++) {

    if (s_framebuffer[i] != paper565) {

      ink++;

    }

  }

  g_sfr_ink   = ink;

  g_sfr_stage = k_sfr_stage_render_ok;

  (void)ra8_board_led_on(k_ra8_board_led_blue);

}


/* ===========================================================================

 * Main

 * =========================================================================== */


void main(void)

{

  sfr_bringup_clocks();

  sfr_bringup_panel();

  sfr_load_font_or_halt();

  sfr_render_or_halt();


  /* The page is rendered; GLCDC scans out the framebuffer continuously.

   * ra8_emulator snapshots it via --ppm. Idle with a heartbeat that advances only

   * on this success path -- the panic-halt loop does not bump it -- so a J-Link

   * memprobe gate proves the full SD-font render pipeline ran end to end. */

  while (1) {

    ra8_delay_ms((uint32_t)k_sfr_frame_ms);

    g_sfr_heartbeat++;

  }

}


main
void main(void)
Secure fallback main entry point.
Definition main.c:37

s_pclka_hz
static uint32_t s_pclka_hz
Definition c6_cam_app.c:38

s_display
static display_handle_t * s_display
Definition main.c:78

s_framebuffer
static uint16_t s_framebuffer[(size_t) k_panel_height_px *(size_t) k_panel_width_px]
1024x600 RGB565 framebuffer in external SDRAM (GLCDC scans this).
Definition main.c:67

s_engine
static reflow_t s_engine
Reflow engine (glyph / page / token / text pools live inside).
Definition main.c:199

s_font_buf
static uint8_t s_font_buf[k_pc_font_cap]
Font blob read off the card.
Definition main.c:197

s_fb
static display_fb_t s_fb
Definition main.c:203

sfr_render_or_halt
static void sfr_render_or_halt(void)
Reflow the body XHTML with the SD font into the framebuffer.
Definition main.c:288

sfr_bringup_clocks
static void sfr_bringup_clocks(void)
Clocks, MSTP, SysTick, LEDs, then enable IRQs.
Definition main.c:207

k_sfr_pin_sck
static const ra8_port_pin_t k_sfr_pin_sck
Pmod2 SPI pins (J25) – SCI0 Simple-SPI per HUM Table 20.13.
Definition main.c:117

g_sfr_ink
volatile uint32_t g_sfr_ink
Inked (non-paper) pixel count after render – liveness proof.
Definition main.c:173

sfr_fb_dim_t
sfr_fb_dim_t
Framebuffer dimensions, sourced from the BSP panel descriptor.
Definition main.c:68

k_sfr_fb_w
@ k_sfr_fb_w
Framebuffer width (pixels).
Definition main.c:69

k_sfr_fb_h
@ k_sfr_fb_h
Framebuffer height (pixels).
Definition main.c:70

k_sfr_pin_cipo
static const ra8_port_pin_t k_sfr_pin_cipo
Definition main.c:118

sfr_panic_halt
static void sfr_panic_halt(uint32_t stage)
Halt forever with the red board LED on (fatal init error marker).
Definition main.c:190

sfr_reflow_cfg_t
sfr_reflow_cfg_t
Reflow + font-load tunables.
Definition main.c:80

k_sfr_paper_rgb565
@ k_sfr_paper_rgb565
White paper in RGB565 (all bits set).
Definition main.c:88

k_sfr_ink_argb
@ k_sfr_ink_argb
Body text colour (near-black ink).
Definition main.c:86

k_sfr_spi_chan
@ k_sfr_spi_chan
Pmod2 / J25 = SCI0 Simple-SPI.
Definition main.c:83

k_sfr_font_cap
@ k_sfr_font_cap
Max font we will read off the card.
Definition main.c:81

k_sfr_spi_idle
@ k_sfr_spi_idle
Idle byte clocked on read-only xfer.
Definition main.c:84

k_sfr_font_px
@ k_sfr_font_px
Body font size in pixels.
Definition main.c:82

k_sfr_link_argb
@ k_sfr_link_argb
Anchor text colour (cerulean).
Definition main.c:87

k_sfr_paper_argb
@ k_sfr_paper_argb
Page background the FB is cleared to.
Definition main.c:85

sfr_bringup_panel
static void sfr_bringup_panel(void)
External SDRAM + GLCDC panel + ra8_gfx binding.
Definition main.c:235

g_sfr_source
volatile uint32_t g_sfr_source
Font provenance (ra8_sdfont_source_t): 0 = on-card, 1 = provisioned.
Definition main.c:175

sfr_fb_misc_t
sfr_fb_misc_t
Framebuffer + pacing byte-math constants.
Definition main.c:74

k_sfr_settle_ms
@ k_sfr_settle_ms
PLL / SDRAM / panel-POR settle.
Definition main.c:75

k_sfr_frame_ms
@ k_sfr_frame_ms
Idle heartbeat pacing (ms).
Definition main.c:76

k_sfr_pin_copi
static const ra8_port_pin_t k_sfr_pin_copi
Definition main.c:119

g_sfr_err
volatile uint32_t g_sfr_err
Last ra8_err_t from ra8_sdfont_load (0 = k_ra8_ok), for SWD triage.
Definition main.c:177

k_sfr_pin_cs
static const ra8_port_pin_t k_sfr_pin_cs
Definition main.c:120

g_sfr_font_len
volatile uint32_t g_sfr_font_len
Bytes of font read off the card.
Definition main.c:169

sfr_stage_t
sfr_stage_t
Diagnostic stage codes stamped to g_sfr_stage (J-Link / emulator).
Definition main.c:102

k_sfr_stage_boot
@ k_sfr_stage_boot
Pre-init.
Definition main.c:103

k_sfr_stage_panel_ok
@ k_sfr_stage_panel_ok
SDRAM + GLCDC + ra8_gfx up.
Definition main.c:104

k_sfr_stage_mount_fail
@ k_sfr_stage_mount_fail
FAT mount failed.
Definition main.c:111

k_sfr_stage_mount_ok
@ k_sfr_stage_mount_ok
ra8_fs mounted the FAT volume.
Definition main.c:106

k_sfr_stage_layout_ok
@ k_sfr_stage_layout_ok
reflow laid out the chapter.
Definition main.c:108

k_sfr_stage_reflow_fail
@ k_sfr_stage_reflow_fail
Layout/render failed.
Definition main.c:113

k_sfr_stage_card_fail
@ k_sfr_stage_card_fail
SD bring-up failed.
Definition main.c:110

k_sfr_stage_card_ok
@ k_sfr_stage_card_ok
ra8_sdmmc_spi init succeeded.
Definition main.c:105

k_sfr_stage_render_ok
@ k_sfr_stage_render_ok
Page rasterised to the FB.
Definition main.c:109

k_sfr_stage_font_fail
@ k_sfr_stage_font_fail
Font open/read failed.
Definition main.c:112

k_sfr_stage_font_ok
@ k_sfr_stage_font_ok
Font read off the card.
Definition main.c:107

sfr_diag_fill_t
sfr_diag_fill_t
Constants for the stage-coded gray panic fill (diagnostic only).
Definition main.c:92

k_sfr_diag_shift_g
@ k_sfr_diag_shift_g
Green byte position in ARGB.
Definition main.c:98

k_sfr_diag_shift_r
@ k_sfr_diag_shift_r
Red byte position in ARGB.
Definition main.c:97

k_sfr_diag_lvl_step
@ k_sfr_diag_lvl_step
Gray step per stage code.
Definition main.c:95

k_sfr_diag_lvl_mask
@ k_sfr_diag_lvl_mask
Low-nibble stage selector.
Definition main.c:96

k_sfr_diag_argb_opaque
@ k_sfr_diag_argb_opaque
Opaque-alpha bits of an ARGB fill.
Definition main.c:93

k_sfr_diag_lvl_base
@ k_sfr_diag_lvl_base
Darkest panic gray level.
Definition main.c:94

sfr_load_font_or_halt
static void sfr_load_font_or_halt(void)
Load FONT.OTF off the Pmod2 card (self-provisioning) into s_font_buf.
Definition main.c:262

g_sfr_heartbeat
volatile uint32_t g_sfr_heartbeat
Idle-loop heartbeat; advances only after a clean render (HIL gate).
Definition main.c:179

g_sfr_pages
volatile uint32_t g_sfr_pages
Pages produced by reflow_layout_chapter.
Definition main.c:171

g_sfr_stage
volatile uint32_t g_sfr_stage
Last stage reached (sfr_stage_t); read externally over SWD.
Definition main.c:167

k_sfr_display_cfg
static const display_cfg_t k_sfr_display_cfg
Display PAL config – LCD/GLCDC backend over the SDRAM buffer.
Definition main.c:145

k_sfr_body
static const char k_sfr_body[]
XHTML body the app reflows with the SD-loaded font.
Definition main.c:128

literata_latin1.h
Declaration of the Latin-1 Literata font baked into internal flash.

g_ra8_font_literata_latin1_len
const unsigned int g_ra8_font_literata_latin1_len
Length of g_ra8_font_literata_latin1 in bytes.

g_ra8_font_literata_latin1
const unsigned char g_ra8_font_literata_latin1[]
Baked Latin-1 subset of Literata Regular (TrueType/glyf), in flash.

ra8_board_ek_ra8d2.h
Board-support layer for the Renesas EK-RA8D2 v1 evaluation kit.

k_ra8_board_pmod2_spi_cipo
@ k_ra8_board_pmod2_spi_cipo
Pmod2.3 CIPO (CIPO0_B), P602.
Definition ra8_board_ek_ra8d2_connectors.h:681

k_ra8_board_pmod2_spi_cs
@ k_ra8_board_pmod2_spi_cs
Pmod2.1 CS (SS0_B), P604.
Definition ra8_board_ek_ra8d2_connectors.h:676

k_ra8_board_pmod2_spi_copi
@ k_ra8_board_pmod2_spi_copi
Pmod2.2 COPI (COPI0_B), P603.
Definition ra8_board_ek_ra8d2_connectors.h:678

k_ra8_board_pmod2_spi_sck
@ k_ra8_board_pmod2_spi_sck
Pmod2.4 SCK (SCK0_B), P601.
Definition ra8_board_ek_ra8d2_connectors.h:684

ra8_board_led_init
ra8_err_t ra8_board_led_init(ra8_board_led_id_t led)
Configure led as a digital output, initial level low (off).
Definition ra8_board_ek_ra8d2.c:91

ra8_board_led_on
ra8_err_t ra8_board_led_on(ra8_board_led_id_t led)
Drive led HIGH (light it).
Definition ra8_board_ek_ra8d2.c:101

k_ra8_board_led_blue
@ k_ra8_board_led_blue
Convenience aliases by colour.
Definition ra8_board_ek_ra8d2_connectors.h:106

k_ra8_board_led_red
@ k_ra8_board_led_red
RA8 board led red.
Definition ra8_board_ek_ra8d2_connectors.h:108

ra8_boot_entry.h
Boot entry points shared between a vector table and its startup code.

ra8_cgc.h
High-level Clock Generation Circuit driver.

ra8_cgc_get_clock_hz
ra8_err_t ra8_cgc_get_clock_hz(ra8_clock_id_t id, uint32_t *out_hz)
Query the current frequency of a clock-tree domain.
Definition ra8_cgc.c:132

k_ra8_clock_id_cpuclk0
@ k_ra8_clock_id_cpuclk0
Cortex-M85 CPUCLK0.
Definition ra8_cgc.h:70

k_ra8_clock_id_pclka
@ k_ra8_clock_id_pclka
PCLKA.
Definition ra8_cgc.h:73

ra8_cgc_init
ra8_err_t ra8_cgc_init(void)
Configure the clock tree to a safe default.
Definition ra8_cgc.c:727

ra8_display_pal.h
Display Platform Abstraction Layer for the RA8D2.

k_display_pixfmt_rgb565
@ k_display_pixfmt_rgb565
16 bpp, 5/6/5 packed.
Definition ra8_display_pal.h:99

display_get_framebuffer
ra8_err_t display_get_framebuffer(const display_handle_t *d, display_fb_t *out)
Return the framebuffer descriptor the backend is targeting.
Definition ra8_display_pal.c:129

display_handle_t
struct display_handle display_handle_t
Definition ra8_display_pal.h:222

display_init
ra8_err_t display_init(const display_cfg_t *cfg, display_handle_t **out_handle)
Initialise the display PAL and bring the selected backend up to a state where display_flush succeeds.
Definition ra8_display_pal.c:93

ra8_display_pal_lcd.h
LCD backend (ra8_glcdc) for the display PAL.

k_display_backend_lcd_ra8_glcdc
const display_backend_iface_t k_display_backend_lcd_ra8_glcdc
LCD backend vtable – pass its address through display_cfg_t.iface to drive the EK-RA8D2 panel.
Definition ra8_display_pal_lcd.c:566

ra8_err.h
Error Code Definitions for ra8-firmware.

k_ra8_ok
@ k_ra8_ok
Success – operation completed with all postconditions satisfied.
Definition ra8_err.h:119

ra8_err_t
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546

ra8_gfx.h
Software 2D graphics primitives layered on top of a caller-ownedframebuffer (DRW / D/AVE 2D / GLCDC r...

k_ra8_gfx_format_rgb565
@ k_ra8_gfx_format_rgb565
16-bit RGB565, little-endian in memory.
Definition ra8_gfx.h:40

ra8_gfx_clear
ra8_err_t ra8_gfx_clear(uint32_t color)
Fill the bound framebuffer's clip region with a single colour.
Definition ra8_gfx_text.c:549

ra8_gfx_init
ra8_err_t ra8_gfx_init(void *fb, uint16_t width, uint16_t height, ra8_gfx_format_t format)
Bind ra8_gfx to a caller-owned framebuffer.
Definition ra8_gfx_text.c:522

ra8_isr.h
NVIC + ICU IELSR allocator.

ra8_isr_globals_enable
void ra8_isr_globals_enable(void)
Globally enable maskable interrupts (PRIMASK = 0).
Definition ra8_isr.c:439

ra8_mstp.h
Ref-counted Module Stop Control wrapper for the RA8D2.

ra8_mstp_init
ra8_err_t ra8_mstp_init(void)
Re-establish the ra8_mstp ref-count table from current hardware state.
Definition ra8_mstp.c:291

ra8_panel.h
Active display-panel descriptor for the EK-RA8D2 (ER-TFT070-6).

k_panel_height_px
@ k_panel_height_px
Native height (pixels).
Definition ra8_panel.h:52

k_panel_width_px
@ k_panel_width_px
Native width (pixels).
Definition ra8_panel.h:51

RA8_BOARD_PANEL_FRAMEBUFFER
#define RA8_BOARD_PANEL_FRAMEBUFFER(name)
Declare a correctly aligned, sized and placed RGB565 framebuffer for the on-board panel.
Definition ra8_panel.h:165

ra8_panel_timing.h
EK-RA8D2 panel timing as the HAL's ra8_glcdc_timing_t (ER-TFT070-6).

s_ra8_panel_ek_ra8d2_timing
static const ra8_glcdc_timing_t s_ra8_panel_ek_ra8d2_timing
EK-RA8D2 ER-TFT070-6 RGB timing for ra8_glcdc_init / the LCD backend.
Definition ra8_panel_timing.h:29

ra8_port_pin_t
ra8_port_pin_t
Packed (port << 8) | pin pin identifier.
Definition ra8_port_constants.h:147

ra8_sdfont.h
Load a TTF/OTF font off a Pmod SD card, self-provisioning if absent.

ra8_sdfont_load
ra8_err_t ra8_sdfont_load(const ra8_sdfont_cfg_t *cfg, uint8_t *buf, uint32_t cap, uint32_t *out_len, ra8_sdfont_source_t *out_source)
Mount the Pmod SD card and load a font, provisioning it if absent.
Definition ra8_sdfont.c:392

ra8_sdfont_source_t
ra8_sdfont_source_t
Provenance of the font bytes returned by ra8_sdfont_load.
Definition ra8_sdfont.h:70

k_ra8_sdfont_source_card
@ k_ra8_sdfont_source_card
File already on the card; read as-is.
Definition ra8_sdfont.h:71

ra8_sdramc.h
External SDRAM controller driver (framework).

ra8_sdramc_init
ra8_err_t ra8_sdramc_init(void)
Initialise the external SDRAM at k_ra8_sdram_base_addr.
Definition ra8_sdramc.c:257

ra8_time.h
SysTick-based tick counter, delay and timestamp helpers.

ra8_time_init
ra8_err_t ra8_time_init(uint32_t cpu_hz)
Initialise SysTick for a 1 kHz tick interrupt.
Definition ra8_time.c:59

ra8_delay_ms
void ra8_delay_ms(uint32_t ms)
Busy-wait for at least ms milliseconds.
Definition ra8_time.c:129

reflow.h
HTML / CSS reflow + paginate engine for the ra8d2 ereader.

reflow_render_page
ra8_err_t reflow_render_page(const reflow_t *engine, uint32_t page_idx, void *framebuffer)
Render one page into the active ra8_gfx framebuffer.
Definition reflow_render.c:724

reflow_layout_chapter
ra8_err_t reflow_layout_chapter(reflow_t *engine, const uint8_t *xhtml_buf, size_t xhtml_len, uint32_t *out_total_pages)
Parse + lay out one chapter of XHTML.
Definition reflow_layout_driver.c:233

reflow_init
ra8_err_t reflow_init(uint16_t viewport_w, uint16_t viewport_h, const uint8_t *font_data, size_t font_len, uint16_t font_px, uint32_t body_color, uint32_t link_color, reflow_t *out_engine)
Initialise a reflow engine for a given viewport / font.
Definition reflow_layout_driver.c:149

display_cfg_t
Configuration descriptor passed into display_init.
Definition ra8_display_pal.h:240

display_fb_t
Framebuffer descriptor returned by display_get_framebuffer.
Definition ra8_display_pal.h:167

ra8_sdfont_cfg_t
SD-card font-store bus description + provisioning policy.
Definition ra8_sdfont.h:92

reflow_t
Reflow / pagination engine state.
Definition reflow_types.h:448