# Zigbee 晶片韌體更新(BSL Serial方法)
## 簡介
透過此方法可在無外部JTAG燒錄器的狀況下將Zigbee晶片的韌體更新至新版
適用晶片型號: TI CC1352/2652
市面上所能購買到的dongle應該都支援此方法(如Sonoff Zigbee Dongle或祐大的無線/有線網關)
## 事前準備與注意事項
安裝Python 3
更新前請先停止Zigbee2MQTT套件
## 步驟
1. 先找出Zigbee晶片的BSL引腳並將BSL引腳與GND相接後通電
CC1352/2652 BSL: DIO 15 (Sonoff Zigbee Dongle不須此步驟)
2. 下載[cc2538-bsl](https://github.com/JelmerT/cc2538-bsl/archive/refs/heads/feature/ITead_Sonoff_Zigbee-delay.zip)這個套件並解壓縮
3. 下載[韌體檔](https://github.com/Koenkk/Z-Stack-firmware/blob/master/coordinator/Z-Stack_3.x.0/bin/CC1352P2_CC2652P_launchpad_coordinator_20211217.zip)並將解壓縮後產生的.hex韌體檔案複製到第2步解壓縮後的資料夾
4. 在解壓縮後的資料夾按Shift+右鍵並選擇打開PowerShell
5. 依序執行套件安裝

    pip install pyserial
    pip install intelhex
    pip install python-magic

6. 找出USB通訊埠編號或網關IP
USB: 打開裝置管理員->通訊埠->會出現COM+數字(如:COM1)即為編號
IP: 可在路由器管理介面中找到(如:192.168.1.3)
7. 於第4步中打開的PowerShell視窗中輸入
普通USB:
`python cc2538-bsl.py -p <通訊埠編號> -e -w -v <韌體檔案名>`
Ex.`python cc2538-bsl.py -p COM6 -e -w -v abc.hex`

Sonoff:
`python cc2538-bsl.py --bootloader-sonoff-usb -p <通訊埠編號> -e -w -v 韌體檔案名`
Ex.`python cc2538-bsl.py --bootloader-sonoff-usb -p COM6 -e -w -v abc.hex`

無線/有線網關:
`python cc2538-bsl.py -p socket://<IP地址>:<Port號> -e -w -v 韌體檔案名`
Ex.`python cc2538-bsl.py -p socket://192.168.1.3:6638 -e -w -v abc.hex`
8. 程式執行完畢後重新供電即完成韌體更新