Complete batch 20261016-C-embedded-2: 45 verified GLM/Pi samples, independent regrades and archives; preserve difficulty misses and Salty blockage.
102 lines
3.0 KiB
C
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
|