pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  + b+ L* F% ^- {* L* l) g" M

: S! p" x9 ?8 E, w) w) C' c通用板控制

见 pyb.

1. import pyb
   7 F- E7 O* ]/ B+ {9 q: g
2. 
   3 c3 C+ ?% y" w4 u* q6 j2 C/ d
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
   
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

延迟和计时

使用 time模块：

1. import time
   " F3 w& G3 G$ e+ j& ^4 i" a
2. 
   
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   ; Q1 a0 K3 Y7 W+ L! W$ Y. V. h3 O! f* O
5. time.sleep_us(10)       # sleep for 10 microseconds
   4 L. O; e5 ]8 j1 J& N
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

# S1 ?# _3 H7 o% B; @: }内部 LED

见 pyb.LED.

1. from pyb import LED
   & d: W, z/ m& \0 T; c8 L! C/ w; V
2. 
   & b* }0 v* Q1 A4 u. r4 o8 l% Q
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   8 M+ z$ k. y' `( e
4. led.toggle()
   ' x9 V7 E* J! @. ^
5. led.on()
   
6. led.off()
   & j. u+ J2 C1 ?; F. E9 w
7. 
   
8. # LEDs 3 and 4 support PWM intensity (0-255)
   
9. LED(4).intensity()    # get intensity
   
10. LED(4).intensity(128) # set intensity to half

复制代码

  H0 t7 b& l& ^8 S  h2 U, [
内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   : N% `8 `+ v7 y# I5 {. L- l, G" \, V
3. sw = Switch()
   # F0 u, O0 c. Z, b1 ~
4. sw.value() # returns True or False
   . k5 }& k: E9 z
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

# _! r& I8 ]2 M* Y3 X! E3 m+ z/ m0 U
" y: ~% I% c$ P1 T! ?引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   # T8 h$ Z* n: E9 [. m
2. 
   
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   
5. p_out.low()
   
6. 
   & _/ B4 l) _/ i( l6 ^- y. p" g
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

" O( z5 h: G& Q
8 |$ d0 E) m8 a8 R  O伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   
2. 
   0 u4 U/ I, Y+ E
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   6 N& {4 I& G2 o4 t# G
4. s1.angle(45) # move to 45 degrees
   7 {3 |6 ^$ M8 b+ Q" k$ |
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   / n0 y+ H* c" b' J  _: {
6. s1.speed(50) # for continuous rotation servos

复制代码

9 u3 |, {8 S; l, B0 ]+ t外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   - K# K) K- F' _4 a; b* F: a
2. 
   
3. callback = lambda e: print("intr")
   
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

& O( m& M: R* F  P6 I/ k
7 i' S' i8 ~1 e8 \  S' n计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
     b$ X- a6 S/ m. X1 ~
3. tim = Timer(1, freq=1000)
   7 k' t7 I* @" b2 c$ c
4. tim.counter() # get counter value
   ( i% H7 D& z! I7 U$ u
5. tim.freq(0.5) # 0.5 Hz
   - u* D/ \8 k  e! A8 _: m
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   , ?1 W: P2 J5 D6 d6 b. _
3. rtc = RTC()
   ! [" q. L0 u: \) ?; N
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   8 ?' C0 ~* B; P$ h+ I& e9 c& E9 Q
5. rtc.datetime() # get date and time

复制代码

PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   
2. 
   9 W- T) D) b8 R3 s
3. p = Pin('X1') # X1 has TIM2, CH1
   . q2 e7 B+ ^2 X5 ?
4. tim = Timer(2, freq=1000)
   
5. ch = tim.channel(1, Timer.PWM, pin=p)
   
6. ch.pulse_width_percent(50)

复制代码

& `; H1 q! Y! [. {ADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   / S2 W( z$ r9 H* F, _. ?: h" d
2. 
   1 l4 c: ]+ X2 P* O* `  U
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

2 t. D# I8 l+ q3 p" U, F# O0 R& wDAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   3 T1 v% q0 O' Q- ~0 M+ g
3. dac = DAC(Pin('X5'))
   
4. dac.write(120) # output between 0 and 255

复制代码

% l- @: ^: y/ _% T  P% C% {
UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   % n; M& H# I: C( f8 P
2. 
   
3. uart = UART(1, 9600)
   5 i% L, n+ I- X7 r- t) {% E- ]: u
4. uart.write('hello')
   , U; L3 p+ j% E$ e
5. uart.read(5) # read up to 5 bytes

复制代码

* {: c! P2 y8 G5 p0 w
SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   * d) [4 g- ]! }5 b8 c& ]- e
2. 
   
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   
5. spi.recv(5) # receive 5 bytes on the bus
   " p, n3 x/ ?0 b: c' i$ j
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

. P! I: Z" }' m0 |% L
4 ^5 T7 K' X4 Z9 g* CI2C总线

硬件 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
   " v$ x" z" R# O
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   
5. 
   ) i7 t. ^( P3 t: E7 d8 _
6. i2c.scan()                          # returns list of slave addresses
   " g, a: ~& p, S+ _3 z
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   5 c. w; u: H  ]! v8 W
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   % }1 z' D6 Q2 M$ r$ f, E
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    ; r* ^/ }  u% |/ C
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

( n/ E3 ?- a4 ]  u( ], M( g/ J6 ]

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   0 g0 T9 G0 r  {/ ^/ Z
2. 
   
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
   5 G. F3 H* o& |4 j- |& {: A
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
   
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
   1 J9 L8 k; _# ?5 I7 p7 V7 k
2. 
   3 V7 _- D. y) K* V2 k2 B( y
3. can = CAN(1, CAN.LOOPBACK)
   
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   " m/ S' O9 I# O7 H1 v9 h
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   * C5 f! [- u8 C1 o2 u6 _
3. accel = Accel()
   
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

( s1 E( d. U+ A

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
7 E3 v9 N3 {: n8 `; m1 c, ~& RThank 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.