Codex 69521e54e0 Add 15 embedded repair tasks and correct grader-read controls
Complete batch 20261016-C-embedded-2: 45 verified GLM/Pi samples, independent regrades and archives; preserve difficulty misses and Salty blockage.
2026-10-16 14:23:48 +08:00

102 lines
3.0 KiB
C

#ifndef LAB_H
#define LAB_H
#include <stddef.h>
#include <stdint.h>
#define DMA_LIMIT 64u
#define DMA_SEGMENT 7u
typedef struct {
unsigned token;
unsigned offset;
unsigned length;
unsigned total;
unsigned valid;
} dma_descriptor;
typedef struct {
unsigned id;
unsigned length;
} request_t;
typedef struct {
unsigned operation;
dma_descriptor programmed;
unsigned enabled;
unsigned program_count;
unsigned abort_count;
unsigned cache_count;
unsigned callback_count;
unsigned last_cache_offset;
unsigned last_cache_length;
} registers_t;
typedef struct {
unsigned completed;
unsigned cancelled;
unsigned failed;
unsigned rejected;
unsigned stale;
} counters_t;
typedef struct {
registers_t *registers;
request_t request;
unsigned active;
unsigned token;
unsigned offset;
unsigned chunk;
dma_descriptor descriptor;
counters_t counters;
} driver_t;
typedef struct {
unsigned id;
unsigned token;
unsigned offset;
unsigned chunk;
counters_t counters;
} snapshot_t;
typedef struct {
unsigned token;
unsigned amount;
unsigned error;
} completion_t;
void descriptor_reset(dma_descriptor *descriptor);
unsigned descriptor_build(dma_descriptor *descriptor, unsigned token,
unsigned offset, unsigned total);
unsigned descriptor_length(const dma_descriptor *descriptor);
unsigned descriptor_offset(const dma_descriptor *descriptor);
unsigned descriptor_token(const dma_descriptor *descriptor);
unsigned descriptor_matches(const driver_t *driver, unsigned token);
unsigned descriptor_remaining(const driver_t *driver);
void descriptor_program(driver_t *driver);
void descriptor_clear(driver_t *driver);
void descriptor_advance(driver_t *driver, unsigned amount);
void token_advance(driver_t *driver);
typedef enum {
COMPLETION_IDLE,
COMPLETION_STALE,
COMPLETION_INVALID,
COMPLETION_READY
} completion_class;
completion_class completion_classify(const driver_t *driver, const completion_t *completion);
unsigned completion_valid(const driver_t *driver, const completion_t *completion);
void completion_accept(driver_t *driver, const completion_t *completion);
void driver_finish(driver_t *driver, unsigned result);
void reg_init(registers_t *registers);
void reg_program(registers_t *registers, const dma_descriptor *descriptor);
void reg_abort(registers_t *registers, unsigned token);
void reg_cache(registers_t *registers, unsigned offset, unsigned amount);
void reg_done(registers_t *registers, unsigned id, unsigned result);
void reg_reject(registers_t *registers, unsigned id);
void reg_state(const registers_t *registers, const driver_t *driver);
void driver_init(driver_t *driver, registers_t *registers);
void driver_submit(driver_t *driver, const request_t *request);
void driver_complete(driver_t *driver, unsigned token, unsigned amount, unsigned error);
void driver_cancel(driver_t *driver, unsigned id);
void driver_snapshot(const driver_t *driver, snapshot_t *snapshot);
#endif