文档章节

PYB Nano 开发板快速指南

shaoziyang
 shaoziyang
发布于 2016/10/31 10:49
字数 2465
阅读 866
收藏 12

PYB Nano 开发板快速指南

这篇快速指南是为 MicroPython 和 PYB Nano 的初学者写的,通过这个文档,可以快速掌握 MicroPython 和 PYB Nano 的基本使用方法。

 

PYB Nano开发板简介

PYB Nano开发板是目前体积最小、成本最低的MicroPython开发板

PYB Nano的主要特点

  • STM32F401CEU6微控制器
  • 16M主时钟
  • 支持 macroUSB
  • 2路UART
  • 3路I2C
  • 3路SPI
  • 10路12位ADC
  • 支持RTC
  • 支持后备电池输入
  • 支持USB供电和VIN输入(最高12V)
  • 一个用户按键和一个复位键
  • 带有 4个支持亮度调节功能的 LED
  • 带有加速度传感器(MMA7660)
  • 支持USB升级功能
  • 低成本、高性能
  • 开源

应用范围

  • 教育、学习
  • 电子竞赛
  • 机器人
  • 智能硬件
  • 物联网开发
  • 快速原型设计
  • 创客、DIYer

PYB Nano非常适合作为MicroPython的入门开发板,它支持绝大部分MicroPython的功能和函数,成本却只有官方 PyBoard 的几分之一,是学习MicroPython的首选开发板之一,也是从Arduino进阶到其它应用的最好选择。

 

系统需求

在开始使用 PYB Nano 前,需要做一点准备工作:

  • 一台计算机,安装了不低于Win7,或者Linux、MacOS操作系统,32位/64位都可以
  • 串口终端软件,如超级终端、putty、MobaXterm、SecureCRT等
  • macroUSB数据线(可以使用安卓手机的数据线)

因为Windows的用户最多,所以下面的介绍也以Windwos为主,但其它操作系统下的用法也是类似的,甚至更简单。

另外,为了顺利使用 MicroPython,大家还需要对 Python 语言有基本了解,因为MicroPython 是基于 python3 的。

 

安装驱动

在Windows系统中,第一次连接开发板时,会出现一个PYBFLASH磁盘,同时提示需要安装新的设备。这个新的设备就是虚拟串口,它的驱动程序就在新出现的PYBFLASH磁盘上,浏览到这个磁盘安装驱动,安装后就可以使用。

在大部分的Linux、MacOS下无需安装任何驱动程序。

 

终端软件设置

在调试时,通常都使用串口终端软件。在使用前,需要对终端软件的串口参数进行设置。

先用数据线连接开发板,然后运行任一串口终端软件,并设置串口为 PYB Nano 对应的虚拟串口,在将串口参数设置如下:

波特率

115200

数据位

8

奇偶校验

停止位

1

流量控制

个别软件还需要设置字符集才能正常显示。

 

REPL 的用法

通常调试程序时,都是在 MicroPython 的 REPL (read–eval–print loop,循环交互解释器)环境下运行。在REPL下可以直接输入命令,有内置的解释器执行。如果命令输入正常就会执行,命令错误会有提示。

MicroPython支持几个常用的快捷键,如果你熟悉串口终端,会发现它们的习惯是一样的。

  • Ctrl-C,停止正在的程序或终止当前的命令行
  • Ctrl-D,软复位(soft reset)
  • Ctrl-B,显示系统提示
  • Ctrl-E,进入粘贴模式。可以按下Ctrl-C退出粘贴模式,Ctrl-D完成粘贴
  • Tab,键盘上的Tab键,可以补全命令

除了Ctrl-C,其它快捷键需要在空命令行下(没有输入任何字符)才能生效。此外,还可以使用上下左右光标键

  • 上下键,调出以前输入的命令。MicroPython可以保存最后输入的6条命令
  • 左右键,在当前命令行中移动,编辑命令

 

基本用法

LED

无论在哪个开发板中,LED都是最常用的的例程,我们也从这里开始。

PYB Nano上有4个LED,分别是红、绿、黄、蓝色。我们可以通过 pyb.LED(n) [n = 1-4]去使用它们。如:

pyb.LED(1).on()  # LED1亮
pyb.LED(2).off() # LED2灭
pyb.LED(3).toggle() #翻转LED3
pyb.LED(4).intensity(20) # 设置LED4亮度20 [范围是0-255]

呼吸灯,下面程序将LED3设置为呼吸灯

from pyb import Timer

ia = 1
da = 1
def fa(t):
    global ia, da
    if (ia==0)or(ia==255):
        da=256-da
    ia=(ia+da)%256
    pyb.LED(3).intensity(ia)

tm=Timer(1, freq=200, callback=fa)

在其它MicroPython开发板上,LED的数量可能是1-4个,但用法是一样的。此外不是每种 MicroPyhon 开发板的 LED 都支持亮度调整功能(intensity())。

 

按键

在MicroPython的Pyboard中,预定义了按键开关对象,它的使用方法如下:

sw = pyb.Switch()
sw()

如果按键按下,返回True,否则返回False。

 

GPIO

使用GPIO,需要导入pyb库的Pin对象。

from pyb import Pin

p_out = Pin('X1', Pin.OUT_PP) # 定义 X1 引脚为输出
p_out.high()     # 输出高电平
p_out.low()      # 输出低电平
p_out.value(1)   # 等同于 p_out.high()

p_in = Pin('X2', Pin.IN, Pin.PULL_UP) # 定义 X2 为输入 
p_in.value() # get value, 0 or 1

 

外中断

下面代码将按键(PC13)定义为外中断输入,上升沿触发模式。每当按下一次按键,LED1就会翻转一次。

from pyb import Pin, ExtInt

callback = lambda e: pyb.LED(1).toggle()
ext = ExtInt(Pin('C13'), ExtInt.IRQ_RISING, Pin.PULL_UP, callback)

 

定时器

定时器需要使用到pyb库的Timer对象。下面程序中,先设置定时器1的频率为1000Hz,然后读取计数器的值,再设置定时器的频率为0.5Hz,并在定时器回调函数(中断)里翻转LED2。

from pyb import Timer

tim = Timer(1, freq=1000)
tim.counter() # get counter value
tim.freq(0.5) # 0.5 Hz
tim.callback(lambda t: pyb.LED(2).toggle())

 

PWM

PWM是定时器模块的一个子功能,可以将定时器的某一通道设置为PWM输出。下面代码将 PA3 设置为定时器2的CH4输出,最后设置占空比是10%。注意占空比参数可以是浮点数。

from pyb import Pin, Timer

p = Pin('A3') # X1 has TIM2, CH4
tim = Timer(2, freq=1000)
ch = tim.channel(4, Timer.PWM, pin=p)
ch.pulse_width_percent(10)

 

ADC

PYB Nano带有10路12位ADC输入,可以非常容易读取ADC的参数。下面的代码读取引脚 X8 (PB0)的输入

from pyb import Pin, ADC

adc = ADC(Pin('X8'))
adc.read() # read value, 0-4095

另外一种读取ADC的方法是

from pyb import Pin, ADC

a=pyb.ADCAll(12)    # 设置ADC为12位模式
a.read_channel(8)   # 读取ADC8
a.read_core_temp()  # 读取内部温度传感器

 

UART

from pyb import UART

uart = UART(1, 9600)
uart.write('hello')
uart.read(5) # read up to 5 bytes

 

SPI

from pyb import SPI

spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
spi.send('hello')
spi.recv(5) # receive 5 bytes on the bus
spi.send_recv('hello') # send a receive 5 bytes

 

I2C

from pyb import I2C

i2c = I2C(1, I2C.MASTER, baudrate=100000)
i2c.scan() # returns list of slave addresses
i2c.send('hello', 0x42) # send 5 bytes to slave with address 0x42
i2c.recv(5, 0x42) # receive 5 bytes from slave
i2c.mem_read(2, 0x42, 0x10) # read 2 bytes from slave 0x42, slave memory 0x10
i2c.mem_write('xy', 0x42, 0x10) # write 2 bytes to slave 0x42, slave memory 0x10

 

加速度传感器

PYB Nano内置了加速度传感器MMA7660,可以直接读取传感器的参数(数值范围是[-32..32])。

acc = pyb.Accel()
while True:
    print(acc.x(), acc.y(), acc.z())
    pyb.delay(500)

 

其它常用功能

pyb.delay(500)    # 延时500ms
pyb.udelay(20)    # 延时20us
pyb.unique_id()   # 读取芯片的唯一序列号
pyb.millis()      # 复位后的运行时间(ms)
pyb.hard_reset()  # 复位,和按下复位键的效果相同
pyb.bootloader()  # 直接进入 bootloader 模式升级
pyb.disable_irq() # 禁止中断
pyb.enable_irq()  # 恢复中断
pyb.freq()        # 读取系统时钟
pyb.wfi()         # 等待内部或外部中断
pyb.stop()        # 休眠模式,需要外部中断或者实时时钟唤醒

 

MocroPython的启动模式

在启动后,MicroPython会先运行 boot.py 文件,加载用户驱动,然后在运行main.py,执行用户程序。可以将用户程序放在main.py中,也可以在main.py中再加载其它的文件。

 

常见故障

在使用过程中,我们需要注意下面问题,避免造成文件系统破坏、数据丢失。

  • 取下数据线前,需要先U盘那样安全删除硬件,弹出PYBFLASH磁盘,否则可能会造成文件系统破坏,特别在修改了文件或复制新文件到PYBFLASH磁盘后。
  • 不要轻易按复位键,这样会造成当前的USB通讯中断。一般的问题,可以通过按下Ctrl-D软复位接近。

 

出厂模式

使用时间长了,因为各种原因可能会出现故障,造成无法正常启动,不能进入REPL,文件系统破坏等现象,这时就需要通过出厂模式进行恢复。

进入出厂模式的方法是,

  • 按下复位键(RESET)的同时,按住用户按键SW。
  • 然后保持用户按键不放,释放复位键。
  • 这时LED将循环显示:绿-》黄-》绿+黄-》灭
  • 等黄绿灯同时亮时,松开用户键,这时黄绿灯会同时快速闪4次
  • 然后红灯亮起(这时红绿黄三个灯同时亮)
  • 红灯灭,开始进行恢复到出厂状态
  • 所有灯都灭,恢复出厂设置完成。

恢复出厂设置后,PYBFLASH中的内容会丢失,变为默认文件。

 

升级固件

MicroPython的更新速度很快,每次更新都会带来一些新的功能,修正错误。所以掌握 MicroPython 的固件升级方法是有必要的。

PYB Nano支持下面几种升级方法:

  • 通过DFU模式升级
  • 通过SWD方式升级

使用DFU模式,需要安装ST的DfuSe_demo软件(Windows)或者dfu-util(Linux)。使用SWD需要将开发板的SWD接口(PA13/PA14)连接到编程器,通过编程软件(如STM32 ST-LINK Utility)下载。

 

参考资源

以上是 MicroPython 和 PYB Nano 的最基础知识,掌握后大家就可以逐步深入了。下面是一些MicroPython相关的参考网站和论坛,供大家参考。

 

 

© 著作权归作者所有

共有 人打赏支持
shaoziyang
粉丝 12
博文 76
码字总数 25946
作品 0
武汉
程序员
私信 提问
最小的MicroPython开发板PYB Nano

PYB Nano是目前最小的MicroPython开发板,它只有Nucleo32和Arduino Nano大小,却包含了全部的MicroPython的功能。 PYB Nano的主要特点: 支持 macroUSB 2路UART 3路I2C 3路SPI 10路ADC 支持R...

shaoziyang
2016/10/15
53
0
PYB Nano v1.1 开发板文档

PYB Nano v1.1开发板文档 原理图: sch.zip (88.81 KB, 下载次数: 0) 元件表: bom.zip (8.65 KB, 下载次数: 0) 固件:PYB Nano v1.1 开发板固件 3D图:...

shaoziyang
2016/10/18
22
0
PYB Nano 开发板开展试用活动

我们和云汉社区合作,开展PYB Nano开发板试用活动了,有兴趣的网友可以去申请一下。 http://bbs.ickey.cn/e/try/detail?pid=66 如果等不及试用,也可以参加我们的团购活动。 开发板团购...

shaoziyang
2016/11/09
11
0
PYB Nano 开发板的完整设计文档

一直有网友在询问PYB Nano的设计文件,希望可以参考。今天将文档整理出来,放在github和oschina上,方便大家参考。 完整的文档包括下面内容: 开发板定义文件 开发板二进制固件 CAD文件(Alt...

shaoziyang
2016/11/27
22
0
各种开发板的MicroPython固件

各种开发板的MicroPython固件(包括官方支持但是没有提供二进制固件下载,以及部分本社区移植的固件),方便大家进行测试。所有固件均为本社区自己编译并进行了测试,可以完美运行,只需要通...

shaoziyang
2016/10/24
49
0

没有更多内容

加载失败,请刷新页面

加载更多

OSChina 周二乱弹 —— 其实我在地板也睡不着

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @witt-z :分享歌词: 阴天 在不开灯的房间,当所有思绪都一点一点沉淀。 分享莫文蔚的单曲《阴天》: 《阴天》- 莫文蔚 手机党少年们想听歌,...

小小编辑
31分钟前
49
5
微服务分布式事务实现

https://www.processon.com/view/link/5b2144d7e4b001a14d3d2d30

WALK_MAN
今天
3
0
《大漠烟尘》读书笔记及读后感文章3700字

《大漠烟尘》读书笔记及读后感文章3700字: 在这个浮躁的社会里,你有多久没有好好读完一本书了? 我们总觉得自己和别人不一样,所以当看到别人身上的问题时,很少有“反求诸己”,反思自己。...

原创小博客
今天
4
0
大数据教程(9.5)用MR实现sql中的jion逻辑

上一篇博客讲解了使用jar -jar的方式来运行提交MR程序,以及通过修改YarnRunner的源码来实现MR的windows开发环境提交到集群的方式。本篇博主将分享sql中常见的join操作。 一、需求 订单数据表...

em_aaron
今天
3
0
十万个为什么之什么是resultful规范

起源 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency)、高并发等特点...

尾生
今天
3
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部