【瑞昱RTL8763E】歌曲传输

news2024/10/6 10:42:33

1 概要

Watch 端 SD 卡中的歌曲除了可以通过 USB 传输，还可以通过 SPP/BLE 传输来完成歌曲的添加与删除操作。其中，Android 手机可以安装 LocalPlayback.apk 使用 SPP 协议与 watch 交互；iOS 手机可以安装 LocalPlayback.ipa 通过 BLE 与 watch 交互，手机端 app 的使用方法可参见对应 tool 文件夹下的使用手册。无论是 SPP 还是 BLE，所使用的 Command 和 Event 是相同的。

2 建立连接

手机 tool 端与 watch 建立 SPP/BLE 连接后，先读取 Header .bin 和 Name .bin 内容，根据 Header .bin 中的 offset，length 和 plIndex 找到对应歌曲名，加载出 File List 和 Play List。后续增删歌曲等操作均基于 File List 和 Play List，目前 watch 只使用一个 playlist。

2.1 Command&Event

2.1.1 CMD_QUERY_INFO

Tool 端首先发送 0x680 来获取 watch 设备信息。

CMD_QUERY_INFO (CMD ID: 0x680)
Parameters

EVT_QUERY_INFO (EVT ID: 0x680)
Parameters （共32 bytes）	Byte0~Byte1	Packet size 传送音乐数据每笔包大小。
	Byte2~Byte3	Buffer check size 计算buffer check的数据长度。
	Byte4	Protocol version 协议版本号 SoC新增功能或修复bug后，版号递增
	Byte5	Mode 暂未使用
	Byte6	ic type 例如：BBPro，BBPro2…
	Byte7	song_farmat_type typedef enum { PB_FORMAT_TYPE_DEFAULT = 0x00, PB_FORMAT_TYPE_AAC = 0x01, PB_FORMAT_TYPE_MP3 = 0x02, PB_FORMAT_TYPE_FLAC = 0x04, PB_FORMAT_TYPE_WAV = 0x08, PB_FORMAT_TYPE_RSVD } T_PLAYBACK_FORMAT_TYPE; 这个byte是指明soc支持的播放文件格式， PB_FORMAT_TYPE_DEFAULT也可以默认支持播放aac，rtk，采用bit位，bit0: aac，bit1 mp3, bit2 flac, bit3 wav。
	Byte8~Byte31	Reserve（24 bytes）

2.1.2 CMD_GET_LIST_DATA

Tool端发送0x681获取header.bin与Name.bin。

CMD_GET_LIST_DATA (CMD ID: 0x681)

Parameters

Byte0

File Type:

0x00: Header .bin

0x01: Name .bin

EVT_GET_LIST_DATA (EVT ID: 0x681)

Parameters

Byte0

Flag

0x00: start（获取文件长度及CRC的标志位）

0x01: continue（第一笔及传输数据的标志位）

0x02: end（最后一笔传输数据的标志位）

Byte1~ByteN

Flag == 0, start：

Byte1~Byte2：CRC

Byte3~Byte6：File Length

Flag == 1 or Flag == 2, continue/end：

Byte1~Byte2：

Header/Name data length

Byte3~ByteN：

Header/Name data

3 添加歌曲

File List 中歌曲不存在（即 watch 端 sd 卡中没有此歌曲），需要手机 tool 通过 SPP/BLE 将歌曲数据传送给 watch。

3.1 Commant&Event

3.1.1 CMD_TRANS_START

Tool 端开始传输音乐数据前，先发送 CMD 0x682 将音乐名称给 SoC（watch），此时 SoC 创建音乐文件，并将结果返回给 Tool。其中，BLE 传输时，在收到 CMD_TRANS_START 后会做 BLE 连接间隔的修改，以提高传输速度。

CMD_TRANS_START (CMD ID: 0x682)
Parameters	Byte0~Byte1	Length 歌曲名占用字节数
	Byte2~ByteN	Song name
	ByteN+1~ByteN+4 (4 bytes)	Length of the whole song 整首歌的数据长度

EVT_TRANS_START (EVT ID: 0x682)

Parameters

Byte0

Result

0x01: success

Others: fail

3.1.2 CMD_TRANS_CONTINUE

Tool 将歌曲数据分包传输给 SoC。

CMD_TRANS_CONTINUE (CMD ID: 0x683)
Parameters	Byte0~Byte1	Sequence number
	Byte2-byte3	crc
	Byte4~Byte7	Offset
	Byte8~Byte9	Length
	Byte10~ByteN	Song Data

3.1.3 CMD_REPORT_BUFFER_CHECK

Tool 端暂未使用该 CMD，而是在 buffer 写满后上报 EVT_REPORT_BUFFER_CHECK 同步 SOC buffer 状态。开始时，SoC 端接收数据的乒乓 buf A、B 都是空的，Tool 端可以连续传输，将 buf A、B 放满，后面需要等待 SoC 回应 0xF1 表明 buf A 空，继续传输数据，放满 buf A；然后等 0xF2 表明 buf B 空，再继续传输数据放满 buf B，反复如此。

CMD_REPORT_BUFFER_CHECK (CMD ID: 0x684)

Parameters

Byte0~Byte1

Data size

需要做buffer check的data size（= buffer check size）

Byte2~Byte3

CRC value

EVT_REPORT_BUFFER_CHECK (EVT ID: 0x683)

Parameters

Byte0

Result

0x01: success