pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  " C9 o9 b! Z" a" ]8 t7 q7 v

/ R1 m4 w# F$ w. e  X" c通用板控制

见 pyb.

1. import pyb
   * T# s! [2 f) D  Q- ~
2. 
   + }! @6 N8 k) G# w/ J* Q
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   * q0 k  p9 F' q$ H% P$ B5 p
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
   6 a0 {, M5 ^9 e
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

* J& V. E8 ]4 j/ y6 E* @' X延迟和计时

使用 time模块：

1. import time
   ( ?, u1 ^8 Q' c3 M
2. 
   
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   . N& G6 b. p6 w% a2 L% |# `# d' u
5. time.sleep_us(10)       # sleep for 10 microseconds
   ; q) w; d. z& a) p" J2 @2 h, [( Y, K
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

1 D* U: N8 ~3 l3 Q# t6 y
内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   / C0 C! B4 d+ S4 e) y6 {0 j+ T
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   6 ?, b: I+ k( n$ P4 H
5. led.on()
   
6. led.off()
   
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

复制代码

+ e0 c% N  _. g: v内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   * B$ W# ?2 T4 e* Y; S* |
3. sw = Switch()
   ' b- c. n* u! d8 J2 C2 d3 d
4. sw.value() # returns True or False
   6 K, r7 A! ~" p6 J8 }6 q! |4 n
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

1 ?# f4 S' O2 c+ j# ?. S0 Z7 g引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   ' c( L3 H0 w+ I. k
2. 
   $ v' k9 Q  R0 V4 F4 S
3. p_out = Pin('X1', Pin.OUT_PP)
   & D) s8 Y5 W2 y  P( Z
4. p_out.high()
   9 n# W: P( F3 |
5. p_out.low()
   9 [+ I4 h# f1 n9 r& u
6. 
   
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   ! l1 T- u: [* V5 g+ [
8. p_in.value() # get value, 0 or 1

复制代码

伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   
2. 
   5 ?' p$ f: `3 M: l
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   $ E2 S% J5 Y" l& e. D  m4 n6 X
4. s1.angle(45) # move to 45 degrees
   , `& ]4 D3 Q* s0 F! T  J
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   ) m& D0 m. S3 \! M9 U( H" e( E
6. s1.speed(50) # for continuous rotation servos

复制代码

& {. h- [: T3 _8 H8 ~, v( L" Z% b外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   , m! o7 D- D% Y7 i
2. 
   
3. callback = lambda e: print("intr")
   7 x% i6 k  K# W& q0 p* c2 o6 T
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

% X2 r3 o; {; k) u2 {, }
8 i" c; Q- d6 D9 V计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   
3. tim = Timer(1, freq=1000)
   
4. tim.counter() # get counter value
   ; Y: {( E5 f. M1 f6 F
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

, _3 Q  g- S5 j- t7 cRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   
3. rtc = RTC()
   
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   & ~) ~. p* n/ ?; G$ x
5. rtc.datetime() # get date and time

复制代码

PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   ' L7 Y$ u  X; k. X6 g% o
2. 
   
3. p = Pin('X1') # X1 has TIM2, CH1
   + |7 P, b; }6 W  C3 b* r7 E
4. tim = Timer(2, freq=1000)
   
5. ch = tim.channel(1, Timer.PWM, pin=p)
   
6. ch.pulse_width_percent(50)

复制代码

ADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   
2. 
   
3. adc = ADC(Pin('X19'))
   ) P* p' W) m: o! w
4. adc.read() # read value, 0-4095

复制代码

$ q& U& a# Y  j: T, T. L( Q1 t* t
DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   % j  Q0 J3 n, ?2 S" }+ e* [, k
2. 
   8 z/ W9 F- e" h, f. `
3. dac = DAC(Pin('X5'))
   
4. dac.write(120) # output between 0 and 255

复制代码

* ]2 w1 S, X! g+ i- h. U: ^( D4 SUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   1 |( N- }- o9 i% `
2. 
   
3. uart = UART(1, 9600)
   
4. uart.write('hello')
   , F5 X1 Y6 {9 P, Y
5. uart.read(5) # read up to 5 bytes

复制代码

% q. s8 b# W, T4 t& z& b
SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   . v% ^' }" `9 v# F1 o  c
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
   * }$ H6 |$ O+ P% V8 L
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. 
   6 `! {1 X) l9 ~7 E
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   1 H1 f+ f+ `- c% W8 W% e4 ]
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   ! W1 J5 b5 \& j7 v: ~7 w$ h
5. 
   4 g6 N8 [; J. Z8 L) \( k
6. i2c.scan()                          # returns list of slave addresses
   , {* h9 ]* e4 ^3 o  k9 H* R2 }
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   2 t6 F6 ]& u8 z  p
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

复制代码

) M  u5 e; H' I% t- ~4 f# M# P

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

3 [& Y; C+ J+ Y$ Z  u/ RI2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   3 a7 ]) C/ m: u# N5 Z( ?7 |
2. 
   8 l6 e  W+ X. q: [
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
   / k9 _& I: T6 H. i8 y. U* u! m
5. 
   : g5 z7 \% I; ]4 D4 a- _3 u
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
   5 g. H# N0 [/ V9 f8 u# D6 h
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 共享。

* p' ~& T+ {6 C% oCAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   7 \* g5 _: |' B) [/ ~- t
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   2 y4 h' ^- F# F, [6 K/ H2 X
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

# W) v, E) ]& m8 x内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   # G9 x0 t) j" F* m9 Q
2. 
   6 s' i) N+ d6 K
3. accel = Accel()
   * `5 `9 h/ [6 S; E
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

4 x0 g) w& W) H) h

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

$ J) v* b# U: }9 L( C) wVery 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.