improve zh-cn translation (#292)

* Update pi-sensor.zh-cn.md

* Update pi-actuator.zh-cn.md

* Update pi-actuator.zh-cn.md

* Update pi-sensor.zh-cn.md

* Update pi-actuator.hi.md

* Update pi-actuator.md

* Update pi-sensor.zh-cn.md

Co-authored-by: Jim Bennett <jim.bennett@microsoft.com>
pull/300/head
Flex Zhong 3 years ago committed by GitHub
parent 9dd2795a2e
commit d36a9f35cd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -85,7 +85,7 @@ Program the nightlight.
> 💁 This code should be indented to the same level as the `print('Light level:', light)` line to be inside the while loop!
> 💁 When sending digital values to actuators, a 0 value is 0v, and a 1 value is the max voltage for the device. For the Raspberry Pi with Grove sensors and actuators, the 1 voltage is 3.3V.
> 💁 When sending digital values to actuators, a 0 value is 0V, and a 1 value is the max voltage for the device. For the Raspberry Pi with Grove sensors and actuators, the 1 voltage is 3.3V.
1. From the VS Code Terminal, run the following to run your Python app:

@ -85,7 +85,7 @@
> 💁 इस कोड को `print('Light level:', light)` लाइन के समान स्तर पर इंडेंट किया जाना चाहिए, while loop के अंदर होना चाहिए!
> 💁 एक्ट्यूएटर्स को डिजिटल मान भेजते समय, 0 मान 0v होता है, और 1 मान डिवाइस के लिए अधिकतम वोल्टेज होता है। ग्रोव सेंसर और एक्चुएटर्स के साथ रास्पबेरी पाई के लिए, 1 वोल्टेज 3.3V है।
> 💁 एक्ट्यूएटर्स को डिजिटल मान भेजते समय, 0 मान 0V होता है, और 1 मान डिवाइस के लिए अधिकतम वोल्टेज होता है। ग्रोव सेंसर और एक्चुएटर्स के साथ रास्पबेरी पाई के लिए, 1 वोल्टेज 3.3V है।
1. वीएस कोड टर्मिनल से, अपना पायथन ऐप चलाने के लिए निम्नलिखित चलाएँ:

@ -1,50 +1,50 @@
# 开发一个夜灯 - 树莓派
在这个部分的课程中你会把一个LED加到树莓派上并使用它来创建一个夜灯。
在这个部分的课程中,你会把一个 LED 加到树莓派上并使用它来创建一个夜灯。
## 硬件
现在夜灯需要一个执行器。
这个执行器是**LED**,一个[发光二极管](https://wikipedia.org/wiki/Light-emitting_diode)当电流通过它时会发光。这是一个有两个打开或者关闭状态的数字执行器发送一个1值把灯打开发送0把灯关闭。这个LED是一个外部Grove执行器而且需要被连接到树莓派上的Grove基础扩展板。
这个执行器是 **LED**,一个[发光二极管](https://wikipedia.org/wiki/Light-emitting_diode),当电流通过它时会发光。这是一个有两个打开或者关闭状态的数字执行器,发送一个 1 值把灯打开,发送 0把灯关闭。这个 LED 是一个外部 Grove 执行器,而且需要被连接到树莓派上的 Grove 基础扩展板。
这个夜灯的逻辑用伪代码表示是:
```output
检查光照等级。
如果光照小于300
打开LED
如果光照小于 300
打开 LED
否则
关闭LED
关闭 LED
```
### 连接LED
### 连接 LED
Grove LED 作为一个模块出现以及一系列可供你选择颜色的LED。
Grove LED 作为一个模块出现,以及一系列可供你选择颜色的 LED。
#### 任务 - 连接LED
#### 任务 - 连接 LED
连接LED。
连接 LED。
![一个grove LED](../../../../images/grove-led.png)
1. 选择你最喜欢的LED然后把引脚插到LED模块的两个洞里面。
1. 选择你最喜欢的 LED 然后把引脚插到 LED 模块的两个洞里面。
LED是发光二极管而且二极管是只允许电流单个方向通过的电子设备。这意味LED需要被连接在正确的方向不然就不会工作。
LED 是发光二极管,而且二极管是只允许电流单个方向通过的电子设备。这意味 LED 需要被连接在正确的方向,不然就不会工作。
LED引脚中的一个是正极引脚另一个是负极引脚。LED不是完全的圆形而且在一边是有些平的。这略平的一边是负极引脚。当你连接LED到这个模块的时候需要确保圆形这边的引脚是连接到模块上外边标着 **+** 的插孔,而扁平的这边是连接到靠近模块中间的插孔。
LED 引脚中的一个是正极引脚另一个是负极引脚。LED 不是完全的圆形,而且在一边是有些平的。这略平的一边是负极引脚。当你连接 LED 到这个模块的时候,需要确保圆形这边的引脚是连接到模块上外边标着 **+** 的插孔,而扁平的这边是连接到靠近模块中间的插孔。
1. LED模块有一个允许你控制亮度的旋转按钮用一个小十字螺丝起子逆时针旋转它拧到头来完全打开它。
1. LED 模块有一个允许你控制亮度的旋转按钮,用一个小十字螺丝起子逆时针旋转它拧到头来完全打开它。
1. 把Grove线缆的一端插到LED模块的插孔中这个只能从一个方向插入。
1. 把 Grove 线缆的一端插到 LED 模块的插孔中,这个只能从一个方向插入。
1. 在树莓派断电的情况下把Grove线缆的另一端连接到树莓派上插着的Grove基础扩展板标着 **D5** 的数字插孔。这个插孔在靠近GPIO引脚的一排左数第二个。
1. 在树莓派断电的情况下,把 Grove 线缆的另一端连接到树莓派上插着的 Grove 基础扩展板标着 **D5** 的数字插孔。这个插孔在靠近 GPIO 引脚的一排,左数第二个。
![连接到D5插孔的Grove LED](../../../../images/pi-led.png)
## 编写夜灯程序
现在夜灯可以用Grove光照传感器和Grove LED来编码了。
现在夜灯可以用 Grove 光照传感器和 Grove LED 来编码了。
### 任务 - 编写夜灯程序
@ -52,26 +52,26 @@ Grove LED 作为一个模块出现以及一系列可供你选择颜色的LED
1. 打开树莓派并等待启动完成。
1. 直接在树莓派上或者通过远程SSH扩展打开你在这个作业上一部分创建的VS Code中的夜灯项目。
1. 直接在树莓派上或者通过远程 SSH 扩展,打开你在这个作业上一部分创建的 VS Code 中的夜灯项目。
1. 把下面的代码加到`app.py`文件中来导入一个需要的函数库。这一行需要加在文件顶部,在其他`import`代码行下面。
1. 把下面的代码加到 `app.py` 文件中来导入一个需要的函数库。这一行需要加在文件顶部,在其他 `import` 代码行下面。
```python
from grove.grove_led import GroveLed
```
`from grove.grove_led import GroveLed`语句从Grove Python函数库中导入了`GroveLED`。这个函数库中有和Grove LED交互的代码。
`from grove.grove_led import GroveLed` 语句从 Grove Python 函数库中导入了 `GroveLED`。这个函数库中有和 Grove LED 交互的代码。
1. 把下面的代码加到`light_sensor`声明之后来创建一个管理LED的类的实例
1. 把下面的代码加到 `light_sensor` 声明之后来创建一个管理 LED 的类的实例:
```python
led = GroveLed(5)
```
`led = GroveLed(5)`这一行创建了一个连接到 **D5** 引脚的`GroveLED`类的实例,**D5** 也就是LED连接的那个数字Grove引脚。
`led = GroveLed(5)` 这一行创建了一个连接到 **D5** 引脚的 `GroveLED` 类的实例,**D5** 也就是 LED 连接的那个数字 Grove 引脚。
> 💁 所有的插孔都有唯一的引脚号引脚0、2、4和6是模拟引脚引脚5、16、18、22、24和26是数字引脚。
> 💁 所有的插孔都有唯一的引脚号,引脚 0、2、4 6 是模拟引脚,引脚 5、16、18、22、24 26 是数字引脚。
1. 在`while`循环中增加一个判断,在`time.sleep`之前来检查光照等级并控制LED打开或者关闭
1. 在 `while` 循环中增加一个判断,在 `time.sleep` 之前来检查光照等级并控制 LED 打开或者关闭:
```python
if light < 300:
@ -80,13 +80,13 @@ Grove LED 作为一个模块出现以及一系列可供你选择颜色的LED
led.off()
```
这块代码检查了`light`的值如果小于300就调用`GroveLED`类的`on`方法来发送一个数字值1到LED把它点亮。如果`light`值大于或等于300就调用`off`方法发送一个数字值0给LED把它关闭。
这块代码检查了 `light` 的值,如果小于 300 就调用 `GroveLED` 类的 `on` 方法,来发送一个数字值 1 LED把它点亮。如果 `light` 值大于或等于 300就调用 `off` 方法,发送一个数字值 0 LED把它关闭。
> 💁 这段代码需要放到while循环里面缩进到和`print('Light level:', light)`行一个水平。
> 💁 这段代码需要放到 while 循环里面,缩进到和 `print('Light level:', light)` 行一个水平。
> 💁 当发送数字值到执行器的时候0值就是0v1值就是设备的最大电压。对于插着Grove传感器和执行器的树莓派而言1的电压就是3.3V。
> 💁 当发送数字值到执行器的时候0 值就是 0V1 值就是设备的最大电压。对于插着 Grove 传感器和执行器的树莓派而言1 的电压就是 3.3V。
1. 从VS Code终端运行下面的命令来运行你的Python应用
1. 从 VS Code 终端,运行下面的命令来运行你的 Python 应用:
```sh
python3 app.py
@ -104,12 +104,12 @@ Grove LED 作为一个模块出现以及一系列可供你选择颜色的LED
Light level: 290
```
1. 遮挡和揭开光照传感器会观察到光照等级等于300或更小时LED会点亮如果光照等级比300大LED就会关闭。
1. 遮挡和揭开光照传感器,会观察到光照等级等于 300 或更小时 LED 会点亮,如果光照等级比 300 LED 就会关闭。
> 💁 如果LED没有点亮确保它是正确方向连接的而且旋转按钮是设置成全开的。
> 💁 如果 LED 没有点亮,确保它是正确方向连接的,而且旋转按钮是设置成全开的。
![连接到树莓派的LED随着光照等级改变点亮和关闭](../../../../images/pi-running-assignment-1-1.gif)
> 💁 你可以在[code-actuator/pi](../code-actuator/pi)文件夹里找到这份代码。
> 💁 你可以在 [code-actuator/pi](../code-actuator/pi) 文件夹里找到这份代码。
😀 你的夜灯程序就成功了!

@ -4,13 +4,13 @@
## 硬件
这节课程的传感器是使用[光电二极管](https://wikipedia.org/wiki/Photodiode)来把光照转化为电子信号的光照传感器。这是一个发送从0到1,000整数值的模拟传感器表示光照值的相对量而不对应任何比如[勒克斯lux](https://wikipedia.org/wiki/Lux)的标准计量单位。
这节课程的传感器是使用[光电二极管](https://wikipedia.org/wiki/Photodiode)来把光照转化为电子信号的光照传感器。这是一个发送从 0 1,000 整数值的模拟传感器,表示光照值的相对量而不对应任何比如[勒克斯lux](https://wikipedia.org/wiki/Lux)的标准计量单位。
这个光照传感器是一个外部Grove传感器需要被连接到树莓派上的Grove基础扩展板。
这个光照传感器是一个外部 Grove 传感器,需要被连接到树莓派上的 Grove 基础扩展板。
### 连接光照传感器
用来检测光照等级的Grove光照传感器需要被连接到树莓派上。
用来检测光照等级的 Grove 光照传感器需要被连接到树莓派上。
#### 任务 - 连接光照传感器
@ -18,15 +18,15 @@
![一个 grove 光照传感器](../../../../images/grove-light-sensor.png)
1. 把Grove线缆的一端插到光照传感器模块的插孔中这个只能从一个方向插入。
1. 把 Grove 线缆的一端插到光照传感器模块的插孔中,这个只能从一个方向插入。
1. 在树莓派断电的情况下把Grove线缆的另一端连接到树莓派上插着的Grove基础扩展板标着 **A0** 的模拟插孔。这个插孔在靠近GPIO引脚的一排右数第二个。
1. 在树莓派断电的情况下,把 Grove 线缆的另一端连接到树莓派上插着的 Grove 基础扩展板标着 **A0** 的模拟插孔。这个插孔在靠近 GPIO 引脚的一排,右数第二个。
![插在A0插孔的grove光照传感器](../../../../images/pi-light-sensor.png)
![插在 A0 插孔的 grove 光照传感器](../../../../images/pi-light-sensor.png)
## 编写光照传感器程序
现在设备可以用Grove光照传感器来编码了。
现在设备可以用 Grove 光照传感器来编码了。
### 任务 - 编写光照传感器程序
@ -34,30 +34,30 @@
1. 打开树莓派并等待启动完成。
1. 直接在树莓派上或者通过远程SSH扩展打开你在这个作业上一部分创建的VS Code中的夜灯项目。
1. 直接在树莓派上或者通过远程SSH扩展打开你在这个作业上一部分创建的 VS Code 中的夜灯项目。
1. 打开`app.py`文件并删除里面的所有代码。
1. 打开 `app.py` 文件并删除里面的所有代码。
1. 把下面的代码加到`app.py`文件中来导入一些需要的函数库:
1. 把下面的代码加到 `app.py` 文件中来导入一些需要的函数库:
```python
import time
from grove.grove_light_sensor_v1_2 import GroveLightSensor
```
`import time`语句导入了`time`模块,在这个作业的后面会用到这个模块。
`from grove.grove_light_sensor_v1_2 import GroveLightSensor`语句从Grove Python函数库导入了 `GroveLightSensor`。这个函数库里有和Grove光照传感器交互的代码在设置树莓派的时候就已经全局安装了。
`import time` 语句导入了 `time` 模块,在这个作业的后面会用到这个模块。
`from grove.grove_light_sensor_v1_2 import GroveLightSensor` 语句从 Grove Python 函数库导入了 `GroveLightSensor`。这个函数库里有和 Grove 光照传感器交互的代码,在设置树莓派的时候就已经全局安装了。
1. 在上面代码的后面增加下面的代码来创建一个管理光照传感器的类的实例:
```python
light_sensor = GroveLightSensor(0)
```
`light_sensor = GroveLightSensor(0)`这一行创建了一个连接到 **A0** 引脚的`GroveLightSensor`类的实例,**A0** 也就是光照传感器连接的那个引脚。
1. 在上面的代码后面增加一个无限循环代码来获取光照传感器数值并打印到终端:
`light_sensor = GroveLightSensor(0)` 这一行创建了一个连接到 **A0** 引脚的 `GroveLightSensor` 类的实例,**A0** 也就是光照传感器连接的那个引脚。
1. 在上面的代码后面增加一段无限循环代码,来获取光照传感器数值并打印到终端:
```python
while True:
@ -65,15 +65,15 @@
print('Light level:', light)
```
使用`GroveLightSensor`类的`light`属性可以来获取 0-1023 的当前光照等级值,这个属性从引脚读取模拟量,然后这个值会被打印到终端。
1. 在`loop`的结尾增加一个1秒的短暂休眠因为光照等级不需要一直不断地读取。一个休眠可以减少设备的能源消耗。
使用 `GroveLightSensor` 类的 `light` 属性可以来获取 0-1023 的当前光照等级值,这个属性从引脚读取模拟量,然后这个值会被打印到终端。
1. 在 `loop` 的结尾增加一个 1 秒的短暂休眠,因为光照等级不需要一直不断地读取。一个休眠可以减少设备的能源消耗。
```python
time.sleep(1)
```
1. 从VS Code终端运行下面的命令来运行你的Python应用
1. 从 VS Code 终端,运行下面的命令来运行你的 Python 应用:
```sh
python3 app.py
@ -91,6 +91,6 @@
Light level: 290
```
> 💁 你可以在[code-sensor/pi](../code-sensor/pi)文件夹找到这份代码。
> 💁 你可以在 [code-sensor/pi](../code-sensor/pi) 文件夹找到这份代码。
😀 给你的夜灯增加一个传感器程序就成功了!
😀 给你的夜灯增加一个传感器程序就成功了!

Loading…
Cancel
Save