【花雕体验】08 行空板硬件控制pinpong库的系列测试（之一）

eagler8

行空板板身集成了光线传感器、麦克风、蜂鸣器、Wifi、蓝牙、加速度传感器、按键，正面配置有一块LCD彩屏，可实时呈现多种Python运行结果，包括文字、图片、视频，游戏画面，以及数据图表等。



【花雕体验】01上手行空板
https://www.mydigit.cn/thread-318081-1-1.html
【花雕体验】02 行空板简单使用
https://www.mydigit.cn/thread-318186-1-1.html
【花雕体验】03 搭建行空板开发环境之Mind+编程
https://www.mydigit.cn/thread-318338-1-1.html
【花雕体验】04 测试行空板常用功能
https://www.mydigit.cn/thread-318549-1-1.html
【花雕体验】05 搭建行空板开发环境之SSH连接与Jupyter编程
https://www.mydigit.cn/thread-319055-1-1.html
【花雕体验】06 搭建行空板开发环境之Thonny编程
https://www.mydigit.cn/thread-319154-1-1.html
【花雕体验】07 搭建行空板开发环境之VSCode编程
https://www.mydigit.cn/thread-319184-1-1.html
【花雕体验】08 行空板硬件控制pinpong库的系列测试（之一）
https://www.mydigit.cn/thread-319260-1-1.html

eagler8

1、行空板板载传感器与接口布局图

eagler8

2、行空板上板载了一颗单片机协处理器负责板载元件及GPIO的控制，因此我们通过Python进行控制需要使用pinpong库（固件内置，不用安装）。

安装：

1. <p>pip install pinpong</p><p></p>

复制代码

更新：

1. pip install -U pinpong

复制代码

eagler8

3、pinpong库是一套控制开源硬件主控板的Python库，基于Firmata协议并兼容MicroPython语法，5分钟即可让你上手使用Python控制开源硬件。

借助于pinpong库，直接用Python代码就能给各种常见的开源硬件编程。其原理是给开源硬件烧录一个特定的固件，使开源硬件可以通过串口与电脑通讯，执行各种命令。

pinpong库的名称由“Pin”和“Pong”组成，“Pin”指引脚，“PinPong”为“乒乓球”的谐音，指信号的往复。

pinpong库的设计，是为了让开发者在开发过程中不用被繁杂的硬件型号束缚，而将重点转移到软件的实现。哪怕程序编写初期用Arduino开发，部署时改成了掌控板，只要修改一下硬件的参数就能正常运行，实现了“一次编写处处运行”。

官方文档：https://pinpong.readthedocs.io/zh_CN/latest/

点击观看pinpong入门视频互动教程：

https://www.bilibili.com/video/BV17K4y1T7MF

eagler8

4、pinpong库导入方法
pinpong库由于支持众多的主控板及开源硬件，因此分成了3个包，board、extension和libs，board包中放置主板支持的功能及常用库，extension为定制类主控，libs中放置其他传感器的扩展库。
pinpong库支持多块主控板的使用，因此可以指定板型及端口号并生成对象，因为行空板上固定为协处理器并且端口号固定，因此可以省略掉这些参数而直接初始化。

1. <p>from pinpong.board import xxx   #board包中的库</p><p>from pinpong.libs.xxx    #libs包中的库</p><p>from pinpong.extension.xxx    #extension包中的主板</p><p>
   
2. </p><p>Board().begin() #初始化，连接协处理器，检查固件为空或版本不对则自动烧录</p>

复制代码

eagler8

inthsunshine 发表于 2022-6-17 19:36
行空板，这名字取的莫名其妙，一头雾水，国产都喜欢玩玄虚？

呵呵，华人文化特色

eagler8

5、行空板板载资源的系列测试
（1）板载蓝色LED灯（简称L）
【科普知识点】发光二极管（英语：light-emitting diode，简称LED）是一种半导体光源，当电流通过它时会发光；即一种电致发光的半导体电子元件，其内电子与电子空穴复合，以光子的形式释放能量。发光二极管结构的核心部分是p-n结，周边部分有环氧树脂密封其引线与框架以保护内部芯线。当p-n结通以正向电流时，能发射可见或非可见辐射，此辐射为透过三价与五价元素所组成复合光源。发光二极管只能够往一个方向导通（通电），叫作正向偏置；当电流流过时，电子与电洞（电子空穴）在其内复合而发出单色光，这叫“电致发光效应”；而光线的波长、颜色跟其所采用的半导体物料种类与故意掺入的元素杂质有关。发光二极管具有效率高、寿命长、不易破损、反应速度快、可靠性高等传统光源不及的优点。

发光二极管（LED）于1962年出现时，只能发出低光度的红光，被惠普买下专利后当作指示灯利用。其后发展出其他单色光的版本，时至今日，能够发出的光已经遍及可见光、红外线及紫外线，光度亦提高到相当高的程度。随着白光发光二极管的出现，用途已由初期的指示灯及显示板等指示用途，逐渐发展至近年的照明用途。白光LED的发光效率近期亦有所进步，其每千流明成本，因大量资金投入已使价格下降，近年在照明用途上愈趋普及。

eagler8

行空板背面有一颗蓝色LED灯（标记为L）可供用户控制。
L灯为高低电平控制，接到了行空板的P25接口上，因此控制P25即可控制L灯。

1. 语法：Pin(Pin.P25, Pin.OUT).write_digital(电平信号)
   
2. 返回值：无
   
3. 输入参数：1高电平， 0低电平

复制代码

eagler8

#【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
# 行空板板载资源的测试
# 测试程序一：板载蓝色LED灯（简称L）

1. #【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
   
2. # 行空板板载资源的测试
   
3. # 测试程序一：板载蓝色LED灯（简称L）
   
4. 
   
5. #  -*- coding: UTF-8 -*-
   
6. from pinpong.board import Board,Pin
   
7. import time
   
8. 
   
9. Board().begin()    #初始化
   
10. #引脚初始化为电平输出模式，P25为L灯的引脚
    
11. led = Pin(Pin.P25, Pin.OUT)
    
12. print("板载蓝色LED灯测试")
    
13. 
    
14. while True:
    
15.   #led.value(1) #输出高电平 方法1
    
16.   led.write_digital(1) #输出高电平 方法2
    
17.   print("1点亮LED") #终端打印信息
    
18.   time.sleep(1) #等待1秒 保持状态
    
19. 
    
20.   #led.value(0) #输出低电平 方法1
    
21.   led.write_digital(0) #输出低电平 方法2
    
22.   print("0熄灭LED") #终端打印信息
    
23.   time.sleep(1) #等待1秒 保持状态

复制代码

eagler8

实验场景图（点亮熄灭蓝色LED）

eagler8

【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
行空板板载资源的测试——Mind+图形编程
测试程序二：板载蓝色LED灯（简称L）

eagler8

实验串口返回情况

eagler8

（2）板载A、B按钮开关
【科普知识点】按钮开关是指利用按钮推动传动机构，使动触点与静触点按通或断开并实现电路换接的开关。按钮开关是一种结构简单，应用十分广泛的主令电器。在电气自动控制电路中，用于手动发出控制信号以控制接触器、继电器、电磁起动器等。在按钮未按下时，动触头与上面的静触头是接通的，这对触头称为常闭触头。此时，动触头与下面的静触头是断开的，这对触头称为常开触头：按下按钮，常闭触头断开，常开触头闭合；松开按钮，在复位弹簧的作用下恢复原来的工作状态。

按钮开关的结构种类很多，可分为普通揿钮式、蘑菇头式、自锁式、自复位式、旋柄式、带指示灯式、带灯符号式及钥匙式等，有单钮、双钮、i钮及不同组合形式。一般是采用积水式结构，由按钮帽、复位弹簧、静触头、动触头和外壳等组成，通常做成复合式，有一对常闭触头和常开触头，有的产品可通过多个元件的串联增加触头对数。还有一种自持式按钮，按下后即可自动保持闭合位置，断电后才能打开。

eagler8

行空板上有三个按键：Home、A、B，其中Home按键仅供Home菜单使用，A、B按键可供用户调用（注：由于AB按键同时被映射为了键盘的AB按键，因此除了使用pinpong调用，还可以用unihiker库中的键盘事件调用）。

在pinpong库中，按钮有两种方式调用，一种是直接读取 查询式，第二种是中断事件回调式。查询式 ：

1. 语法：button_a.is_pressed() button_b.is_pressed()
   
2. 返回值：按钮按下返回True，按钮没有按下返回False
   
3. 输入参数：无

复制代码

eagler8

【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
行空板板载资源的测试——Mind+代码编程
测试程序三：板载A、B按钮开关（查询式）

1. #【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
   
2. # 行空板板载资源的测试——Mind+代码编程
   
3. # 测试程序三：板载A、B按钮开关（查询式）
   
4. 
   
5. #  -*- coding: UTF-8 -*-
   
6. from pinpong.extension.unihiker import *
   
7. from pinpong.board import Board,Pin
   
8. 
   
9. Board().begin()
   
10. #引脚初始化为电平输出模式，P25为L灯的引脚
    
11. led = Pin(Pin.P25, Pin.OUT)
    
12. print("板载A、B按钮开关（查询式）")
    
13. 
    
14. while True:
    
15.     if (button_a.is_pressed()==True): #判断按钮A是否被按下
    
16.         print("按钮A按下，点亮LED")
    
17.         led.value(1) #输出高电平
    
18.     if (button_b.is_pressed()==True): #判断按钮B是否被按下
    
19.         print("按钮B按下，LED熄灭")
    
20.         led.value(0) #输出低电平

复制代码

eagler8

实验场景图（按下A按钮点亮蓝色LED）

eagler8

【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
行空板板载资源的测试——Mind+图形编程
测试程序四：板载A、B按钮开关（查询式）

eagler8

实验串口返回情况

eagler8

在pinpong库中，按钮有两种方式调用，第二种是中断事件回调式。

1. 语法：button_a.irq(trigger=触发模式, handler = 回调函数) button_b.irq(trigger=触发模式, handler = 回调函数)
   
2. 
   
3. 返回值：无
   
4. 
   
5. 输入参数：
   
6. 
   
7. trigger：触发模式，有上升沿（Pin.IRQ_RISING）、下降沿（Pin.IRQ_FALLING）、电平跳变（Pin.IRQ_RISING+Pin.IRQ_FALLING）三种

复制代码

【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）

行空板板载资源的测试——Mind+代码编程

测试程序五：板载A、B按钮开关（中断回调式）

1. #【花雕体验】08行空板硬件控制pinpong库的系列测试（之一）
   
2. # 行空板板载资源的测试——Mind+代码编程
   
3. # 测试程序五：板载A、B按钮开关（中断回调式）
   
4. 
   
5. #  -*- coding: UTF-8 -*-
   
6. from pinpong.extension.unihiker import *
   
7. from pinpong.board import Board,Pin
   
8. import time
   
9. 
   
10. Board().begin()
    
11. #引脚初始化为电平输出模式，P25为L灯的引脚
    
12. led = Pin(Pin.P25, Pin.OUT)
    
13. print("板载A、B按钮开关（中断回调式）")
    
14. 
    
15. def btn_a_rasing_handler(pin):#中断事件回调函数
    
16.   print("按钮A按下，点亮LED")
    
17.   led.value(1) #输出高电平
    
18. 
    
19. def btn_b_falling_handler(pin):#中断事件回调函数
    
20.   print("按钮B按下，LED熄灭")
    
21.   led.value(0) #输出低电平
    
22. 
    
23. button_a.irq(trigger=Pin.IRQ_RISING, handler = btn_a_rasing_handler)#上升沿触发
    
24. button_b.irq(trigger=Pin.IRQ_FALLING, handler = btn_b_falling_handler)#下降沿触发
    
25. 
    
26. while True:
    
27.     time.sleep(1)#等待让程序不退出

复制代码

eagler8

实验串口返回情况