Oversized-page tile self-check for ereader_comic (#344). More...

#include "cm_tiled_check.h"
#include <stddef.h>
#include <stdint.h>
#include <string.h>
#include "comic.h"
#include "comic_large_fixture.h"
#include "comic_tiles.h"
#include "jof.h"
#include "jof_produce.h"
#include "ra8_err.h"
#include "ra8_tile_cache.h"

Include dependency graph for cm_tiled_check.c:

Data Structures
struct	cm_ct_blob_t
	Resident-buffer backing for the comic reader's seek+read seam. More...

Enumerations
enum	cm_tiled_cfg_t : uint32_t { k_ct_tile = 256U , k_ct_bpp_gray = 1U , k_ct_cell_bytes = k_ct_tile * k_ct_tile * k_ct_bpp_gray , k_ct_cells = 8U , k_ct_buckets = 16U , k_ct_budget = 2U * 1024U * 1024U , k_ct_pagebuf = 64U * 1024U , k_ct_work = 2U * 1024U * 1024U , k_ct_atlas = 2U * 1024U * 1024U , k_ct_scratch = 96U * 1024U , k_ct_page_cap = 4U , k_ct_name_cap = 64U , k_ct_fnv_offset = 2166136261U , k_ct_fnv_prime = 16777619U }
	Tile geometry, cache budget, and hashing constants for the self-check. More...

Functions
static size_t	cm_ct_read (void ctx, uint64_t off, void buf, size_t len)
	comic_read_fn over the resident CBZ blob (bounds-clamped).
static uint32_t	cm_ct_fnv (uint32_t h, const uint8_t *p, size_t n)
	FNV-1a-32 folding `n` bytes of `p` into the running hash `h`.
static bool	cm_ct_open (size_t *out_got)
	Open the baked oversized CBZ and read page 0's encoded bytes.
static bool	cm_ct_hash_tiles (const jof_info_t info, uint32_t out_crc)
	Decode every tile of the bound atlas, FNV-hashing the pixels.
static ra8_tile_cache_cfg_t	cm_ct_cache_cfg (void)
	Tile-cache storage config over the file-static cache buffers.
cm_tiled_result_t	cm_comic_tiled_selfcheck (void)
	Open the baked oversized page through the tile path and digest it.

Variables
static uint8_t	s_ct_pagebuf [k_ct_pagebuf]
	SDRAM: encoded page scratch (the tile producer's input).
static uint8_t	s_ct_work [k_ct_work]
	SDRAM: producer streaming work arena.
static uint8_t	s_ct_atlas [k_ct_atlas]
	SDRAM: produced JOF atlas backing store.
static uint8_t	s_ct_cells [(size_t) k_ct_cells *(size_t) k_ct_cell_bytes]
	SDRAM: tile-cache cell storage.
static uint8_t	s_ct_scratch [k_ct_scratch]
	SDRAM: stored-tile staging for deflate tiles.
static comic_page_t	s_ct_pages [k_ct_page_cap]
	SDRAM: comic page-index storage.
static char	s_ct_names [k_ct_name_cap]
	SDRAM: comic name arena.
static comic_t	s_ct_comic
	SDRAM: the open comic reader.
static comic_tile_reader_t	s_ct_reader
	SDRAM: the comic tile reader.
static ra8_tile_key_t	s_ct_keys [k_ct_cells]
	Tile-cache key storage.
static ra8_tile_dims_t	s_ct_dims [k_ct_cells]
	Tile-cache dimension descriptors.
static ra8_keycache_cell_t	s_ct_meta [k_ct_cells]
	Tile-cache link metadata.
static int32_t	s_ct_buckets [k_ct_buckets]
	Tile-cache hash buckets.
static cm_ct_blob_t	s_ct_blob
	Blob backing bound into the read seam.

Detailed Description

Oversized-page tile self-check for ereader_comic (#344).

Tag: [Ring 7 / App] {World: NS}

Opens the baked oversized single-page CBZ (k_comic_large_cbz), confirms its decoded footprint overruns the whole-decode budget, transcodes the page to a JOF atlas through comic_tiles_import, and decodes every tile of the atlas in bounded RAM, FNV-hashing the decoded pixels. The result feeds a deterministic boot banner field that pins the fix on device (ra8_emulator / silicon). Every buffer is file-static SDRAM – no heap (NASA P10 Rule 3) – and the panel framebuffer is never touched, so the reader's page-1 render is undisturbed.

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file cm_tiled_check.c.

Enumeration Type Documentation

◆ cm_tiled_cfg_t

enum cm_tiled_cfg_t : uint32_t

Tile geometry, cache budget, and hashing constants for the self-check.

Grayscale 256x256 tiles (1 bpp -> 64 KiB cells); an 8-cell cache is far smaller than the multi-MiB decoded page, so decode-on-demand paging is genuinely exercised. The budget matches the reader's whole-decode arena so the footprint decision mirrors the live path.

Since: 0.1.0

Enumerator
k_ct_tile	Square tile edge, pixels.
k_ct_bpp_gray	Grayscale atlas bytes per pixel.
k_ct_cell_bytes	Bytes per cache cell.
k_ct_cells	Tile-cache cell budget.
k_ct_buckets	Tile-cache hash buckets.
k_ct_budget	Whole-decode budget (threshold).
k_ct_pagebuf	Encoded page scratch, bytes.
k_ct_work	Producer work arena, bytes.
k_ct_atlas	Atlas memstore backing, bytes.
k_ct_scratch	Stored-tile staging, bytes.
k_ct_page_cap	Comic page-index capacity.
k_ct_name_cap	Comic name-arena bytes.
k_ct_fnv_offset	FNV-1a-32 offset basis.
k_ct_fnv_prime	FNV-1a-32 prime.

Definition at line 46 of file cm_tiled_check.c.

Function Documentation

◆ cm_comic_tiled_selfcheck()

cm_tiled_result_t cm_comic_tiled_selfcheck ( void )

Open the baked oversized page through the tile path and digest it.

Opens k_comic_large_cbz with comic, confirms page 0's decoded footprint exceeds the whole-decode budget, transcodes it to a JOF atlas via comic_tiles_import, and decodes every tile through the owned tile cache, FNV-hashing the decoded pixels. All storage is file-static SDRAM (no heap); the panel framebuffer is never touched, so the reader's page-1 render is undisturbed.