pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  " @. j# O: h& ^* r4 F. c

通用板控制

见 pyb.

1. import pyb
   
2. 
   ) X2 ~3 }3 H3 E2 _- n9 O$ E
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   
4. pyb.wfi() # pause CPU, waiting for interrupt
   
5. pyb.freq() # get CPU and bus frequencies
   - E" X; V$ P1 M4 |. f- ?4 d
6. pyb.freq(60000000) # set CPU freq to 60MHz
   ) I& ?0 @% H- l$ w+ h
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

延迟和计时

使用 time模块：

1. import time
   
2. 
   
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   ) g2 d) Z1 p* U
5. time.sleep_us(10)       # sleep for 10 microseconds
   
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

2 P/ \' D: p& x- l$ ]9 R9 i+ k
内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   4 l3 _, P# F1 u" i7 ^( B& n, k
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   
5. led.on()
     q  ^5 E5 v, f8 C! C" E, ?& r) c
6. led.off()
   
7. 
   : z; V0 Q5 Z- `6 r
8. # LEDs 3 and 4 support PWM intensity (0-255)
   # E( ]& l1 K" v6 j8 I# o4 r+ }
9. LED(4).intensity()    # get intensity
   + n8 M: @0 n$ K" g
10. LED(4).intensity(128) # set intensity to half

复制代码

( V9 V9 M& }1 M( t' n$ Z+ W/ U3 A! c" Q
内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   $ r: [( ~) Z$ C- q
2. 
   
3. sw = Switch()
     Z8 @+ _. [+ m4 o' M
4. sw.value() # returns True or False
   3 Z& I- |* ^8 j. F5 N5 s
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

% H' S6 t, [1 ^0 _- W
引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   
2. 
   ; ]9 n0 V$ _: q  n8 S3 \5 h
3. p_out = Pin('X1', Pin.OUT_PP)
   % t. C: B! d* p3 [! \1 @# h& y
4. p_out.high()
   
5. p_out.low()
   
6. 
   
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

0 Y: M' S; o2 {& H* V7 t伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
     u; c  L+ A1 d2 q6 C5 c5 q
2. 
   
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
   + z! {# j, |+ ]* l
6. s1.speed(50) # for continuous rotation servos

复制代码

6 x$ v% Z1 i$ t4 \, x; j外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   ( I- e( Y0 D* L, l" O4 C1 P) _+ ?
2. 
   
3. callback = lambda e: print("intr")
   0 G* ^) s0 e- t2 ~2 x, j7 f
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

  b8 A  V- P- Y- j& N% V
计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   6 A6 U  l8 `2 j4 ?
3. tim = Timer(1, freq=1000)
   
4. tim.counter() # get counter value
     Y" c* @7 S* L: M
5. tim.freq(0.5) # 0.5 Hz
   2 Q+ t7 r* [- B. |* T7 J2 h3 g
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

  W+ J# C; [" D% j" bRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   6 {; o" L: V( m: d
2. 
   5 W7 P9 t* u0 f$ @4 W  w
3. rtc = RTC()
   ! v) L! y+ b9 G+ B
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   7 b- l: ]9 _: u& L9 y. ~& T9 N
5. rtc.datetime() # get date and time

复制代码

. |8 f9 r( Z' b6 UPWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   
2. 
   
3. p = Pin('X1') # X1 has TIM2, CH1
   4 O4 N3 M0 E) w
4. tim = Timer(2, freq=1000)
   & e# D- _, C$ x1 }/ _$ d, n7 l
5. ch = tim.channel(1, Timer.PWM, pin=p)
   
6. ch.pulse_width_percent(50)

复制代码

4 p6 M( F9 w+ X, Z7 L, }+ pADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   
2. 
   $ ^# t, T$ I1 }% e, V9 e, D
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   9 ^; Z! B7 ^) C+ a6 ?
2. 
   
3. dac = DAC(Pin('X5'))
   
4. dac.write(120) # output between 0 and 255

复制代码

% g# V' \* x) y5 D7 G6 x
UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   / ~, C% B6 p* Q2 Y
2. 
   ! l0 }0 }# w' F7 ~! F4 _
3. uart = UART(1, 9600)
   * B4 e7 |) U6 d% ?* v0 T$ G
4. uart.write('hello')
   - i3 l% i# Z0 W6 w: j  x) R# L
5. uart.read(5) # read up to 5 bytes

复制代码

* A/ O" }2 F. W" F- J5 M, XSPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   
2. 
   4 i3 r: `, n) S' q
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   , @/ D" H* ^+ ]: d/ q! O, y/ {& N
4. spi.send('hello')
     \+ V; r9 X7 ?$ Y% r; e
5. spi.recv(5) # receive 5 bytes on the bus
   
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

; K! l' l5 ?2 x6 G
I2C总线

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

1. from machine import I2C
   * R+ ]  f* m6 Z0 K) P; O
2. 
   ' F& a; V9 Y1 C+ ^; [
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   9 D8 W/ a8 k8 H* _% e" V, B+ i
5. 
   + F+ S5 A5 \- G$ T# Z# V
6. i2c.scan()                          # returns list of slave addresses
   0 U9 E7 a$ i/ ?+ ^. N
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   # i5 B7 H9 I  l' S' g; t; v. Q2 Q
9. 
   
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

/ p4 X* t: f6 j% V9 A3 M  o0 s

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

  Z: o# g1 [! V% cI2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   6 Q5 [; `1 G3 i3 ^6 d: d. e$ F
2. 
   5 s( z% f3 q" ?$ v
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
   
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   
5. 
   
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
     u! e1 L6 |8 _7 F( s
7. i2s.readinto(buf)          # fill buffer with audio samples from I2S device

复制代码

  \5 g- ^3 G) y- @, A% j& q/ b

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

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

# X: G4 n1 K* }* p* t* ICAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   + G) }6 e) ?+ E
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

9 H: @# w3 g% M* P. y
. V5 q6 p$ Y7 w& `7 o$ ~4 B内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   
3. accel = Accel()
   
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

8 v* F3 d2 z' A7 `! s3 b1 y
3 J( Z# m( K; s8 A- s8 s

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
Thank you for posting this for all of us

6 \  x0 i  B8 T/ r0 P8 uVery 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.