miscale2garmin 项目使用教程

1. 项目的目录结构及介绍

miscale2garmin 项目的目录结构如下：

miscale2garmin/
├── README.md
├── config.json
├── main.py
├── requirements.txt
└── scripts/
    ├── data_processor.py
    ├── garmin_uploader.py
    └── miscale_connector.py

目录结构介绍

• README.md: 项目说明文档，包含项目的基本信息和使用指南。
• config.json: 项目的配置文件，用于存储连接和上传数据所需的参数。
• main.py: 项目的启动文件，负责初始化和调用其他模块。
• requirements.txt: 项目依赖的 Python 包列表。
• scripts/: 包含项目的主要功能模块。
  • data_processor.py: 数据处理模块，负责解析和处理从体重秤获取的数据。
  • garmin_uploader.py: Garmin 上传模块，负责将处理后的数据上传到 Garmin Connect。
  • miscale_connector.py: 体重秤连接模块，负责与体重秤进行蓝牙通信并获取数据。

2. 项目的启动文件介绍

main.py 是项目的启动文件，其主要功能是初始化配置、连接体重秤、处理数据并上传到 Garmin Connect。以下是 main.py 的主要代码结构：

import json
from scripts.miscale_connector import MiscaleConnector
from scripts.data_processor import DataProcessor
from scripts.garmin_uploader import GarminUploader

def main():
    # 读取配置文件
    with open('config.json', 'r') as f:
        config = json.load(f)
    
    # 初始化连接器、处理器和上传器
    connector = MiscaleConnector(config)
    processor = DataProcessor()
    uploader = GarminUploader(config)
    
    # 连接体重秤并获取数据
    data = connector.get_data()
    
    # 处理数据
    processed_data = processor.process(data)
    
    # 上传数据到 Garmin Connect
    uploader.upload(processed_data)

if __name__ == "__main__":
    main()

启动文件介绍

• main() 函数是程序的入口点，负责读取配置文件、初始化各个模块、获取数据、处理数据并上传数据。
• MiscaleConnector 负责与体重秤进行蓝牙通信并获取数据。
• DataProcessor 负责解析和处理从体重秤获取的数据。
• GarminUploader 负责将处理后的数据上传到 Garmin Connect。

3. 项目的配置文件介绍

config.json 是项目的配置文件，用于存储连接和上传数据所需的参数。以下是一个示例配置文件的内容：

{
    "miscale": {
        "mac_address": "XX:XX:XX:XX:XX:XX",
        "timeout": 15
    },
    "garmin": {
        "username": "your_username",
        "password": "your_password"
    }
}

配置文件介绍

• miscale 部分包含连接体重秤所需的参数：
  • mac_address: 体重秤的蓝牙 MAC 地址。
  • timeout: 连接超时时间，单位为秒。
• garmin 部分包含上传数据到 Garmin Connect 所需的参数：
  • username: Garmin Connect 的用户名。
  • password: Garmin Connect 的密码。

通过以上配置文件，项目可以正确地连接体重秤并上传数据到 Garmin Connect。