Add Chinese Documentation (universam1#505)

Initial support for zh-docs, working in progress. Greeting from Beijing Homebrewing Society, many thanks to the iSpindel project !

README.md

@@ -24,6 +24,7 @@ Check out [IOT DEVICE PULLS ITS WEIGHT IN HOME BREWING](http://hackaday.com/2017
 ## There are FAQs:
 ### [Deutsche FAQ] - docs/FAQ.md
 ### [English FAQ] - docs/FAQ-en.md
+### [中文 FAQ] - docs/FAQ-zh.md
 
 ## Documentation in other languages
 
@@ -33,6 +34,8 @@ Check out [IOT DEVICE PULLS ITS WEIGHT IN HOME BREWING](http://hackaday.com/2017
 
 ### [Documentação em Português (trabalho em andamento)](docs/README_pt.md) 🇧🇷
 
+### [中文文档 (完善中)](docs/README_zh.md) CN
+
 ***
 
 ***Say thanks with a beer*** :beers:
@@ -110,12 +113,17 @@ Check out [IOT DEVICE PULLS ITS WEIGHT IN HOME BREWING](http://hackaday.com/2017
 
 ## Inhaltverzeichnis
 
-- [iSpindel - *DIY electronic Hydrometer*](#ispindel-diy-electronic-hydrometer)
+- [iSpindel - *DIY electronic Hydrometer*](#ispindel---diy-electronic-hydrometer)
   - [Featured in german brewing magazine Braumagazin.de](#featured-in-german-brewing-magazine-braumagazinde)
+  - [There are FAQs:](#there-are-faqs)
+    - [[Deutsche FAQ] - docs/FAQ.md](#deutsche-faq---docsfaqmd)
+    - [[English FAQ] - docs/FAQ-en.md](#english-faq---docsfaq-enmd)
+    - [[中文 FAQ] - docs/FAQ-zh.md](#中文-faq---docsfaq-zhmd)
   - [Documentation in other languages](#documentation-in-other-languages)
     - [English Documentation (work in progress) 🇺🇸](#english-documentation-work-in-progress-)
     - [Nederlandse Vertaling (lopende werkzaamheden) 🇳🇱](#nederlandse-vertaling-lopende-werkzaamheden-)
     - [Documentação em Português (trabalho em andamento) 🇧🇷](#documentação-em-português-trabalho-em-andamento-)
+    - [中文文档 (完善中) CN](#中文文档-完善中-cn)
   - [Firmware download here](#firmware-download-here)
   - [ChangeLog](#changelog)
   - [Inhaltverzeichnis](#inhaltverzeichnis)

docs/Calibration_zh.md

@@ -0,0 +1,95 @@
+# 校准
+
+> iSpindle 漂浮在麦汁当中的倾斜角度可以转换成柏拉图度（ºPlato）、比重值（SG）或者其他单位。为了能够做到这一点，应该在 iSpindle 的倾斜度与所选择单位之间建立起参照.。必须对参考值进行测量，并使用 Excel 表格制作图表以及生成公式。 Excel 会计算 iSpindle 的倾斜角度与柏拉图度、比重值或其他单位之间的关系。 由于每个自己做的 iSpindle 会有所不同，因此需要对单独每个 iSpindle 进行参考测量，但只需要进行一次。
+
+***
+
+# 目录
+- [简易方法 (I)](#easy-method-(I))
+- [改进方法利用快速发酵 (II)](#improved-method-using-fast-fermenting-(II))
+- [ Excel 图表公式](#formula)
+
+***
+
+## 简易方法 (I)
+
+建议您将 iSpindel 与 [Ubidots](https://ubidots.com/) 连接，方便读取测量的倾斜角度。此外，明智的做法是更改 iSpindel 中的设置，以便每 20 秒发送一次新的读数。在如此短的时间间隔内，可以在 [Ubidots](https://ubidots.com/) 网站上轻松地跟踪测量结果。
+
+1. 将 iSpindel 放入干净的清水中 (柏拉图 0 度，比重值 1.000) 
+> ***记下 iSpindel 的倾斜角度***
+
+2. 制作达到最大预期密度的糖水溶液。如果你要酿造初始比重较高的烈性啤酒，你应该在这个高比重范围内的预期参考测量值。对于大多数酿酒师来说，比重在 1.085 左右或 柏拉图 20 度 左右的目标密度溶液就够了。   
+> *糖溶液示例: 400 毫升 和 100 克糖*     
+> ***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***
+
+3. 用水稀释上述溶液，直到它达到 柏拉图 15 度 或者 比重 1.061       
+>*示例：用 166 毫升水稀释第 2 点的溶液*     
+>***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***        
+
+4. 从上一点稀释溶液，直到达到约 柏拉图 10 度 或者 比重 1.040       
+>*示例：用 333 毫升水稀释第 3 点的溶液*        
+>***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***     
+
+5. 从上一点稀释溶液，直到达到约 柏拉图 7.5 度 或者 比重 1.030
+>*示例：用 333 毫升水稀释第 4 点的溶液*        
+>***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***     
+
+6. 从上一点稀释溶液，直到达到约 柏拉图 5 度 或者 比重 1.020
+>*示例：用 666 毫升水稀释第 5 点的溶液*        
+>***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***   
+
+7. 从上一点稀释溶液，直到达到约 柏拉图 2.5 度 或者 比重 1.010     
+>*示例：用 2000 毫升水稀释第 6 点的溶液*      
+>***测量比重值或者柏拉图度并和 iSpindel 的倾斜角度一起记下来        
+>在 Excel 表格中输入测量点（见下文），此 Excel 表格将计算出参考公式***
+
+***
+
+## 改进方法利用快速发酵 (II)
+
+这种方法更为精确，因为它会考虑到发酵过程中产生的二氧化碳对 iSpindel 造成的影响。
+
+建议您将 iSpindel 与 [Ubidots](https://ubidots.com/) 连接，方便读取测量的倾斜角度。此外，明智的做法是更改 iSpindel 中的设置，以便每 20 秒发送一次新的读数。在如此短的时间间隔内，可以在 [Ubidots](https://ubidots.com/) 网站上轻松地跟踪测量结果。
+
+1. 将 iSpindel 放入干净的（自来）水中 (柏拉图 0 度，比重值 1.000)       
+>***记下 iSpindel 测量的倾斜角度***
+
+2. 制作达到最大预期密度的糖水溶液。如果你要酿造初始比重较高的烈性啤酒，你应该在这个高比重范围内的预期参考测量值。对于大多数酿酒师来说，比重在 1.085 左右或 柏拉图 20 度 左右的目标密度溶液就够了。  
+>*糖溶液示例: 800 毫升 水 + 200 克 冰糖*
+
+3. 加入酵母到糖溶液，让 iSpindel 在溶液中漂浮         
+>***测量比重值或者柏拉图度并和 iSpindel 倾斜角度一起记下来***
+
+4. 每隔一段时间测量液体的比重值以及 iSpindle 相应的倾斜角度，直至发酵结束。      
+>***在 Excel 表格中输入记录下来的测量值，得出校准曲线公式***     
+>
+>***注意：如果使用折光仪来测量白利糖度，则必须重新计算得到的测量值，加上酒精度数以进行校正*** 
+
+***
+
+# 公式
+
+- ## [在线比重校准工具](http://www.ispindel.de/tools/calibration/calibration.htm)
+
+可以在不同的选项 比重/柏拉图或者白利糖度 中输入相对应的测量值以及倾斜角度。它将计算出第二回和第三回的角度公式，获取倾斜角度的读数就可以预测出比重值或柏拉图度。必须在固件中输入角度公式才能得到比重值或柏拉图度的数值。
+
+***
+
+- ## Excel 表格
+
+获取的测量值可以输入到Excel表格中,该表格将计算出一个公式来预测给定倾斜值的比重值或柏拉图度。这个公式必须输进固件配置中，以便能够获取比重值或柏拉图度的读数。
+其它读数例如表观衰减度或者酒精百分比，可以通过使用 [Ubidots](https://ubidots.com/) 中的 'Derived Variable'（衍生变量)以类似的方式获得。
+
+1. 首先在 Excel 中输入测量值：
+[下载 Excel 表格](https://github.com/universam1/iSpindel/blob/master/docs/Kalibrierung_zh.xlsm)
+2. 通过点击按钮启动宏 **公式更新** ，接着公式将会被更新。 
+![Excelcalc](/pics/Excelcalc.jpg)
+3. 在 [Ubidots](https://ubidots.com/) 账号中必须添加 **Derived Variable** （衍生变量）。这是一个以其他变量为来源进行计算的变量，这可以通过执行接下来的步骤来完成。
+4. 在 [Ubidots](https://ubidots.com/) 中转到 **Source** 这一项
+5. 选择 iSpindel 为来源
+6. 点击 **(+) 添加变量** 
+7. 选择 **Derived** 这一项      
+![Derived](/pics/Ubiderived.jpg)
+1. 现在你可以将 Excel 中的公式填写进去。公式中 ***(tilt)*** 的部分必须被替换掉。为此请单击 ***insert variable*** 然后选取 **tilt**，给新创建的变量一个有意义的名字，比如比重或柏拉图。    
+![Ubiplato](/pics/Ubiplato.jpg)
+9. 在 **Dashboard** 你可以创建测量数据的图形演示。

docs/FAQ-zh.md

@@ -0,0 +1,94 @@
+# 常见问题解答
+
+- ***我是否必须通过增加克重来平衡 iSpindle ?***  
+将螺母、铅球等重物添加到底部，直到与垂直方向倾斜 25° ，是使 iSpindle 功能正常运行必不可少的条件。另见文档里的示例图片，一般 20g 左右就够了，+/- 5° 偏差通常仍然使可以接受的。如果太接近 30 度，在高比重测量时就会太接近 90 度（你的初始比重将不准确）；如果太接近 15 度，在低比重测量时就会太接近 0 度（你将无法读取低于 0.95 的比重值）。
+
+- ***它没有在运行, 我看不到任何反应***  
+找出 iSpindle 正在发生什么的最好方法是读取其日志，这可以通过像 HTerm 或 Arduino IDE 这样的串行监视器来完成。通过 Micro USB 连接设备，然后用上面的串口监视器打开 £COM 端口并读取它。设置波特率为 `115200` ，将给黑暗带来光明。
+
+  这里有一个油管上的教程 (德语): https://youtu.be/6xDW5GbIbUw
+
+- ***如何进入 iSpindel 设置模式入口***  
+打开设备, 按复位键 3-4 次，建立一个接入点。这就意味着你将看到一个新的 Wif i网络 "iSpindel_######" ，你可以用你的电脑、智能手机或平板电脑进行连接。网页浏览器应该会自动将您重定向到页面 [http://192.168.4.1](http://192.168.4.1)， 如果不是，请自行导航到那里。
+如果你在设置模式的界面, 在 `配置` 一项里可以输入你的密钥和无线密码。然后点击 `保存` ，接着它会把数据上传到 Ubidots。这意味着 **正常操作下无法访问 iSpindel **，直到你再次手动启动设置模式。
+
+- ***为什么我无法在正常操作中访问 iSpindle***  
+电池寿命的关键部分是 iSpindle 处于活动状态的时间越短越好，并且要尽可能长时间处于深度睡眠状态！主动运行的 Wemos 需要超过 300 倍的电量，所以这个技巧对于实现目标运行时间是必不可少的。
+
+- ***Micro USB 端口是用于程序更新？***
+没错，请参阅固件更新
+
+- ***我如何校准电压显示？***
+从固件 3.0 开始，你可以调整转换系数。默认情况下的使用因子是 191.8，可以通过下面的公式进行调整:
+````
+(displayed voltage / measured voltage) * current factor (191.8) = new factor
+
+新的系数应介于当前系数之间，或多或少约为20% (191.8*0.8 - 191.8*1.2)
+````
+- ***我可以在不锈钢容器里连接上吗？信号是否有可能穿透法拉第牢笼？***
+为了达到足够的 WLAN 信号强度，你可以做以下事情:
+
+  - 打开法拉第笼，将盖子从桶身电性分离开来，通过在两部分之间涂抹硅酮密封剂来实现。
+  - 使用外部天线，从两端剥去的屏蔽电缆（即 Lambda/4），并让另一端朝向桶内，正好3.2毫米。这是从内部被动传递到外部，反之亦然。一个很好的例子可以在这里找到：http://hobbybrauer.de/forum/viewtopic.php?p=208782#p208782
+  - 在桶旁边安装一个 wifi 放大器以增加信号强度
+
+-  ***如果我在刷入固件后 iSpindel 无法正常工作，我该怎么办?***
+
+由于不明的原因，有时看起来 iSpindel 刷入过程非常顺利。但实际上并不是的，这可能导致各种不可预测的状况。
+状况的发生可能是但不限于以下几种:
+-	Wemos 的蓝色 LED 灯一直常亮
+-	部分配置未被保存，如倾角偏移
+
+解决这个问题的办法是，在给 iSpindel 刷入固件之前，先初始化 wemos 的内存（就像你在使用一个新的硬盘之前对它进行格式化一样）。
+
+以下是如何使用 NODEMUCU FIRMWARE PROGRAMMER 进行操作
+
+初始化：
+
+在 Config 项
+````
+		1st column		2nd column
+1st Line:	INTERNAL://NODEMCU	0x00000
+2nd Line:	INTERNAL://BLANK	0x01000
+````
+在 Advanced 项
+设置 Baudrate 为 115200
+
+在 Operation 项
+点击 Flash(E)，然后等待固件刷入完成
+
+要和 iSpindel 的固件一同刷入：
+
+在 Config 项
+````
+		1st column		2nd column
+1st Line: 	C:\iSpindel-6.0.6.bin 	0x00000
+````
+替代 “C:\iSpindel-6.0.6.bin” 到你下载固件文件的路径，确保清除掉 Config 项里面的所有其它行，只有固件路径前面的复选框被选中。
+
+在 Advanced 项
+设置 Baudrate 为 115200
+
+在 Operation 项
+点击 Flash(E)，然后等待固件刷入完成
+
+现在它应该可以正常工作了。
+
+来源: https://www.homebrewtalk.com/forum/threads/ispindle-diy-electronic-hydrometer.598187/page-19#post-8366882
+
+-  ***改进过后仍有问题***
+这些是 "经常建议的改进"，其问题在一开始并不明显；勇于尝试，但要时刻关注问题的出现：
+
+1. "让我们把它密封起来，并使用无线充电!"
+
+  a) Qi 充电器比瓶胚大，所以需要被弯曲。部分这样做会导致充电过热或着火，另一些可以正常工作但对 Qi 充电板的位置会 *非常* 挑剔。
+    有些感应式充电器能放在盖子里面 [不是 Qi] (例如: https://amzn.to/3wslaLO , 但还没有尝试过)。
+    *试试看，但要注意热量！*
+
+  b) 瓶胚的密封是在顶层内部, 酵母和细菌会进入 "螺纹区域" ，无法清洗掉。现在的建议是将瓶盖取下来，分别对盖子和瓶胚进行清洗、消毒。
+
+2. 主发酵期产生的二氧化碳不会影响读数吗？
+  商业版本的机器肯定也会有的。如果你认为它过早地沉淀下来，摇晃并搅拌你的麦汁，看看会发生什么。
+
+3. iSpindel 能否用于加压发酵罐？
+  你可以试试... 常规的瓶胚密封是 "在里面" 的，这样随着内部压力的增加，它的密封性能会更好 (苏打被碳酸化)，这是一个错误的方向，但是螺纹的确可以密封，所以...

docs/Firmware_zh.md

@@ -0,0 +1,53 @@
+# 固件
+
+## 通过 网页接口 刷入
+
+- 从项目仓库里下载最新的 .bin 固件 
+### https://github.com/universam1/iSpindel/releases
+
+- 在 `Maintenance` 一项里选择固件文件并按更新
+
+![flash web](/pics/maintenance.png)
+
+## 通过 USB 刷入 (Windows)
+
+- 下载并运行：[NodeMCU-Flasher](https://github.com/nodemcu/nodemcu-flasher/raw/master/Win32 从 [/bin 路径文件夹](https://github.com/universam1/iSpindel/raw/master/bin/)
+> 重要提示：选择 “下载” 按钮以正确下载文件
+- 选择 Wemos 的 COM 端口
+- 使用 ```Config``` 选项 悬着第一个 ```.bin``` 固件
+- 点击 ```Flashen``` 选项显示进度条
+- 刷入固件后, 点击 ```RESET``` 重置键
+
+> 当 LED 灯以 1 秒的间隔闪烁时，```配置模式``` 会处于激活状态，可以通过退出设置模式或等待五分钟超时来退出该模式。
+
+## 通过 USB 刷入 (Linux)
+
+- 下载并解压最新版本的 [esptool](https://github.com/igrr/esptool-ck/releases)，然后使用终端命令将目录更改为新解压的目录，示例：
+```
+    wget https://github.com/igrr/esptool-ck/releases/download/0.4.12/esptool-0.4.12-linux64.tar.gz
+    tar xf esptool-0.4.12-linux64.tar.gz
+    cd esptool-0.4.12-linux64
+```
+
+- 从 [iSpindel Releases page](https://github.com/universam1/iSpindel/releases) 下载最新的固件，例如：
+```
+    wget https://github.com/universam1/iSpindel/releases/download/5.6.1/firmware.bin
+```
+
+- 确定设备 iSpindel 的路径，这可以通过列出插入 iSpindel 前后的所有串行 USB 设备找到，比如可能在 iSpindel 插入之前。
+```
+ls -l /dev/ttyUSB*
+ls: cannot access '/dev/ttyUSB*': No such file or directory
+```
+
+在 iSpindel 插入之后：
+```
+ls -l /dev/ttyUSB*
+crw-rw-rw- 1 root dialout 188, 0 Dec 11 23:20 /dev/ttyUSB0
+```
+上面显示 iSpindel 设备名称是 /dev/ttyUSB0
+
+
+- 用找到的 iSpindel 设备名称 (在这个例子是 /dev/ttyUSB0) 通过运行 esptool 指令来上传固件：
+
+```./esptool -vv -cd nodemcu -cb 921600 -cp /dev/ttyUSB0 -ca 0x00000 -cf ./firmware.bin```

docs/Parts_zh.md

@@ -0,0 +1,36 @@
+# 组件
+
+需要以下部件：
+
+## 塑料圆形容器
+
+- 塑料圆柱体 `瓶胚`，这些容器可在 eBay 上以 PET 定制件的形式买到。
+
+***
+
+## 草图
+
+- 塑料模板 [下载](https://github.com/universam1/iSpindel/raw/master/drawer/)
+
+![Sled](/pics/Schlitten_cad.jpg)
+***
+
+## 电池盒
+
+- `18650 锂电池` (例如` 松下 NCR18650B`)
+
+***
+
+## 零部件
+
+- [Wemos D1 mini](https://wiki.wemos.cc/products:d1:d1_mini) 开发板
+- `GY-521`  陀螺仪和加速传感器 ( MPU-6050 在适合的分线板上)
+- [DS18B20 温度传感器](https://www.maximintegrated.com/en/products/analog/sensors-and-sensor-interface/DS18B20.html)
+- 3x4cm 方形网格或印制电路板
+- 电阻
+  - 4k7 ohms
+  - 220k ohms
+  - 330 ohms or BAT43 二极管
+- [微型开关](http://www.reichelt.de/Schiebeschalter/SS-ESP201/3/index.html?ACTION=3&LA=446&ARTICLE=112179&GROUPID=7595&artnr=SS+ESP201&SEARCH=SS%2BESP201)
+或 电路板上的 [换簧器](http://www.reichelt.de/Reedrelais/KSK-1C90/3/index.html?ACTION=3&LA=446&ARTICLE=27696&GROUPID=7617&artnr=KSK+1C90&SEARCH=KSK%2B1C90)
+- 锂电充电板 `TP4056` (推荐 6 针)