pyboard 快速参考手册

闪电

pyboard 的快速参考

以下引脚分配适用于 PYBv1.1。您还可以查看其他版本的 pyboard 的引脚排列： PYBv1.0 或PYBLITEv1.0-AC 或 PYBLITEv1.0.

下面是 pyboard 的快速参考。如果这是您第一次使用该板，请考虑先阅读以下部分：

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  ( K6 K# V( s) T6 B" W) S: [  J1 T

通用板控制

见 pyb.

1. import pyb
     r" r6 q; C9 \. J
2. 
   1 C$ p3 _0 `. u+ C' H7 t, F( ~  m
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   1 L  b* a& R# z. C+ Z
4. pyb.wfi() # pause CPU, waiting for interrupt
   1 j: U4 l  G& w% G: V
5. pyb.freq() # get CPU and bus frequencies
   ; j+ _6 C# R  ^* y5 G2 w
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

% H' X8 z9 x3 j4 w: J
- Z$ d: `  x- Y' l! }延迟和计时

使用 time模块：

1. import time
   
2. 
   6 {( [4 b; W4 B5 h
3. time.sleep(1)           # sleep for 1 second
   + d5 c  S# a# e& H
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   , I% s2 G' F" c8 K1 `
5. time.sleep_us(10)       # sleep for 10 microseconds
   9 Z( A$ j- H" }% N8 D+ D* }+ w$ {
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

内部 LED

见 pyb.LED.

1. from pyb import LED
   6 z# L) s7 \, D; }! o
2. 
   
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   * E8 x  C8 O! t, g6 `
5. led.on()
   & X9 K4 l1 g7 F
6. led.off()
   
7. 
   8 H1 M5 K/ V/ B) P
8. # LEDs 3 and 4 support PWM intensity (0-255)
     F5 @3 M% F, D
9. LED(4).intensity()    # get intensity
   
10. LED(4).intensity(128) # set intensity to half

复制代码

' I8 s- z' X4 k& [9 V
+ Y# f. I& t, C* R7 E内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   
3. sw = Switch()
   
4. sw.value() # returns True or False
   - T: m' N# `; Z# M+ H
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

' h. i4 R9 b' v0 S4 F/ e5 a
引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   
2. 
   * k3 {3 s$ ?7 u# h' G  ?) r! V" m
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   1 g& i. w; D7 x3 r# l
5. p_out.low()
   
6. 
   * f0 E( |1 G6 K6 [
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   ! G1 p% G5 T. I- ?" w
8. p_in.value() # get value, 0 or 1

复制代码

( h  c% ^+ V" w" X7 @4 K
伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   ( H' z$ `& ^8 z  @
2. 
   + L/ |7 N% O$ G" `  G, C
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   
4. s1.angle(45) # move to 45 degrees
   
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   
6. s1.speed(50) # for continuous rotation servos

复制代码

7 x% {! y  `: A7 p6 e) p* E外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   : x( t# |0 @$ b- C9 z) I
3. callback = lambda e: print("intr")
   ; Z4 _( L4 j0 L4 E# c  ]$ ?
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

8 p1 K! w' c) B1 \% Q! U
) S1 B4 l' C# ~计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   
3. tim = Timer(1, freq=1000)
     g& }& w' x$ b/ Q* x( }6 L
4. tim.counter() # get counter value
   * z3 v- z3 e; m0 Q
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

  Y  h6 Z8 T, B$ @/ T$ {RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   ' K) g/ m+ z( e6 T* v
2. 
   
3. rtc = RTC()
   
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   
5. rtc.datetime() # get date and time

复制代码

. U- a1 z, K* O7 a3 W" B  D! U9 t  JPWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   3 l6 ^" x, J" a6 G7 [1 N, X
2. 
   
3. p = Pin('X1') # X1 has TIM2, CH1
   ' C$ H% G7 f8 o: P9 I
4. tim = Timer(2, freq=1000)
   
5. ch = tim.channel(1, Timer.PWM, pin=p)
   3 H7 Z3 x+ U: f9 ^8 p$ h% H
6. ch.pulse_width_percent(50)

复制代码

ADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   $ F( `2 Y- z* c* r
2. 
   , U& ]# z: K& Y9 }. v1 R
3. adc = ADC(Pin('X19'))
   # X) _& h# j; u: o) [8 t
4. adc.read() # read value, 0-4095

复制代码

6 b) K& I9 `. X" Y% y0 K, q4 F' J* ^DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   1 K3 Z3 P8 h  X+ m$ I! `) N) v
3. dac = DAC(Pin('X5'))
   
4. dac.write(120) # output between 0 and 255

复制代码

" |4 x* @1 }  }4 R$ d
7 J5 R  n+ L! _2 g9 QUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   
3. uart = UART(1, 9600)
   
4. uart.write('hello')
   
5. uart.read(5) # read up to 5 bytes

复制代码

" a  Z! C5 V4 S/ O2 A. ?' D
. }& R) d) v. _! G6 e4 \# JSPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   " ~5 q* q6 G% g
2. 
   8 y8 `! y# z- K! x( ?* G2 {! q
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   2 V2 O5 d4 b# H4 U
5. spi.recv(5) # receive 5 bytes on the bus
   
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

/ k8 d5 ]/ @; c" Y3 [
I2C总线

硬件 I2C 可通过I2C('X') 和用于 pyboard 的 X 和 Y 两半 I2C('Y')。或者，传入外围设备的整数标识符，例如I2C(1)。通过显式指定 scl 和 sda 引脚而不是总线名称，也可以使用软件 I2C 。有关更多详细信息，请参阅 machine.I2C.

1. from machine import I2C
   
2. 
   
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   
5. 
   
6. i2c.scan()                          # returns list of slave addresses
   
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   1 R7 M* i4 z% P' x
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   ' i9 ]8 k3 c  n9 m" h
9. 
   
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    0 V( y' y& D8 J: I1 v
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

( `# x  W2 P! u) h

注意：对于传统 I2C 支持，请参阅 pyb.I2C。

& G0 @% W$ }0 }  @% f  {( RI2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   9 u. Z7 ~& j) {1 ]! [
2. 
   ' i# d4 Q2 F$ j, f
3. i2s = I2S(2, sck=Pin('Y6'), ws=Pin('Y5'), sd=Pin('Y8'), mode=I2S.TX, bits=16, format=I2S.STEREO, rate=44100, ibuf=40000) # create I2S object
   / `! j8 v! N. Y. r' `% J. W& w
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   
5. 
   + O5 k- C- |: R# q# L2 {) x
6. i2s = I2S(1, sck=Pin('X5'), ws=Pin('X6'), sd=Pin('Y4'), mode=I2S.RX, bits=16, format=I2S.MONO, rate=22050, ibuf=40000) # create I2S object
   ' W5 {) B7 N; z  e  U7 x
7. i2s.readinto(buf)          # fill buffer with audio samples from I2S device

复制代码

I2S 类目前作为技术预览版提供。在预览期间，鼓励用户提供反馈。基于此反馈，I2S 类 API 和实现可能会更改。

PYBv1.0/v1.1 有一个 I2S 总线，id=2。PYBD-SFxW 有两条 I2S 总线，id=1 和 id=2。I2S 与 SPI 共享。

CAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   * m4 c# }  m0 X
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

8 A: W" I1 N( ^" r8 D. j$ C
内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   0 o! ~! v, |! }0 V; g# T0 W
2. 
   + m2 G; C" p: {$ S! l6 o
3. accel = Accel()
   
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

+ L# w, a2 K6 y* r1 B& f- j6 k* u
: ]  w: j0 z* P6 d7 W9 ^$ U% X

ThomasWoody

So happens. We can communicate on this theme.

ThomasWoody

Also that we would do without your very good idea

WilliamJah

I can not recollect.

Wayneessem

dgfergus ??? 2021-8-28 11:00
& v! ?& s" C4 |) j' e0 [Thank you for posting this for all of us

Very interesting information, I am looking forward to the continuation.

Karenpoics

You commit an error. I can defend the position. Write to me in PM, we will discuss.

Alinaldex

excellent idea and is duly

XRumerTest

Hello. And Bye.

XRumerTest

Hello. And Bye.