From bba7c64a3e8dddaf4fea0ff582ffeb1ed5c21dc4 Mon Sep 17 00:00:00 2001 From: a2633063 <76966589@QQ.com> Date: Thu, 4 Apr 2019 23:43:25 +0800 Subject: [PATCH] Update README.md --- README.md | 138 ++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 98 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index b0efc73..70084a2 100644 --- a/README.md +++ b/README.md @@ -1,49 +1,107 @@ -# zTC1 +# zTC1 a1版 **斐讯TC1智能排插个人固件.** -斐讯0元购完全翻车了,服务器也已经关闭.智能排插TC1也因为服务器关闭,app无法登陆,定时开关等功能完全无法使用. +排插TC1因为服务器关闭,无法使用. -为此,针对TC1智能排插的硬件,开发供自己使用的FW及对应app,确保自己能够正常使用此排插.取名为zTC1. +为此,开发供自己使用的FW及对应app,确保自己能够正常使用此排插.取名为zTC1. + +> 注意: +> +> ​ TC1排插硬件分a1 a2两个版本,本固件仅支持**a1版本.** +> +> ​ a1 a2两个版本仅主控不同,除此之外其他无任何区别. -APP端见: [SmartControl_Android_MQTT](https://github.com/a2633063/SmartControl_Android_MQTT) +## 特性 -> 如果你有任何问题,可以直接在此项目中提交issue,或给我发送邮件:zip_zhang@foxmail.com,邮件标题中请注明项目. +本固件使用斐讯TC1排插硬件为基础,实现以下功能: - - -建立了个QQ群,有问题可以加入来讨论:**459996006**,备注zTC1即可 - - - -## 直接为使用看这里 - -如果你只是为了TC1能够继续使用不做技术开发交流等,请直接查看[使用步骤及方法](https://github.com/a2633063/zTC1/wiki#使用步骤及方法), - - - - - -![图片来源斐讯官网产品介绍](https://raw.githubusercontent.com/wiki/a2633063/zTC1/image/Phicomm_TC1.png) - - - -## [单击从这里开始](https://github.com/a2633063/zTC1/wiki) - - - - - -## 功能(当前进度) - - -暂时完成以下功能,后续有需要继续添加 - -- [x] 4个USB充电(3个普通和1个快充接口)(USB充电软件无法控制,所有应该和原固件功能相同) -- [x] MQTT客户端连接服务器(无MQTT时使用UDP通信,如果你会内网穿透,就可能实现远程控制功能) -- [x] app控制每个接口独立开关 -- [x] app配置每个接口拥有独立的5组定时开关 +- [x] 4个USB充电(3个普通和1个快充接口)(硬件直接实现,与软件无关) +- [x] 按键控制所有插口通断 +- [x] 控制每个接口独立开关 +- [x] 每个接口拥有独立的5组定时开关 - [x] ota在线升级 -- [x] app实时显示功率(有点误差,正在校准数据中) -- [ ] ~~根据功率自动开关~~(可能不会做这个功能) +- [x] 无服务器时使用UDP通信 +- [x] MQTT服务器连接控制 +- [x] 通过mqtt连入homeassistant +- [x] app实时显示功率(校准数据) +- [ ] ~~根据功率自动开关~~(未做此功能) + + + + + + + +## 前言(必看) + +- 除非写明了`如果你不是开发人员,请忽略此项`之类的字眼,否则,请**一个字一个字看清楚看完**整后再考虑动手及提问!很可能一句话就是你成功与否的关键! +- 烧录固件需要专用的烧录器:支持swd的jlink烧录器,目前已知便宜的价格为不到20元包邮.(本人不做烧录器的售卖,所有提供的链接或推荐都为第三方卖家,和本人无关). +- 使用此固件,需要app端配合,见[SmartControl_Android_MQTT](https://github.com/a2633063/SmartControl_Android_MQTT). +- app只有android,因ios限制,本人不考虑免费做ios开发.(不要再问是否有ios端). + +> 虽然没有ios端,但固件支持homeassistant,可以使用安卓APP配置完成后,连入homeassistant后,使用ios控制. APP主要仅为第一次使用配对网络及配置mqtt服务器时使用,之后可以用homeassistant控制不再使用app. + +> 如果你不知道什么是mqtt或homeassistant,所有有关的内容可以跳过. + +> 如果你有任何问题,可以直接在此项目中提交issue,或给我发送邮件:zip_zhang@foxmail.com,邮件标题中请注明[zTC1]. +> +> + +建立了个QQ群,有问题可以加入来讨论:**459996006** + + + +## 开始 + +整体流程如下:拆开TC1,将固件/烧录器/pc互相连接,在pc运行烧录软件进行烧录,烧录固件. + +烧录完成后,首次使用前配对网络并配置mqtt服务器,之后就可以使用了. + + + +## 拆机接线及烧录固件相关 + +见[固件烧录](https://github.com/a2633063/zTC1/wiki/固件烧录) + +烧录固件完成后,即可开始使用 + + + +## 开始使用/使用方法 + +见[开始使用](https://github.com/a2633063/zTC1/wiki/开始使用) + + + +## 其他内容 + +### 代码编译 + +> 此项为专业开发人员准备,如果你不是开发人员,请跳过此项 + +TC1使用的主控为EMW3031,基于MiCO(MCU based Internet Connectivity Operating System)开发.[MiCO简介点这里](http://developer.mxchip.com/handbooks/101) + +需要按照官方说明才能保证此项目能够编译成功: + +1. 安装[MiCO Cube编译工具](http://developer.mxchip.com/handbooks/102) +2. 配置[MICoder IDE环境](http://developer.mxchip.com/handbooks/105) +3. 配置[Jlink下载工具](http://developer.mxchip.com/handbooks/103) +4. check out 此项目,按照[从一个现有的 Git 仓库克隆导入](http://developer.mxchip.com/handbooks/102#%E4%BB%8E%E4%B8%80%E4%B8%AA%E7%8E%B0%E6%9C%89%E7%9A%84-git-%E4%BB%93%E5%BA%93%E5%85%8B%E9%9A%86%E5%AF%BC%E5%85%A5)确认项目编译/下载正常 + + + +### 通信协议 + +> 此项为专业开发人员准备,如果你不是开发人员,请跳过此项 + +所有通信协议开源,你可以自己开发控制app或ios端 + +见[通信协议](https://github.com/a2633063/zTC1/wiki/通信协议) + + + +### 作者声明 + +注意: 本项目主要目的为作者本人自己学习及使用TC1排插而开发,本着开源精神及造福网友而开源,仅个人开发,可能无法做到完整的测试,所以不承担他人使用本项目照成的所有后果.同时严禁他人将本项目用户用于所有商业活动.个人在非盈利情况下可以自己使用,用作他用请先联系作者:zip_zhang@foxmail.com \ No newline at end of file