codec.h File Reference

T-Box 编解码辅助接口 More...

#include <stddef.h>
#include <stdint.h>

Go to the source code of this file.

Functions
uint8_t	tbox_codec_decimal_to_bcd (uint8_t decimal)
	将十进制数转换为 BCD 码。
uint8_t	tbox_codec_bcd_to_decimal (uint8_t bcd)
	将 BCD 码转换为十进制数。
int	tbox_codec_bytes_to_hex (const uint8_t *in, size_t in_len, char *out, size_t out_size)
	将字节数组转换为十六进制字符串。
int	tbox_codec_hex_to_bytes (const char *in, uint8_t *out, size_t out_size)
	将十六进制字符串转换为字节数组。
uint8_t	tbox_codec_bcc (const uint8_t *data, size_t len)
	计算字节数组的二进制校验和。
int	tbox_codec_xor (const uint8_t *data, size_t len, uint8_t *result)
	计算字节数组的异或校验和。
int	tbox_codec_base64_encode (const void *in, size_t in_len, char *out, size_t out_size)
	将字节数组编码为 Base64 字符串。
int	tbox_codec_base64_decode (const char *in, uint8_t *out, size_t out_size, size_t *out_len)
	将 Base64 字符串解码为字节数组。
uint32_t	tbox_codec_abs_diff_u32 (uint32_t left, uint32_t right)
	计算两个无符号 32 位整数的绝对差值。
int	tbox_codec_bytes_reverse (void *data, size_t len)
	反转字节数组。

Detailed Description

T-Box 编解码辅助接口

Version

1.0.0

Date

2026-07-06

Copyright

Copyright © 2026 Shenzhen One IOT World Co., Ltd. All rights reserved.

Function Documentation

tbox_codec_abs_diff_u32()

uint32_t tbox_codec_abs_diff_u32	(	uint32_t	left,
		uint32_t	right )

计算两个无符号 32 位整数的绝对差值。

Parameters

[in]	left	左操作数。
[in]	right	右操作数。

Returns

绝对差值。

tbox_codec_base64_decode()

int tbox_codec_base64_decode	(	const char *	in,
		uint8_t *	out,
		size_t	out_size,
		size_t *	out_len )

将 Base64 字符串解码为字节数组。

Parameters

[in]	in	Base64 字符串。
[out]	out	字节数组。
[in]	out_size	字节数组容量。
[out]	out_len	解码后的字节数。

Returns

错误码。

tbox_codec_base64_encode()

int tbox_codec_base64_encode	(	const void *	in,
		size_t	in_len,
		char *	out,
		size_t	out_size )

将字节数组编码为 Base64 字符串。

Parameters

[in]	in	字节数组。
[in]	in_len	字节数组长度。
[out]	out	Base64 字符串。
[in]	out_size	Base64 字符串长度。

Returns

错误码。

tbox_codec_bcc()

uint8_t tbox_codec_bcc	(	const uint8_t *	data,
		size_t	len )

计算字节数组的二进制校验和。

Parameters

[in]	data	字节数组。
[in]	len	字节数组长度。

Returns

二进制校验和。

tbox_codec_bcd_to_decimal()

uint8_t tbox_codec_bcd_to_decimal

(

uint8_t

bcd

)

将 BCD 码转换为十进制数。

Parameters

[in]

bcd

BCD 码。

Returns

十进制数。

tbox_codec_bytes_reverse()

int tbox_codec_bytes_reverse	(	void *	data,
		size_t	len )

反转字节数组。

Parameters

[in]	data	字节数组。
[in]	len	字节数组长度。

Returns

错误码。

tbox_codec_bytes_to_hex()

int tbox_codec_bytes_to_hex	(	const uint8_t *	in,
		size_t	in_len,
		char *	out,
		size_t	out_size )

将字节数组转换为十六进制字符串。

Parameters

[in]	in	字节数组。
[in]	in_len	字节数组长度。
[out]	out	十六进制字符串。
[in]	out_size	十六进制字符串长度。

Returns

错误码。

tbox_codec_decimal_to_bcd()

uint8_t tbox_codec_decimal_to_bcd

(

uint8_t

decimal

)

将十进制数转换为 BCD 码。

Parameters

[in]

decimal

十进制数。

Returns

BCD 码。

tbox_codec_hex_to_bytes()

int tbox_codec_hex_to_bytes	(	const char *	in,
		uint8_t *	out,
		size_t	out_size )

将十六进制字符串转换为字节数组。

Parameters

[in]	in	十六进制字符串。
[out]	out	字节数组。
[in]	out_size	字节数组长度。

Returns

错误码。

tbox_codec_xor()

int tbox_codec_xor	(	const uint8_t *	data,
		size_t	len,
		uint8_t *	result )

计算字节数组的异或校验和。

Parameters

[in]	data	字节数组。
[in]	len	字节数组长度。
[out]	result	异或校验和。

Returns

错误码。