379 lines
15 KiB
C
379 lines
15 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#include "esp_err.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// ---------- system_runtime ----------
|
|
esp_err_t system_runtime_start(void);
|
|
esp_err_t system_runtime_shutdown(void);
|
|
esp_err_t system_runtime_bootstrap(void);
|
|
|
|
bool system_runtime_wifi_ready(void);
|
|
void system_runtime_get_ip(char *buf, size_t buf_len);
|
|
|
|
// ---------- domain_policy ----------
|
|
uint32_t domain_policy_lifecycle_start_retry_count(void);
|
|
uint32_t domain_policy_lifecycle_retry_backoff_ms(uint32_t attempt);
|
|
bool domain_policy_is_retryable_error(esp_err_t err);
|
|
|
|
uint32_t domain_policy_printer_stop_timeout_ms(void);
|
|
|
|
uint32_t domain_policy_rest_printer_connect_timeout_ms(void);
|
|
uint32_t domain_policy_rest_printer_connect_timeout_min_ms(void);
|
|
uint32_t domain_policy_rest_printer_connect_timeout_max_ms(void);
|
|
|
|
uint32_t domain_policy_rest_label_timeout_ms(void);
|
|
uint32_t domain_policy_rest_label_timeout_min_ms(void);
|
|
uint32_t domain_policy_rest_label_timeout_max_ms(void);
|
|
|
|
uint32_t domain_policy_rest_ota_timeout_ms(void);
|
|
uint32_t domain_policy_rest_ota_timeout_min_ms(void);
|
|
uint32_t domain_policy_rest_ota_timeout_max_ms(void);
|
|
|
|
uint32_t domain_policy_image_generation_timeout_default_ms(void);
|
|
uint32_t domain_policy_image_generation_timeout_min_ms(void);
|
|
uint32_t domain_policy_image_generation_timeout_max_ms(void);
|
|
|
|
uint32_t domain_policy_image_download_timeout_default_ms(void);
|
|
uint32_t domain_policy_image_download_timeout_min_ms(void);
|
|
uint32_t domain_policy_image_download_timeout_max_ms(void);
|
|
|
|
// ---------- domain_diagnostics ----------
|
|
typedef enum {
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_START_ATTEMPT = 0,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_START_SUCCESS,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_START_FAILED,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_START_RETRY,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_STOP_ATTEMPT,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_STOP_SUCCESS,
|
|
DOMAIN_DIAG_COUNTER_LIFECYCLE_STOP_FAILED,
|
|
DOMAIN_DIAG_COUNTER_WIFI_CONNECT_SUCCESS,
|
|
DOMAIN_DIAG_COUNTER_WIFI_CONNECT_FAILED,
|
|
DOMAIN_DIAG_COUNTER_WIFI_CONNECT_TIMEOUT,
|
|
DOMAIN_DIAG_COUNTER_PRINTER_JOB_SUBMITTED,
|
|
DOMAIN_DIAG_COUNTER_PRINTER_JOB_SUCCESS,
|
|
DOMAIN_DIAG_COUNTER_PRINTER_JOB_FAILED,
|
|
DOMAIN_DIAG_COUNTER_PRINTER_JOB_CANCELED,
|
|
DOMAIN_DIAG_COUNTER_IMAGE_GENERATE_ATTEMPT,
|
|
DOMAIN_DIAG_COUNTER_IMAGE_GENERATE_SUCCESS,
|
|
DOMAIN_DIAG_COUNTER_IMAGE_GENERATE_FAILED,
|
|
DOMAIN_DIAG_COUNTER_IMAGE_GENERATE_TIMEOUT,
|
|
DOMAIN_DIAG_COUNTER_REST_RESPONSES_TOTAL,
|
|
DOMAIN_DIAG_COUNTER_REST_ERRORS_TOTAL,
|
|
DOMAIN_DIAG_COUNTER_MAX,
|
|
} domain_diag_counter_t;
|
|
|
|
typedef enum {
|
|
DOMAIN_DIAG_GAUGE_LIFECYCLE_STATE = 0,
|
|
DOMAIN_DIAG_GAUGE_STATUS_POLL_PAUSE_DEPTH,
|
|
DOMAIN_DIAG_GAUGE_PRINTER_QUEUE_DEPTH,
|
|
DOMAIN_DIAG_GAUGE_MAX,
|
|
} domain_diag_gauge_t;
|
|
|
|
typedef struct {
|
|
uint64_t counters[DOMAIN_DIAG_COUNTER_MAX];
|
|
int32_t gauges[DOMAIN_DIAG_GAUGE_MAX];
|
|
int64_t last_error_ms;
|
|
esp_err_t last_error_code;
|
|
char last_error_source[32];
|
|
char last_error_message[96];
|
|
} domain_diag_snapshot_t;
|
|
|
|
void domain_diag_counter_add(domain_diag_counter_t counter, uint32_t delta);
|
|
void domain_diag_set_gauge(domain_diag_gauge_t gauge, int32_t value);
|
|
void domain_diag_record_error(const char *source, esp_err_t code, const char *message);
|
|
void domain_diag_get_snapshot(domain_diag_snapshot_t *out_snapshot);
|
|
const char *domain_diag_counter_name(domain_diag_counter_t counter);
|
|
const char *domain_diag_gauge_name(domain_diag_gauge_t gauge);
|
|
|
|
// ---------- raster_tools ----------
|
|
esp_err_t raster_tools_render_text_384(const char *text,
|
|
uint8_t scale,
|
|
uint8_t line_spacing,
|
|
uint16_t max_height,
|
|
uint16_t *out_width,
|
|
uint16_t *out_height,
|
|
uint8_t **out_raster,
|
|
size_t *out_len,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
esp_err_t raster_tools_convert_gray8_to_raster_384(const uint8_t *gray,
|
|
uint16_t src_width,
|
|
uint16_t src_height,
|
|
bool scale_to_width,
|
|
uint8_t threshold,
|
|
bool invert,
|
|
uint16_t max_height,
|
|
uint16_t *out_width,
|
|
uint16_t *out_height,
|
|
uint8_t **out_raster,
|
|
size_t *out_len,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
esp_err_t raster_tools_convert_png_to_raster_384(const uint8_t *png,
|
|
size_t png_len,
|
|
bool scale_to_width,
|
|
uint8_t threshold,
|
|
bool invert,
|
|
uint16_t max_height,
|
|
uint16_t *out_width,
|
|
uint16_t *out_height,
|
|
uint8_t **out_raster,
|
|
size_t *out_len,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
esp_err_t raster_tools_render_qr_384(const char *text,
|
|
uint8_t module_scale,
|
|
uint8_t margin_modules,
|
|
uint8_t ecc_level,
|
|
uint16_t max_height,
|
|
uint16_t *out_width,
|
|
uint16_t *out_height,
|
|
uint8_t **out_raster,
|
|
size_t *out_len,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
// ---------- image_generation ----------
|
|
typedef struct {
|
|
const char *prompt;
|
|
const char *size;
|
|
bool prompt_extend;
|
|
bool has_seed;
|
|
uint32_t seed;
|
|
uint32_t generation_timeout_ms;
|
|
uint32_t download_timeout_ms;
|
|
} image_generation_request_t;
|
|
|
|
typedef struct {
|
|
uint8_t *png;
|
|
size_t png_len;
|
|
char image_url[1024];
|
|
char output_prompt[256];
|
|
char request_id[80];
|
|
uint16_t width;
|
|
uint16_t height;
|
|
} image_generation_result_t;
|
|
|
|
void image_generation_result_reset(image_generation_result_t *result);
|
|
void image_generation_result_free(image_generation_result_t *result);
|
|
void image_generation_schedule_prewarm(void);
|
|
|
|
esp_err_t image_generation_generate_png(const image_generation_request_t *req,
|
|
image_generation_result_t *out_result,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
// ---------- screen_preview ----------
|
|
esp_err_t screen_preview_show_raster(const uint8_t *raster,
|
|
size_t raster_len,
|
|
uint16_t width,
|
|
uint16_t height,
|
|
uint32_t timeout_ms,
|
|
char *err,
|
|
size_t err_len);
|
|
esp_err_t screen_preview_show_png(const uint8_t *png,
|
|
size_t png_len,
|
|
uint32_t timeout_ms,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
// ---------- printer_protocol ----------
|
|
typedef enum {
|
|
PRINT_JOB_STATE_NONE = 0,
|
|
PRINT_JOB_STATE_QUEUED,
|
|
PRINT_JOB_STATE_RUNNING,
|
|
PRINT_JOB_STATE_SUCCESS,
|
|
PRINT_JOB_STATE_FAILED,
|
|
PRINT_JOB_STATE_CANCELED,
|
|
} print_job_state_t;
|
|
|
|
typedef struct {
|
|
uint32_t id;
|
|
print_job_state_t state;
|
|
uint8_t progress;
|
|
uint16_t width;
|
|
uint16_t height;
|
|
size_t data_len;
|
|
char density[16];
|
|
char error[96];
|
|
int64_t created_ms;
|
|
int64_t started_ms;
|
|
int64_t finished_ms;
|
|
} print_job_info_t;
|
|
|
|
typedef struct {
|
|
uint8_t major;
|
|
uint8_t minor;
|
|
uint8_t patch;
|
|
} printer_ota_version_t;
|
|
|
|
typedef enum {
|
|
PRINTER_BACKEND_DIRECT = 0,
|
|
} printer_backend_t;
|
|
|
|
typedef struct {
|
|
printer_backend_t backend;
|
|
const char *name;
|
|
uint32_t timeout_ms;
|
|
} printer_connect_options_t;
|
|
|
|
typedef struct {
|
|
// Direct backend only: bypass paper/temp/battery precheck for this print job.
|
|
bool direct_ignore_precheck;
|
|
} printer_print_options_t;
|
|
|
|
typedef struct {
|
|
uint16_t shift_clock_high_us;
|
|
uint16_t shift_clock_low_us;
|
|
uint16_t latch_pulse_us;
|
|
bool strobe_active_high;
|
|
bool boost_active_high;
|
|
uint16_t override_strobe_on_us;
|
|
uint16_t override_strobe_interval_us;
|
|
uint16_t override_motor_step_us;
|
|
uint8_t override_steps_per_line;
|
|
} printer_direct_debug_config_t;
|
|
|
|
typedef struct {
|
|
bool supports_connect;
|
|
bool supports_gap_move;
|
|
bool supports_label_offset;
|
|
bool supports_ota;
|
|
} printer_capabilities_t;
|
|
|
|
typedef struct {
|
|
printer_backend_t backend;
|
|
bool connected;
|
|
bool transport_ready;
|
|
bool busy;
|
|
bool has_paper;
|
|
int8_t paper_gpio_level;
|
|
uint8_t paper_present_level;
|
|
uint8_t battery_percent;
|
|
float temperature;
|
|
bool supports_gap_move;
|
|
bool supports_label_offset;
|
|
bool supports_ota;
|
|
uint32_t queue_depth;
|
|
int64_t last_status_ms;
|
|
} printer_runtime_status_t;
|
|
|
|
typedef uint32_t printer_status_poll_pause_token_t;
|
|
|
|
esp_err_t printer_protocol_init(void);
|
|
esp_err_t printer_protocol_stop(uint32_t timeout_ms);
|
|
|
|
esp_err_t printer_protocol_set_backend(printer_backend_t backend, char *err, size_t err_len);
|
|
printer_backend_t printer_protocol_get_backend(void);
|
|
|
|
esp_err_t printer_protocol_connect(const char *target_name, uint32_t timeout_ms);
|
|
esp_err_t printer_protocol_connect_ex(const printer_connect_options_t *opt, char *err, size_t err_len);
|
|
void printer_protocol_disconnect(void);
|
|
void printer_protocol_get_capabilities(printer_capabilities_t *out_capabilities);
|
|
esp_err_t printer_protocol_get_direct_debug_config(printer_direct_debug_config_t *out_config,
|
|
char *err,
|
|
size_t err_len);
|
|
esp_err_t printer_protocol_set_direct_debug_config(const printer_direct_debug_config_t *config,
|
|
bool reset_defaults,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
void printer_protocol_get_runtime_status(printer_runtime_status_t *out_status);
|
|
printer_status_poll_pause_token_t printer_protocol_status_poll_pause_acquire(void);
|
|
void printer_protocol_status_poll_pause_release(printer_status_poll_pause_token_t *token);
|
|
|
|
esp_err_t printer_protocol_submit_raster_job(const uint8_t *raster,
|
|
size_t raster_len,
|
|
uint16_t width,
|
|
uint16_t height,
|
|
const char *density,
|
|
uint32_t *out_job_id,
|
|
char *err,
|
|
size_t err_len);
|
|
esp_err_t printer_protocol_submit_raster_job_ex(const uint8_t *raster,
|
|
size_t raster_len,
|
|
uint16_t width,
|
|
uint16_t height,
|
|
const char *density,
|
|
const printer_print_options_t *options,
|
|
uint32_t *out_job_id,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
bool printer_protocol_get_job(uint32_t job_id, print_job_info_t *out_info);
|
|
esp_err_t printer_protocol_list_jobs(print_job_info_t *out_jobs, size_t max_jobs, size_t *out_count);
|
|
esp_err_t printer_protocol_cancel_job(uint32_t job_id, char *err, size_t err_len);
|
|
size_t printer_protocol_cleanup_jobs(bool include_success, bool include_failed, bool include_canceled);
|
|
|
|
esp_err_t printer_protocol_gap_move(uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t printer_protocol_get_label_offset(uint8_t *out_offset, uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t printer_protocol_set_label_offset(uint8_t offset, uint32_t timeout_ms, char *err, size_t err_len);
|
|
|
|
esp_err_t printer_protocol_ota_jump_boot(uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t printer_protocol_ota_jump_app(uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t printer_protocol_ota_erase_page(uint16_t page_num, uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t printer_protocol_ota_write_frame(uint16_t packet_num,
|
|
bool is_last_frame,
|
|
const uint8_t *data,
|
|
size_t data_len,
|
|
uint32_t timeout_ms,
|
|
char *err,
|
|
size_t err_len);
|
|
esp_err_t printer_protocol_ota_get_version(printer_ota_version_t *out_version,
|
|
uint32_t timeout_ms,
|
|
char *err,
|
|
size_t err_len);
|
|
|
|
const char *printer_protocol_job_state_str(print_job_state_t state);
|
|
|
|
// ---------- voice_interaction ----------
|
|
typedef enum {
|
|
VOICE_DIALOG_STATE_IDLE = 0,
|
|
VOICE_DIALOG_STATE_LISTENING,
|
|
VOICE_DIALOG_STATE_THINKING,
|
|
VOICE_DIALOG_STATE_RESPONDING,
|
|
} voice_dialog_state_t;
|
|
|
|
typedef struct {
|
|
bool ready;
|
|
bool session_active;
|
|
bool ws_connected;
|
|
bool started;
|
|
bool tap_active;
|
|
bool marker_image_gen_running;
|
|
voice_dialog_state_t dialog_state;
|
|
char task_id[40];
|
|
char dialog_id[40];
|
|
char last_error[128];
|
|
int64_t last_event_ms;
|
|
uint32_t upstream_packets;
|
|
uint32_t downstream_packets;
|
|
} voice_interaction_status_t;
|
|
|
|
esp_err_t voice_interaction_init(void);
|
|
esp_err_t voice_interaction_start_with_timeout(uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t voice_interaction_start(char *err, size_t err_len);
|
|
esp_err_t voice_interaction_stop_with_timeout(uint32_t timeout_ms, char *err, size_t err_len);
|
|
esp_err_t voice_interaction_stop(char *err, size_t err_len);
|
|
|
|
esp_err_t voice_interaction_tap_start(char *err, size_t err_len);
|
|
esp_err_t voice_interaction_tap_cancel(char *err, size_t err_len);
|
|
|
|
void voice_interaction_get_status(voice_interaction_status_t *out_status);
|
|
const char *voice_interaction_dialog_state_str(voice_dialog_state_t state);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|