小米手环2 (MiBand2) 开源库安装与配置完全指南

岑里普Georgette

于 2024-09-13 22:48:24 发布

阅读量279

点赞数 2

本文链接：https://blog.csdn.net/gitblog_07064/article/details/142234711

版权

小米手环2 (MiBand2) 开源库安装与配置完全指南

MiBand2 Library to work with Xiaomi MiBand 2 项目地址: https://gitcode.com/gh_mirrors/mi/MiBand2

项目基础介绍

小米手环2开源库是名为MiBand2的一个GitHub项目，位于creotiv/MiBand2。此项目提供了一个Python库，兼容Python 2和Python 3，旨在方便开发者与小米米动手环2进行交互。它由Leo Soares开发了基础库，并且经过Volodymyr Shymanskyy添加了额外的调试和修复工作。这个工具对于想要自定义手环功能或者研究其通讯协议的开发者非常有用。

主要编程语言

Python：100%的代码基于Python语言，确保了跨平台的便捷性。

关键技术和框架

低功耗蓝牙（BLE）通信：项目利用BLE技术与小米手环进行无线通信。
无特定框架依赖：更侧重于底层API调用和设备通信，不依赖于大型的第三方框架。

准备工作与详细安装步骤

步骤一：环境准备

安装Python: 确保您的计算机上已安装Python 2.7或更高版本，推荐使用Python 3.x系列以获得长期支持。
```
# 对于Windows, 可从官网下载安装包
# 对于Linux或MacOS, 大多已预装Python, 检查版本：
python --version
```

安装pip: 确认pip已安装或更新至最新版。

python -m ensurepip --default-pip
# 或者升级pip
python -m pip install --upgrade pip

步骤二：克隆项目到本地

打开终端或命令提示符。

使用git克隆仓库到你的电脑。

git clone https://github.com/creotiv/MiBand2.git

步骤三：安装依赖

进入项目目录并安装必要的Python包。

cd MiBand2
pip install -r requirements.txt

步骤四：设备准备

开启蓝牙：确保你的电脑蓝牙已经打开。
解除配对：如果你的小米手环之前已经与其他设备配对，需要在手机中取消配对。
获取MAC地址：通过蓝牙扫描找到你的米动手环MAC地址。在Linux系统下可以使用命令行：
```
sudo hcitool lescan
```
记录显示的手环MAC地址。

步骤五：运行示例代码

运行初始化脚本来认证设备。替换MAC_ADDRESS为你实际得到的MAC地址。
```
python example.py --mac MAC_ADDRESS --init
```
成功初始化后，你可以尝试执行不同功能的示例，例如展示标准功能：
```
python example.py --standard --mac MAC_ADDRESS
```
或者查看帮助信息了解其他可用命令：
```
python example.py --help
```