pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  

通用板控制

见 pyb.

1. import pyb
   8 [9 r/ Z( L  Z# A# r- ?* s
2. 
   0 B, Q& g# ~% h7 j% F' x: t$ Y2 ~
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   & _3 T; p4 {6 O1 L
4. pyb.wfi() # pause CPU, waiting for interrupt
   7 d+ ?# c* ~2 O+ w) T& P
5. pyb.freq() # get CPU and bus frequencies
   + _! J# F+ {! C
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

" v2 K6 [: k. O4 \2 e- F# B
; E/ f/ a6 F2 Y& Q$ d' {3 z延迟和计时

使用 time模块：

1. import time
   / z+ k/ h' z4 ]" G+ z+ u: B
2. 
   0 w, o  H; @1 n, d* t  ?3 k7 A
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   ( c6 }6 X$ _- Z- i% K! |
5. time.sleep_us(10)       # sleep for 10 microseconds
   $ e, d0 \- [" N+ e
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

2 v4 s- X& P% }. J内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   # {. @2 g" c" O, e/ _
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   # K  i! V% c# d$ I" R) F
5. led.on()
   
6. led.off()
   
7. 
   
8. # LEDs 3 and 4 support PWM intensity (0-255)
   
9. LED(4).intensity()    # get intensity
   * c5 w, x, a9 v0 j" B$ f- N
10. LED(4).intensity(128) # set intensity to half

复制代码

% I3 t4 r4 v# g+ u% K$ _3 c
内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   8 e% T! {2 J3 c
2. 
   6 [4 D7 w$ u6 `3 O6 u% b
3. sw = Switch()
   
4. sw.value() # returns True or False
   
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

6 Q$ i1 w, h; N0 V$ c1 y. s
引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   
2. 
   
3. p_out = Pin('X1', Pin.OUT_PP)
   ) }3 X  `" H) m) p7 }9 c( F
4. p_out.high()
   6 ~6 D* I: N2 i5 E) K# `/ U
5. p_out.low()
   1 l2 l8 W( o; H4 Y* s
6. 
   
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   ' w& ], _8 r' r2 _. x# O
2. 
   1 t* ?' @+ g( K' |4 }+ T) p1 t' d
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   $ f; Z- w) h+ y. L: c$ Y/ c: R
4. s1.angle(45) # move to 45 degrees
   
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   4 J3 O# b2 F! x, e% o/ f; R) P  t) h
6. s1.speed(50) # for continuous rotation servos

复制代码

: L5 G. m. X0 J" m$ z6 U: S9 w9 x/ E
外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   7 O. [+ B4 G% @. o- `
3. callback = lambda e: print("intr")
   9 A, J6 ~, q$ p; M: j0 H8 P
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

* M9 M% g6 R+ S/ s* m. j  B计时器

请参阅pyb.Timer.

1. from pyb import Timer
   9 y$ B* t0 o- c  N, I/ X
2. 
   
3. tim = Timer(1, freq=1000)
   
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

( D2 n3 _2 {# FRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   * B0 I8 T8 s6 |" Q
2. 
   
3. rtc = RTC()
   ( o' ^* t8 g1 f+ Z  o$ k4 n
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   
5. rtc.datetime() # get date and time

复制代码

1 \; M8 C& ]8 T7 `: O; hPWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   
2. 
   
3. p = Pin('X1') # X1 has TIM2, CH1
   
4. tim = Timer(2, freq=1000)
   6 K7 K) ~: b1 n5 u
5. ch = tim.channel(1, Timer.PWM, pin=p)
   : D3 Y6 J! o5 _/ R% q# D% @! U
6. ch.pulse_width_percent(50)

复制代码

ADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   8 e0 `# Y: |; F6 v. j$ J4 h
2. 
   
3. adc = ADC(Pin('X19'))
   $ U/ N+ M1 v- U6 f/ h
4. adc.read() # read value, 0-4095

复制代码

% e9 Q7 Y% w9 Y" t. @& b
9 @! k! {+ S% |. _DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   ' d7 _5 V# _# R' A& |: d
3. dac = DAC(Pin('X5'))
   ! C( k" c4 W% ^- t5 K) ^
4. dac.write(120) # output between 0 and 255

复制代码

4 D! N4 `1 x; V+ x7 ?
/ J5 z6 x9 E* E: \" t8 g! RUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   6 ?* m- V; ]2 a2 a( S
2. 
   
3. uart = UART(1, 9600)
   ! ~1 q6 D- }/ b+ p3 k. k/ W
4. uart.write('hello')
   ! M; n- C6 h  H* d
5. uart.read(5) # read up to 5 bytes

复制代码

2 L- n6 y3 r, c7 f
% n+ \, q+ F; c2 a1 USPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   
2. 
   - R9 I# H: y' t* }; l2 F
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   $ _" E3 k* t+ N( d
5. spi.recv(5) # receive 5 bytes on the bus
   
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

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
   " ?( r0 A" t1 _/ o$ b4 ^
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   # }6 c/ K0 L4 X( `; G6 d" z
5. 
   % L) a( ]/ v5 N* R
6. i2c.scan()                          # returns list of slave addresses
   
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   2 ?# W1 g$ M' J
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   6 k, j9 o0 N+ Y- A0 @" {
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    - w. k7 N7 b# g7 N7 s: D
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   
2. 
   ' [+ x3 ?/ N% T" ^$ u4 f- G
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
     k" p  D" C% w6 ^4 F
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   6 z0 C$ _4 N' O8 w) S" i
5. 
   ; m. K! U; H' e/ c' `9 \/ h& |
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
   
7. i2s.readinto(buf)          # fill buffer with audio samples from I2S device

复制代码

5 I! X- V) g/ }: a; @4 D- U: S

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
   7 i6 ^; i' l5 L; f/ L
2. 
   3 f, f3 O5 t4 H5 ]) T1 ^
3. can = CAN(1, CAN.LOOPBACK)
   ( S! Z) a6 h# G: r
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   
5. can.send('message!', 123)   # send a message with id 123
   & [' w0 ]' S- A( Y' H3 e
6. can.recv(0)                 # receive message on FIFO 0

复制代码

内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   : e; I! {4 u6 t( t
2. 
   $ t( z1 p2 k/ w. W: y9 x5 s
3. accel = Accel()
   ( H. `# B1 \1 Q% \  m
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

5 [9 k1 X# s. B  O  k

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
/ n7 j7 s1 k& b+ i- G/ Q- qThank you for posting this for all of us

: U* V( ~' p5 JVery 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.