feat: 初始化小米 IoT (MIoT) 智能家居 Go 库

- 实现 MIoT 客户端核心功能(MQTT 连接、设备管理、属性读写)
- 支持云端 API 调用与局域网设备发现(mDNS)
- 集成国际化(i18n)多语言支持
- 添加 MIoT 设备规约解析器(spec_parser)
- 包含单元测试与使用示例
This commit is contained in:
2026-06-28 22:05:49 +08:00
parent ac442812b4
commit 3a44cb9e6a
118 changed files with 31630 additions and 0 deletions
@@ -0,0 +1,21 @@
-----BEGIN CERTIFICATE-----
MIIBazCCAQ+gAwIBAgIEA/UKYDAMBggqhkjOPQQDAgUAMCIxEzARBgNVBAoTCk1p
amlhIFJvb3QxCzAJBgNVBAYTAkNOMCAXDTE2MTEyMzAxMzk0NVoYDzIwNjYxMTEx
MDEzOTQ1WjAiMRMwEQYDVQQKEwpNaWppYSBSb290MQswCQYDVQQGEwJDTjBZMBMG
ByqGSM49AgEGCCqGSM49AwEHA0IABL71iwLa4//4VBqgRI+6xE23xpovqPCxtv96
2VHbZij61/Ag6jmi7oZ/3Xg/3C+whglcwoUEE6KALGJ9vccV9PmjLzAtMAwGA1Ud
EwQFMAMBAf8wHQYDVR0OBBYEFJa3onw5sblmM6n40QmyAGDI5sURMAwGCCqGSM49
BAMCBQADSAAwRQIgchciK9h6tZmfrP8Ka6KziQ4Lv3hKfrHtAZXMHPda4IYCIQCG
az93ggFcbrG9u2wixjx1HKW4DUA5NXZG0wWQTpJTbQ==
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIBjzCCATWgAwIBAgIBATAKBggqhkjOPQQDAjAiMRMwEQYDVQQKEwpNaWppYSBS
b290MQswCQYDVQQGEwJDTjAgFw0yMjA2MDkxNDE0MThaGA8yMDcyMDUyNzE0MTQx
OFowLDELMAkGA1UEBhMCQ04xHTAbBgNVBAoMFE1JT1QgQ0VOVFJBTCBHQVRFV0FZ
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEdYrzbnp/0x/cZLZnuEDXTFf8mhj4
CVpZPwgj9e9Ve5r3K7zvu8Jjj7JF1JjQYvEC6yhp1SzBgglnK4L8xQzdiqNQME4w
HQYDVR0OBBYEFCf9+YBU7pXDs6K6CAQPRhlGJ+cuMB8GA1UdIwQYMBaAFJa3onw5
sblmM6n40QmyAGDI5sURMAwGA1UdEwQFMAMBAf8wCgYIKoZIzj0EAwIDSAAwRQIh
AKUv+c8v98vypkGMTzMwckGjjVqTef8xodsy6PhcSCq+AiA/n9mDs62hAo5zXyJy
Bs1s7mqXPf1XgieoxIvs1MqyiA==
-----END CERTIFICATE-----
File diff suppressed because one or more lines are too long
+125
View File
@@ -0,0 +1,125 @@
// E9 — Full MIoT client integration example.
// Demonstrates: create client → set storage/http/mips → init → refresh devices → subscribe → monitor.
package main
import (
"fmt"
"os"
"os/signal"
"time"
"miot"
"miot/examples/config"
)
func main() {
// 1. Load config
cfg, err := config.LoadConfig(config.DefaultPath())
if err != nil {
fmt.Printf("Load config error: %v\n", err)
return
}
if cfg.AuthInfo.AccessToken == "" {
fmt.Println("请先运行 E1 cloud_oauth 获取 token")
os.Exit(1)
}
// 2. Create entry data (Python: entry_data dict)
entryData := cfg.EntryData()
// 3. Create the full client
client := miot.NewMIoTClient("demo", entryData, cfg.UID, cfg.CloudServer, cfg.GetCtrlMode())
// 4. Set up storage
storage := miot.NewMIoTStorage("./data")
client.SetStorage(storage)
fmt.Println("Storage 已配置")
// 5. Set up HTTP client
http, err := miot.NewMIoTHttpClient(cfg.CloudServer, miot.OAUTH2_CLIENT_ID, cfg.AuthInfo.AccessToken)
if err != nil {
fmt.Printf("Create HTTP client error: %v\n", err)
return
}
client.SetHTTPClient(http)
fmt.Println("HTTP Client 已配置")
// 6. Set up MIPS cloud client
mips := miot.NewMipsCloudClient(
"ssl://cn-ha.mqtt.io.mi.com:8883",
"ha."+cfg.UUID,
miot.OAUTH2_CLIENT_ID,
cfg.AuthInfo.AccessToken,
)
client.SetMipsCloud(mips)
fmt.Println("MIPS Cloud 已配置")
// 7. Initialize client
if err := client.Init(); err != nil {
fmt.Printf("Init error: %v\n", err)
return
}
fmt.Println("Client 已初始化")
// 8. Start background services
network := miot.NewMIoTNetwork(nil, nil, 30*time.Second)
network.Init()
defer network.Deinit()
svc := miot.NewMipsService()
svc.Init()
defer svc.Deinit()
lan, err := miot.NewMIoTLan(nil, network, svc, true, 0)
if err != nil {
fmt.Printf("LAN init warning: %v\n", err)
} else {
defer lan.Deinit()
fmt.Println("LAN 控制器已启动")
}
// 9. Connect MIPS
fmt.Println("正在连接 MIPS...")
if err := mips.Connect(); err != nil {
fmt.Printf("MIPS connect warning: %v\n", err)
} else {
defer mips.Disconnect()
fmt.Println("MIPS 已连接")
}
// 10. Refresh device list
fmt.Println("\n刷新设备列表...")
if err := client.RefreshDevices(); err != nil {
fmt.Printf("RefreshDevices warning: %v\n", err)
} else {
devices := client.DeviceList()
fmt.Printf("设备数量: %d\n", len(devices))
for did, info := range devices {
fmt.Printf(" %s: %v (online=%v)\n", did, info["name"], info["online"])
}
// Subscribe to first device's state
for did := range devices {
client.SubDeviceState(did, func(did string, state miot.MIoTDeviceState, ctx interface{}) {
fmt.Printf("[设备状态] DID=%s, State=%s\n", did, state)
})
// Subscribe to all properties for the first device
client.SubProp(did, func(params map[string]interface{}, ctx interface{}) {
fmt.Printf("[属性] did=%v, siid=%v, piid=%v, value=%v\n",
params["did"], params["siid"], params["piid"], params["value"])
}, 0, 0)
break // only first device for demo
}
}
// 11. Wait for Ctrl+C
fmt.Println("\n等待 Ctrl+C 退出...")
sigCh := make(chan os.Signal, 1)
signal.Notify(sigCh, os.Interrupt)
<-sigCh
// 12. Cleanup
fmt.Println("\n正在清理...")
client.Deinit()
fmt.Println("示例结束")
}