pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  5 @) g, H! f( t# s! f

8 f) `' H: d& Q6 k" {- E通用板控制

见 pyb.

1. import pyb
   8 ~1 _, B3 j6 I. M5 N
2. 
   
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
   & Q6 T. P$ h* |6 q  _; j& M( z, c
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

, j* {3 n. d  q* [. f) D1 m5 A- q5 ^
7 R8 n3 i& w. G延迟和计时

使用 time模块：

1. import time
   
2. 
   
3. time.sleep(1)           # sleep for 1 second
   2 A+ H0 u0 }7 T$ @. e! s
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   : e1 |5 C( d8 H, ~# y0 ~
5. time.sleep_us(10)       # sleep for 10 microseconds
   
6. start = time.ticks_ms() # get value of millisecond counter
   & V; h. d1 J; `3 z% N, F6 l
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

/ a6 y8 n  [& F& A: p1 X
内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   / G/ f% \8 Z5 |/ {8 k
4. led.toggle()
   
5. led.on()
   6 [7 P9 M- I0 t/ {7 l- j
6. led.off()
   
7. 
   ! c# T; @5 {( G  ~% K
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

复制代码

内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   ( t% x5 F! U3 y' @7 O
2. 
   
3. sw = Switch()
   
4. sw.value() # returns True or False
   ( I7 ]; o. g# X3 }
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

: b! f, O1 F% r% [+ d  @
: {# H; ]+ s3 W7 j2 F: n) D1 J引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   $ ?4 g) I( F1 f
2. 
   % M! }: N) {. M( l
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   
5. p_out.low()
   0 k  j) }( |+ s/ e5 }
6. 
   4 J0 x8 l. R; q. W- L# r% z
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   4 }8 {1 r0 {" z
8. p_in.value() # get value, 0 or 1

复制代码

: Y/ k* f; x$ k! h
* `9 i8 ~' k# O  O; [- a伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   1 B9 |* p2 {, F- [) h
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
   , V/ L* d' u) K$ S) T6 O; R8 x: m
6. s1.speed(50) # for continuous rotation servos

复制代码

" v$ Y5 A2 Y9 S) |- h% K
+ L! y; p+ B. F$ z: m/ g) R外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   . ~+ u5 O4 h5 b, I! Z  f7 W
2. 
   
3. callback = lambda e: print("intr")
   6 ]3 _3 z5 X/ ]$ t& m) G8 d- M
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

3 W6 Y+ l# _+ }计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   
3. tim = Timer(1, freq=1000)
   % _- K% L- E6 f% T
4. tim.counter() # get counter value
   # [9 Y5 T  _$ f8 _+ P6 s
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

, r. S0 G9 v* V+ G2 g; {RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   % ?+ X$ Z1 `& B0 s2 G  s6 w. @* h
3. rtc = RTC()
   
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   6 Y: t2 R6 h. j) G4 L
5. rtc.datetime() # get date and time

复制代码

PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   + ?- B. H; h: f
2. 
   " C: b. F* i8 m( a: p5 ^4 Z! x
3. p = Pin('X1') # X1 has TIM2, CH1
   
4. tim = Timer(2, freq=1000)
   0 N3 p- I0 D4 p/ C* v( L- B) z
5. ch = tim.channel(1, Timer.PWM, pin=p)
   / V9 C; e$ {3 A' L5 O& z/ N9 }
6. ch.pulse_width_percent(50)

复制代码

ADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   
2. 
   
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

+ o, F4 l! A/ V% M& ^
DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   
3. dac = DAC(Pin('X5'))
   
4. dac.write(120) # output between 0 and 255

复制代码

9 w, P% A  ~4 j8 r2 H+ TUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   
3. uart = UART(1, 9600)
   * ^3 u/ @( a2 Z
4. uart.write('hello')
   - t% m' ^8 z8 U: F" x' a2 F. w
5. uart.read(5) # read up to 5 bytes

复制代码

SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   
2. 
   
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   : `  ?9 i& ~3 T& d* |
5. spi.recv(5) # receive 5 bytes on the bus
   
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

0 U# j' A7 s# c' n
0 o" |7 M& a+ Y. ?. hI2C总线

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

1. from machine import I2C
   . f$ A. j$ l7 A, K' P
2. 
   
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   ) K% u0 K* z& o! M- w, K! ]
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   
5. 
   7 L) F* J) w: ?# b2 M: N0 |
6. i2c.scan()                          # returns list of slave addresses
   : F' ]4 F5 e; N/ ]* I$ `2 U
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   4 u+ E9 F# k; _$ ~  O& d
9. 
   
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    % e3 R' z/ U* z+ Z, ~
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

& |' X4 `+ F5 j7 p7 m

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

; q" Y3 t$ Q( v* `/ |; lI2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   9 i2 Q6 N6 o! _* p0 ~
2. 
   0 ]4 V2 ~4 q% l3 p, ^  O
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
   1 \  S( a$ V- Y: r
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   
5. 
   ; X0 p$ r( X7 M5 K$ U6 U( E2 S; h  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
   * W  {7 i# C6 |' D( N! d+ _
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 共享。

# O4 p2 t9 Z: d. \: \% lCAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   6 ^% I% `& N# a6 L7 ~
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   5 R8 v7 _# N# Q6 Y/ V
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

' r. n# G# g/ M' I9 E' ~& Y* I
# j. H9 `, E  e7 i: _内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   9 v* z0 f1 E6 t
2. 
   . `8 g# u, T1 B" T
3. accel = Accel()
   1 A) ]# |9 x% _' p5 O: O, g3 D
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

* X# K9 {, S" y( T; k  m" [
: i8 t0 Z( Z1 q! D' Z  ?& g1 P

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
3 c6 T4 M2 B* d" {7 WThank you for posting this for all of us

+ i% x  S5 x  H, HVery 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.