Horldsence
4f893ce140
两块 ESP32-S3-WROOM-1-N16R8 图传板（DVP 接口接 OV2640/OV3660/OV5640）， 向队伍客户端与裁判终端推 UDP 图传。固件是跑在 ESP-IDF 上的 Rust，用官方 esp32-camera 组件采集；客户端是 Rust + Slint 桌面程序。 三个 crate 各自独立构建： . firmware，交叉编译到 Xtensa protocol/ 线路格式与帧重组，两端共用，无 ESP-IDF 依赖，有单元测试 client/ Slint 桌面客户端 视频走 UDP 而非 TCP：实测传感器产出 22 fps，TCP MJPEG 只送出 1.9 fps， 且只占用链路能力的 1%——链路是空的，帧堵在队头阻塞后面等一个实时画面 等不起的重传计时器。改为独立数据报、不重传、缺片丢整帧后达到 20.8 fps。 发现是双向的：板子每 2 秒广播 Hello，客户端广播 Subscribe，板子据此定向 推流。板子身份由 MAC 派生，重启不变，所以客户端可以把绑定存进配置。 裁判端同时收两块板子（每个发送方一个重组器），队伍端绑定其中一块并只显示 自己那一边的血量。装甲板接口已预留（ArmorSource trait + ARMOR_PORT）， 当前无数据源，界面显示占位符。 vendor 了 esp32-camera 2.1.7：组件注册表的版本求解器找不到它，且需要打一处 补丁（见 components/esp32-camera/target/esp32s3/ll_cam.c）。 .gitignore 三条 target/ 都锚定在根目录，因为 protocol/ 与 client/ 各自也是 独立 crate；而 components/esp32-camera/target/ 是上游的按芯片分目录，里面是 源码，必须保留。
168 lines
6.0 KiB
C
168 lines
6.0 KiB
C
// Copyright 2015-2025 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
#ifndef _IMG_CONVERTERS_H_
|
|
#define _IMG_CONVERTERS_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "esp_camera.h"
|
|
#include "jpeg_decoder.h"
|
|
|
|
typedef size_t (* jpg_out_cb)(void * arg, size_t index, const void* data, size_t len);
|
|
|
|
/**
|
|
* @brief Convert image buffer to JPEG
|
|
*
|
|
* @param src Source buffer in RGB565, RGB888, YUYV or GRAYSCALE format
|
|
* @param src_len Length in bytes of the source buffer
|
|
* @param width Width in pixels of the source image
|
|
* @param height Height in pixels of the source image
|
|
* @param format Format of the source image
|
|
* @param quality JPEG quality of the resulting image
|
|
* @param cp Callback to be called to write the bytes of the output JPEG
|
|
* @param arg Pointer to be passed to the callback
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool fmt2jpg_cb(uint8_t *src, size_t src_len, uint16_t width, uint16_t height, pixformat_t format, uint8_t quality, jpg_out_cb cb, void * arg);
|
|
|
|
/**
|
|
* @brief Convert camera frame buffer to JPEG
|
|
*
|
|
* @param fb Source camera frame buffer
|
|
* @param quality JPEG quality of the resulting image
|
|
* @param cp Callback to be called to write the bytes of the output JPEG
|
|
* @param arg Pointer to be passed to the callback
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool frame2jpg_cb(camera_fb_t * fb, uint8_t quality, jpg_out_cb cb, void * arg);
|
|
|
|
/**
|
|
* @brief Convert image buffer to JPEG buffer
|
|
*
|
|
* @param src Source buffer in RGB565, RGB888, YUYV or GRAYSCALE format
|
|
* @param src_len Length in bytes of the source buffer
|
|
* @param width Width in pixels of the source image
|
|
* @param height Height in pixels of the source image
|
|
* @param format Format of the source image
|
|
* @param quality JPEG quality of the resulting image
|
|
* @param out Pointer to be populated with the address of the resulting buffer.
|
|
* You MUST free the pointer once you are done with it.
|
|
* @param out_len Pointer to be populated with the length of the output buffer
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool fmt2jpg(uint8_t *src, size_t src_len, uint16_t width, uint16_t height, pixformat_t format, uint8_t quality, uint8_t ** out, size_t * out_len);
|
|
|
|
/**
|
|
* @brief Convert camera frame buffer to JPEG buffer
|
|
*
|
|
* @param fb Source camera frame buffer
|
|
* @param quality JPEG quality of the resulting image
|
|
* @param out Pointer to be populated with the address of the resulting buffer
|
|
* @param out_len Pointer to be populated with the length of the output buffer
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool frame2jpg(camera_fb_t * fb, uint8_t quality, uint8_t ** out, size_t * out_len);
|
|
|
|
/**
|
|
* @brief Convert image buffer to BMP buffer
|
|
*
|
|
* @param src Source buffer in JPEG, RGB565, RGB888, YUYV or GRAYSCALE format
|
|
* @param src_len Length in bytes of the source buffer
|
|
* @param width Width in pixels of the source image
|
|
* @param height Height in pixels of the source image
|
|
* @param format Format of the source image
|
|
* @param out Pointer to be populated with the address of the resulting buffer
|
|
* @param out_len Pointer to be populated with the length of the output buffer
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool fmt2bmp(uint8_t *src, size_t src_len, uint16_t width, uint16_t height, pixformat_t format, uint8_t ** out, size_t * out_len);
|
|
|
|
/**
|
|
* @brief Convert camera frame buffer to BMP buffer
|
|
*
|
|
* @param fb Source camera frame buffer
|
|
* @param out Pointer to be populated with the address of the resulting buffer
|
|
* @param out_len Pointer to be populated with the length of the output buffer
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool frame2bmp(camera_fb_t * fb, uint8_t ** out, size_t * out_len);
|
|
|
|
/**
|
|
* @brief Convert image buffer to RGB888 buffer (used for face detection)
|
|
*
|
|
* @param src Source buffer in JPEG, RGB565, RGB888, YUYV or GRAYSCALE format
|
|
* @param src_len Length in bytes of the source buffer
|
|
* @param format Format of the source image
|
|
* @param rgb_buf Pointer to the output buffer (width * height * 3)
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool fmt2rgb888(const uint8_t *src_buf, size_t src_len, pixformat_t format, uint8_t * rgb_buf);
|
|
|
|
// Macros for backwards compatibility
|
|
#define JPG_SCALE_NONE JPEG_IMAGE_SCALE_0
|
|
#define JPG_SCALE_2X JPEG_IMAGE_SCALE_1_2
|
|
#define JPG_SCALE_4X JPEG_IMAGE_SCALE_1_4
|
|
#define JPG_SCALE_8X JPEG_IMAGE_SCALE_1_8
|
|
#define JPG_SCALE_MAX JPEG_IMAGE_SCALE_1_8
|
|
bool jpg2rgb565(const uint8_t *src, size_t src_len, uint8_t * out, esp_jpeg_image_scale_t scale);
|
|
|
|
/**
|
|
* @brief Chroma subsampling modes for JPEG encoding.
|
|
*
|
|
* CHROMA_444: full chroma resolution (4:4:4)
|
|
* CHROMA_422: horizontal chroma subsampling (4:2:2)
|
|
* CHROMA_420: horizontal and vertical subsampling (4:2:0)
|
|
*/
|
|
typedef enum {
|
|
CHROMA_444 = 1,
|
|
CHROMA_422 = 2,
|
|
CHROMA_420 = 3
|
|
} chroma_t;
|
|
|
|
/**
|
|
* @brief Set default chroma subsampling mode for JPEG encoding.
|
|
*
|
|
* @param chroma Chroma subsampling mode (CHROMA_444, CHROMA_422, CHROMA_420)
|
|
*/
|
|
void jpgSetChroma(chroma_t chroma);
|
|
|
|
/**
|
|
* @brief Configure RGB565 input byte order for JPEG encoding.
|
|
*
|
|
* Controls how RGB565 source pixel data is interpreted before JPEG conversion.
|
|
* By default, the encoder assumes big-endian byte order (MSB first), which
|
|
* matches most ESP32 camera and frame buffer outputs.
|
|
*
|
|
* @param enable True to use big-endian RGB565 (default), false for little-endian.
|
|
*/
|
|
void jpgSetRgb565BE(bool enable);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _IMG_CONVERTERS_H_ */
|