137 lines
3.8 KiB
Go
137 lines
3.8 KiB
Go
package ble
|
||
|
||
import (
|
||
"fmt"
|
||
)
|
||
|
||
// BLECommand 表示BLE AT命令
|
||
type BLECommand string
|
||
|
||
// BLE AT命令常量定义
|
||
// 命名规则：Command + 功能描述
|
||
const (
|
||
// 基础控制命令
|
||
CommandReset BLECommand = "AT+QRST\r\n"
|
||
CommandVersion BLECommand = "AT+QVERSION\r\n"
|
||
CommandGetAddr BLECommand = "AT+QBLEADDR?\r\n"
|
||
|
||
// 设备初始化命令
|
||
CommandInitPeripheral BLECommand = "AT+QBLEINIT=2\r\n"
|
||
CommandSetDeviceName BLECommand = "AT+QBLENAME=QuecHCM111Z\r\n"
|
||
|
||
// 广播相关命令
|
||
CommandSetAdvertisingParams BLECommand = "AT+QBLEADVPARAM=150,150\r\n"
|
||
CommandStartAdvertising BLECommand = "AT+QBLEADVSTART\r\n"
|
||
|
||
// GATT服务相关命令
|
||
CommandCreateGATTService BLECommand = "AT+QBLEGATTSSRV=fff1\r\n"
|
||
CommandCreateGATTCharacteristic BLECommand = "AT+QBLEGATTSCHAR=fff2\r\n"
|
||
CommandCompleteGATTService BLECommand = "AT+QBLEGATTSSRVDONE\r\n"
|
||
)
|
||
|
||
// String 返回命令的字符串表示（用于日志和调试）
|
||
func (cmd BLECommand) String() string {
|
||
return string(cmd)
|
||
}
|
||
|
||
// --- 通用模块控制 ---
|
||
|
||
// Restart 生成模块重启的 AT 命令
|
||
func Restart() string {
|
||
return "AT+QRST\r\n"
|
||
}
|
||
|
||
// GetVersion 生成查询固件版本的 AT 命令
|
||
func GetVersion() string {
|
||
return "AT+QVERSION\r\n"
|
||
}
|
||
|
||
// SetBaud 生成设置串口波特率的 AT 命令
|
||
func SetBaud(baud int64) (string, error) {
|
||
// 验证波特率有效性
|
||
validBauds := map[int64]bool{9600: true, 19200: true, 38400: true, 57600: true, 115200: true, 230400: true, 460800: true, 921600: true}
|
||
if !validBauds[baud] {
|
||
return "", fmt.Errorf("invalid baud rate: %d, supported: %v", baud, validBauds)
|
||
}
|
||
return fmt.Sprintf("AT+QSETBAUD=%d\r\n", baud), nil
|
||
}
|
||
|
||
// SetTxPower 生成发送功率，限制值的大小
|
||
func SetTxPower(txpower int8) (string, error) {
|
||
if txpower > 10 || txpower < -16 {
|
||
return "", fmt.Errorf("txpower setting value out of range [-16,10]")
|
||
}
|
||
return fmt.Sprintf("AT+QTXPOWER=%d\r\n", txpower), nil
|
||
}
|
||
|
||
// --- BLE 初始化与配置 ---
|
||
|
||
// Init 生成初始化 BLE 栈的 AT 命令
|
||
func Init(role int) (string, error) {
|
||
// 验证角色有效性
|
||
validRoles := map[int]bool{1: true, 2: true, 4: true} // Peripheral=2, Central=1, Multi-role=4
|
||
if !validRoles[role] {
|
||
return "", fmt.Errorf("invalid BLE role: %d, supported: %v", role, validRoles)
|
||
}
|
||
return fmt.Sprintf("AT+QBLEINIT=%d\r\n", role), nil
|
||
}
|
||
|
||
// SetDeviceName 生成设置设备名称的 AT 命令
|
||
func SetDeviceName(name string) (string, error) {
|
||
if name == "" {
|
||
return "", fmt.Errorf("device name cannot be empty")
|
||
}
|
||
return fmt.Sprintf("AT+QBLENAME=%s\r\n", name), nil
|
||
}
|
||
|
||
// QueryAddress 生成查询 BLE MAC 地址的 AT 命令
|
||
func QueryAddress() string {
|
||
return "AT+QBLEADDR?\r\n"
|
||
}
|
||
|
||
// --- 广播控制 ---
|
||
|
||
// StartAdvertising 生成启动广播的 AT 命令
|
||
func StartAdvertising() string {
|
||
return "AT+QBLEADVSTART\r\n"
|
||
}
|
||
|
||
// StopAdvertising 生成停止广播的 AT 命令
|
||
func StopAdvertising() string {
|
||
return "AT+QBLEADVSTOP\r\n"
|
||
}
|
||
|
||
// --- GATT 服务端 ---
|
||
|
||
// AddService 生成添加 GATT 服务的 AT 命令
|
||
func AddService(uuid string) (string, error) {
|
||
if uuid == "" {
|
||
return "", fmt.Errorf("UUID cannot be empty")
|
||
}
|
||
return fmt.Sprintf("AT+QBLEGATTSSRV=%s\r\n", uuid), nil
|
||
}
|
||
|
||
// AddCharacteristic 生成添加特征值的 AT 命令
|
||
func AddCharacteristic(uuid string) (string, error) {
|
||
if uuid == "" {
|
||
return "", fmt.Errorf("UUID cannot be empty")
|
||
}
|
||
return fmt.Sprintf("AT+QBLEGATTSCHAR=%s\r\n", uuid), nil
|
||
}
|
||
|
||
// FinishGATTServer 生成提交 GATT 服务定义的 AT 命令
|
||
func FinishGATTServer() string {
|
||
return "AT+QBLEGATTSSRVDONE\r\n"
|
||
}
|
||
|
||
// SendNotify 生成发送 Notify 通知的 AT 命令
|
||
func SendNotify(handle string, value string) (string, error) {
|
||
if handle <= "" {
|
||
return "", fmt.Errorf("invalid handle: %s", handle)
|
||
}
|
||
if value == "" {
|
||
return "", fmt.Errorf("value cannot be empty")
|
||
}
|
||
return fmt.Sprintf("AT+QBLEGATTSNTFY=0,%s,%s\r\n", handle, value), nil
|
||
}
|