小牛电动车接入HomeAssistant MQIL / M3

ajtech

2025-09-05 国内goxofy版本已更新支持UI配置，废弃configuration.yaml配置模式
UI配置（推荐）

• 进入设置 → 设备与服务 → 集成
• 点击"+"按钮并搜索"NIU Scooter Integration"
• 输入您的NIU账户凭据：
  • 用户名/邮箱: 您的NIU账户用户名或邮箱
  • 密码: 您的NIU账户密码
  • 滑板车ID: 要监控的滑板车ID（默认：0）
    
• 选择要监控的传感器
• 点击"提交"
  

电池传感器

• BatteryCharge: 当前电池百分比
• Isconnected: 连接状态
• TimesCharged: 充电次数
• temperatureDesc: 温度描述
• Temperature: 电池温度
• BatteryGrade: 电池健康等级
  

电机传感器

• CurrentSpeed: 当前速度
• ScooterConnected: 滑板车连接状态
• IsCharging: 充电状态
• IsLocked: 锁定状态
• TimeLeft: 预估剩余时间
• EstimatedMileage: 预估剩余里程
• centreCtrlBatt: 中央控制器电池
• HDOP: GPS精度
  

位置传感器

• Longitude: GPS经度
• Latitude: GPS纬度
  

统计传感器

• totalMileage: 总里程
• DaysInUse: 使用天数
• Distance: 距离
• RidingTime: 骑行时间
  

行程传感器

• LastTrackStartTime: 最后行程开始时间
• LastTrackEndTime: 最后行程结束时间
• LastTrackDistance: 最后行程距离
• LastTrackAverageSpeed: 最后行程平均速度
• LastTrackRidingtime: 最后行程骑行时间
• LastTrackThumb: 最后行程缩略图
  

2024-09-26
无论是海外版本还是国内修改版本都存在用几天登录失效的问题，必须重启ha才能正常拉取最新数据，目前还没找到合适解决方案（定时重启ha应该是可以的）


2024-08-05
海外版本原始仓库稍作改动即可对国内小牛原生支持https://github.com/marcelwestrahome/home-assistant-niu-component好处是不用手动配置configuration.yaml，直接用户名密码登录，缺点就是最近行驶轨迹图实体丢失

修改文件 /homeassistant/custom_components/niu/const.py
修改之前
ACCOUNT_BASE_URL = "https://account-fk.niu.com"
API_BASE_URL = "https://app-api-fk.niu.com"
修改之后
ACCOUNT_BASE_URL = "https://account.niu.com"
API_BASE_URL = "https://app-api.niu.com"




先上效果图



参考资料
集成地址：https://github.com/goxofy/home-assistant-niu-component
参考视频：https://www.bilibili.com/video/BV1LV4y187M5


效果图所使用 UI界面代码和logo素材

游客，如果您要查看本帖隐藏内容请回复

bugensui

牛逼，搞出来特斯拉的感觉

lxz946786639

请问车图片哪里搞的

ajtech

lxz946786639 发表于 2023-7-28 16:11
请问车图片哪里搞的

小牛电动app里面抓包拿到的官方原图，其他渠道还不太好弄

lxz946786639

另外还有一个问题想请教下，你的定位为什么没有偏移，，，我的都有偏移

ajtech

lxz946786639 发表于 2023-7-28 16:17
另外还有一个问题想请教下，你的定位为什么没有偏移，，，我的都有偏移 ...

ha默认的地图确实有偏移，这是由于经纬度坐标系统差异导致，需要做经纬度转换比较麻烦。或者更换系统地图为百度高德地图，这个方式貌似也不太简单。第一张24小时定位打点图就是系统map生成的存在偏移，第二张是小牛官方api提供的轨迹截图，是一张png图片展示的，所以没有偏移。

lxz946786639

ajtech 发表于 2023-7-28 16:13
小牛电动app里面抓包拿到的官方原图，其他渠道还不太好弄

好的感谢

csky888

ui和视频图片分享一下，谢谢

佚蓝

小白请教一下，这个图片的地址/local/images/..是放哪里哦？

jjss520

牛批呀。。。。