hpm_jpeg.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 HPMicro
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */
#ifndef __HPM_JPEG_H
#define __HPM_JPEG_H
 
#include <stdint.h>
#include <string.h>
#include <stdio.h>
 
#ifndef HPM_JPEG_LOG_LEVEL
#define HPM_JPEG_LOG_LEVEL HPM_JPEG_LOG_LEVEL_WARN
#endif
 
#define HPM_JPEG_LOG_LEVEL_DEBUG 4
#define HPM_JPEG_LOG_LEVEL_INFO  3
#define HPM_JPEG_LOG_LEVEL_WARN  2
#define HPM_JPEG_LOG_LEVEL_ERR   1
 
#define HPM_JPEG_PRINTF(fmt, ...) printf(fmt, ##__VA_ARGS__);
 
#if HPM_JPEG_LOG_LEVEL >= HPM_JPEG_LOG_LEVEL_DEBUG
#define HPM_JPEG_DLOG(fmt, ...) ({\
    printf("HPM_JPEG: [D: %s:%u]: ", __func__, __LINE__);\
    printf(fmt, ##__VA_ARGS__);\
})
#else
#define HPM_JPEG_DLOG(fmt, ...)
#endif
 
#if HPM_JPEG_LOG_LEVEL >= HPM_JPEG_LOG_LEVEL_INFO
#define HPM_JPEG_ILOG(fmt, ...) ({\
    printf("HPM_JPEG: [I: %s:%u]: ", __func__, __LINE__);\
    printf(fmt, ##__VA_ARGS__);\
})
#else
#define HPM_JPEG_ILOG(fmt, ...)
#endif
 
#if HPM_JPEG_LOG_LEVEL >= HPM_JPEG_LOG_LEVEL_WARN
#define HPM_JPEG_WLOG(fmt, ...) ({\
    printf("HPM_JPEG: [W: %s:%u]: ", __func__, __LINE__);\
    printf(fmt, ##__VA_ARGS__);\
})
#else
#define HPM_JPEG_WLOG(fmt, ...)
#endif
 
#if HPM_JPEG_LOG_LEVEL >= HPM_JPEG_LOG_LEVEL_ERR
#define HPM_JPEG_ELOG(fmt, ...) ({\
    printf("HPM_JPEG: [E: %s:%u]: ", __func__, __LINE__);\
    printf(fmt, ##__VA_ARGS__);\
})
#else
#define HPM_JPEG_ELOG(fmt, ...)
#endif
 
#define HPM_JPEG_RET_OK               0
#define HPM_JPEG_RET_MALLOC_ERR      -1
#define HPM_JPEG_RET_PARA_ERR        -2
#define HPM_JPEG_RET_JPEG_FILE_ERROR -3
#define HPM_JPEG_RET_STATUS_ERR      -4
#define HPM_JPEG_RET_MARKER_ERR      -5
 
typedef void hpm_jpeg_job_t;
 
typedef enum hpm_jpeg_sampling_format {
    HPM_JPEG_SAMPLING_FORMAT_420 = 0, 
    HPM_JPEG_SAMPLING_FORMAT_422H,    
    HPM_JPEG_SAMPLING_FORMAT_422V,    
    HPM_JPEG_SAMPLING_FORMAT_444,     
    HPM_JPEG_SAMPLING_FORMAT_400,     
} hpm_jpeg_sampling_format_t;
 
typedef enum hpm_jpeg_image_format {
    HPM_JPEG_IMAGE_FORMAT_RGB565,   
    HPM_JPEG_IMAGE_FORMAT_ARGB8888, 
    HPM_JPEG_IMAGE_FORMAT_BGRA8888, 
    HPM_JPEG_IMAGE_FORMAT_YUYV422,  
    HPM_JPEG_IMAGE_FORMAT_UYVY422,  
    HPM_JPEG_IMAGE_FORMAT_Y8,       
} hpm_jpeg_image_format_t;
 
typedef struct hpm_jpeg_image {
    void *image_buf;
    enum hpm_jpeg_image_format format;
    uint32_t width;  
    uint32_t height; 
    uint32_t stride; 
} hpm_jpeg_image_t;
 
typedef struct hpm_jpeg_jpeg_file {
    void *jpeg_buf;
    uint32_t len;
} hpm_jpeg_file_t;
 
typedef enum hpm_jpeg_job_status {
    HPM_JPEG_JOB_STATUS_ALLOCED = 0,
    HPM_JPEG_JOB_STATUS_FILLING,
    HPM_JPEG_JOB_STATUS_FILL_FAILED,
    HPM_JPEG_JOB_STATUS_FILLED,
    HPM_JPEG_JOB_STATUS_STARTING,
    HPM_JPEG_JOB_STATUS_START_FAILED,
    HPM_JPEG_JOB_STATUS_WAITING,
    HPM_JPEG_JOB_STATUS_PROCESSING,
    HPM_JPEG_JOB_STATUS_FINISHED,
    HPM_JPEG_JOB_STATUS_STOPPED,
    HPM_JPEG_JOB_STATUS_ERROR
} hpm_jpeg_job_status_t;
 
typedef struct hpm_jpeg_decode_info {
    uint32_t hw_status;
    hpm_jpeg_job_status_t status;
    const hpm_jpeg_image_t *image;
} hpm_jpeg_decode_info_t;
 
typedef struct hpm_jpeg_encode_info {
    uint32_t hw_status;
    hpm_jpeg_job_status_t status;
    const hpm_jpeg_file_t *file;
} hpm_jpeg_encode_info_t;
 
typedef struct hpm_jpeg_decode_cfg {
    hpm_jpeg_image_format_t out_format;
    uint32_t out_image_stride; 
} hpm_jpeg_decode_cfg_t;
 
typedef struct hpm_jpeg_encode_cfg {
    hpm_jpeg_sampling_format_t jpeg_sampling;
    uint32_t jpeg_quality; 
} hpm_jpeg_encode_cfg_t;
 
typedef void (*hpm_jpeg_job_state_cb_t)(hpm_jpeg_job_t *job);
 
typedef struct hpm_jpeg_cfg {
    void *jpeg_base;
    void * (*malloc)(uint32_t size);
    void (*free)(void *p);
    uint32_t cache_line_size;
    void (*cache_writeback)(void *start, uint32_t size);
    void (*cache_invalidate)(void *start, uint32_t size);
} hpm_jpeg_cfg_t;
 
int hpm_jpeg_init(hpm_jpeg_cfg_t *cfg);
 
int hpm_jpeg_deinit(void);
 
void hpm_jpeg_isr(void);
 
hpm_jpeg_job_t *hpm_jpeg_decode_job_alloc(hpm_jpeg_decode_cfg_t *cfg);
 
int hpm_jpeg_decode_job_fill_file(hpm_jpeg_job_t *job, const hpm_jpeg_file_t *file, int direct);
 
int hpm_jpeg_decode_job_force_direct_image_buf(hpm_jpeg_job_t *job, void *buf, uint32_t len);
 
int hpm_jpeg_decode_job_start(hpm_jpeg_job_t *job, hpm_jpeg_job_state_cb_t cb);
 
int hpm_jpeg_decode_job_stop(hpm_jpeg_job_t *job);
 
int hpm_jpeg_decode_job_get_info(hpm_jpeg_job_t *job, hpm_jpeg_decode_info_t *info);
 
int hpm_jpeg_decode_job_free(hpm_jpeg_job_t *job);
 
hpm_jpeg_job_t *hpm_jpeg_encode_job_alloc(hpm_jpeg_encode_cfg_t *cfg);
 
int hpm_jpeg_encode_job_fill_image(hpm_jpeg_job_t *job, const hpm_jpeg_image_t *image, int direct);
 
int hpm_jpeg_encode_job_force_direct_file_buf(hpm_jpeg_job_t *job, void *buf, uint32_t len);
 
int hpm_jpeg_encode_job_start(hpm_jpeg_job_t *job, hpm_jpeg_job_state_cb_t cb);
 
int hpm_jpeg_encode_job_stop(hpm_jpeg_job_t *job);
 
int hpm_jpeg_encode_job_get_info(hpm_jpeg_job_t *job, hpm_jpeg_encode_info_t *info);
 
int hpm_jpeg_encode_job_free(hpm_jpeg_job_t *job);
 
void hpm_jpeg_job_set_user_data(hpm_jpeg_job_t *job, void *user_data);
 
void *hpm_jpeg_job_get_user_data(hpm_jpeg_job_t *job);
 
#endif