ra8_sdfont_cfg_t Struct Reference

SD-card font-store bus description + provisioning policy. More...

#include <ra8_sdfont.h>

Data Fields
uint8_t	spi_channel
	SCI channel in Simple-SPI mode (Pmod2 = SCI0 = 0).
ra8_port_pin_t	sck
	SPI clock pin.
ra8_port_pin_t	cipo
	Controller-In / Peripheral-Out pin.
ra8_port_pin_t	copi
	Controller-Out / Peripheral-In pin.
ra8_port_pin_t	cs
	Chip-select pin, driven as a GPIO output.
uint32_t	pclka_hz
	PCLKA rate (Hz) feeding the SCI baud divider.
const char *	filename
	8.3 file to load; NULL selects "FONT.OTF".
const uint8_t *	provision_blob
	Fallback font written if the file is absent; NULL disables provisioning (read-only load).
uint32_t	provision_len
	Length of provision_blob in bytes.

Detailed Description

SD-card font-store bus description + provisioning policy.

Describes the SCI Simple-SPI bus the SD card sits on and the fallback font used for self-provisioning. The chip-select pin is driven as a plain GPIO output because SD SPI-mode holds CS asserted across a whole command + data trailer, which the SCI hardware chip-select controller (which pulses per word) cannot do.

Invariant

sck, cipo, copi, cs are four distinct pins.

When provision_blob is non-NULL, provision_len > 0.

See also

ra8_sdfont_load

Since

0.1.0

Definition at line 92 of file ra8_sdfont.h.

Field Documentation

cipo

ra8_port_pin_t ra8_sdfont_cfg_t::cipo

Controller-In / Peripheral-Out pin.

Definition at line 95 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

copi

ra8_port_pin_t ra8_sdfont_cfg_t::copi

Controller-Out / Peripheral-In pin.

Definition at line 96 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

cs

ra8_port_pin_t ra8_sdfont_cfg_t::cs

Chip-select pin, driven as a GPIO output.

Definition at line 97 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

filename

const char* ra8_sdfont_cfg_t::filename

8.3 file to load; NULL selects "FONT.OTF".

Definition at line 99 of file ra8_sdfont.h.

Referenced by ra8_sdfont_load().

pclka_hz

uint32_t ra8_sdfont_cfg_t::pclka_hz

PCLKA rate (Hz) feeding the SCI baud divider.

Definition at line 98 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

provision_blob

const uint8_t* ra8_sdfont_cfg_t::provision_blob

Fallback font written if the file is absent; NULL disables provisioning (read-only load).

Definition at line 100 of file ra8_sdfont.h.

Referenced by internal_open_or_provision().

provision_len

uint32_t ra8_sdfont_cfg_t::provision_len

Length of provision_blob in bytes.

Definition at line 102 of file ra8_sdfont.h.

Referenced by internal_open_or_provision().

sck

ra8_port_pin_t ra8_sdfont_cfg_t::sck

SPI clock pin.

Definition at line 94 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

spi_channel

uint8_t ra8_sdfont_cfg_t::spi_channel

SCI channel in Simple-SPI mode (Pmod2 = SCI0 = 0).

Definition at line 93 of file ra8_sdfont.h.

Referenced by internal_bringup_spi().

---

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

• libs/ra8_sdfont/inc/ra8_sdfont.h