pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

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

通用板控制

见 pyb.

1. import pyb
   ( L3 h" W; G6 f' [9 o" N
2. 
   ) W$ ?0 q1 z' ^% d" M- R
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   
4. pyb.wfi() # pause CPU, waiting for interrupt
   3 t) w/ u9 T1 S$ R' @( B/ c2 E1 l9 R6 z
5. pyb.freq() # get CPU and bus frequencies
   
6. pyb.freq(60000000) # set CPU freq to 60MHz
   ! I, f- B% P' d% y
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

7 i% {1 N/ f6 m7 x: y- T延迟和计时

使用 time模块：

1. import time
   
2. 
   
3. time.sleep(1)           # sleep for 1 second
   2 S5 o& p" g* G7 P7 g
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   
5. time.sleep_us(10)       # sleep for 10 microseconds
   ' _; T) L! ^7 D2 t( n" ?
6. start = time.ticks_ms() # get value of millisecond counter
   2 }" h' ]+ Y! K# p4 k
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   # s$ V4 U: A# m7 Z
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   , e% S" V, T1 P# F7 v; r
5. led.on()
   
6. led.off()
   7 C+ h. A2 w# L) Z
7. 
   , [7 @8 x  ~% I: F& d) h& y8 }
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

复制代码

- G0 u! I1 R/ b* ~. k2 A
$ v- V+ \- j" n, ?4 \$ p内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   / U/ I$ [- I) ]* ^
2. 
   
3. sw = Switch()
   4 A! T* t& ?+ c( D7 H! d( w
4. sw.value() # returns True or False
   . m8 A" }! D# C6 o) S* v* y4 M; i; S
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

" ~/ x% q. E7 z( r
8 d0 U7 `' h- O! L4 D4 P引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   
2. 
   8 x: n( z. k$ Q$ G
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   
5. p_out.low()
   
6. 
   : q9 L0 S4 |2 _3 G* ]- A2 R
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   / D8 h. t; ~6 W) Z/ `2 G
8. p_in.value() # get value, 0 or 1

复制代码

9 t2 C; E* j% }: i. @9 E4 B伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   : q9 V+ a5 K1 R" B* d) E
2. 
   : D3 i/ }3 H$ {7 m' u! b
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
   
6. s1.speed(50) # for continuous rotation servos

复制代码

外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   + s, o' k) d7 Z, r
2. 
   
3. callback = lambda e: print("intr")
   ' Z) Q0 X+ ^- ~1 P# k2 k9 ~, V
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   7 i, e: z" g  C, [, L$ w
3. tim = Timer(1, freq=1000)
   , A- M6 i& L* O0 |
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   + ~: u' R" Q/ V9 v
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   + ?4 C% i* X: _: d9 F# }
2. 
   
3. rtc = RTC()
   
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   * L4 F9 o2 ^  T, {0 i. o2 G) K
5. rtc.datetime() # get date and time

复制代码

PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   ( h+ S, z/ n0 `7 q1 x2 `
2. 
   " G' j( _+ L; F$ m$ M+ g
3. p = Pin('X1') # X1 has TIM2, CH1
   + Y( U/ _3 F3 A5 U
4. tim = Timer(2, freq=1000)
   
5. ch = tim.channel(1, Timer.PWM, pin=p)
   3 ?) R3 }: D6 v5 }
6. ch.pulse_width_percent(50)

复制代码

/ d% l4 k0 t2 q! a6 l! kADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   : e3 Q$ A+ Q# A5 q- H3 x, o! z
2. 
   6 o/ T: v7 R. `7 h6 u, i& y
3. adc = ADC(Pin('X19'))
   ) a# }% B& F/ r
4. adc.read() # read value, 0-4095

复制代码

1 y7 ^5 l7 F- b+ aDAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   4 i- C2 D' _8 l- e
3. dac = DAC(Pin('X5'))
   3 l5 v7 I6 t" Z3 V
4. dac.write(120) # output between 0 and 255

复制代码

% I. {0 K% U! c0 }1 R1 G
4 e8 M. }& w* A2 g8 UUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   8 w# F. S- s. J5 Z6 W! D8 e% J- Z
3. uart = UART(1, 9600)
   1 y: |0 ^8 O5 X: `6 W& s
4. uart.write('hello')
   
5. uart.read(5) # read up to 5 bytes

复制代码

. U$ N  M  z5 I% E7 t$ {  p
+ P' T8 u1 a# r# X0 ?SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   1 C* [5 M' I; x% Q# E% _
2. 
   
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
     W/ S) M/ b, n0 w" e7 e  c1 Q
5. spi.recv(5) # receive 5 bytes on the bus
   
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

$ s9 O) \9 W( P" t1 eI2C总线

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

1. from machine import I2C
   - f* M7 G2 x+ [, r$ Q
2. 
   4 I) r/ S; q) s4 Q4 B+ a4 V
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   ( ^6 x3 h4 N: b8 }6 j! j$ x
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   5 ]: N3 C3 t) z0 B, ^
5. 
   
6. i2c.scan()                          # returns list of slave addresses
   ; \1 E0 s3 v- {1 R
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   ( x9 b' s  ^5 n, Q& k/ b$ Z
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   2 L: n. B4 e" f
9. 
   " n) T. n) G) H( q8 N# b5 J6 \' \
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

复制代码

: f3 F" r6 ?7 h+ v* d+ X

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   
2. 
   & k9 a# |0 _8 o+ I! 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
   9 m3 I7 h& b7 y# F2 o" n& J
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   + z, b3 b& t" r2 N8 i1 o
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
   # M6 C# O- n3 q9 A/ \
7. i2s.readinto(buf)          # fill buffer with audio samples from I2S device

复制代码

% y# l/ {1 D% ^

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

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

/ v# h9 C  j. f3 g' `. V: M# A# h- UCAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   . i! M% }8 [; ]0 j
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   9 q2 O0 d8 [: ?8 R9 Y
5. can.send('message!', 123)   # send a message with id 123
   6 X; x( H: A+ m$ j1 E7 `! u
6. can.recv(0)                 # receive message on FIFO 0

复制代码

内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   
3. accel = Accel()
   7 R" Z! U* ?: P/ S3 d
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

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

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.