pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  $ L+ o" G9 V, Y$ O! k' t5 T

通用板控制

见 pyb.

1. import pyb
   % N" H/ X1 v4 G) E( m% K6 H0 |
2. 
   6 `9 x, `" [' d. D6 @
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   $ j0 b* ^, e5 s8 a/ m* K
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
   
2. 
   5 @3 e/ {. N) ~4 O6 f' L, q
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   0 Z; P3 b7 i1 a( O! c! _, i7 `; z
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

复制代码

0 z& v# r( W9 |! m2 [! g. ~内部 LED

见 pyb.LED.

1. from pyb import LED
   0 b$ Q' b1 s5 A1 d$ j
2. 
   + P/ H% V5 s8 W+ Z+ d4 ^7 b
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   ' l3 Q/ ?$ c5 I2 [! M# h
4. led.toggle()
     Q% l7 k  C2 x
5. led.on()
   
6. led.off()
   
7. 
   
8. # LEDs 3 and 4 support PWM intensity (0-255)
   5 h1 }( k0 v( @8 F
9. LED(4).intensity()    # get intensity
   
10. LED(4).intensity(128) # set intensity to half

复制代码

: Z( L# I) e& z, N  _
内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   
3. sw = Switch()
   
4. sw.value() # returns True or False
   
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

- S" B/ o/ n6 `2 ?* x& a9 j
+ @. ^2 m. b0 \( A$ w3 Z; E& ]1 p/ y引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   ; S2 B( F' U+ M& l) W
2. 
   3 V7 m. ?" M0 ~& E5 b
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   / _0 H+ Z6 J* b+ i  l4 J
5. p_out.low()
   
6. 
   
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
     d" A5 N5 C4 y
2. 
   5 \0 y2 \' `' g* e& @: X% i
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   
4. s1.angle(45) # move to 45 degrees
   " I8 g( \" q4 D  x) D9 c$ Y
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   
6. s1.speed(50) # for continuous rotation servos

复制代码

, [: J9 O3 I8 d" ?- U( n" u外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   & _  ~- C( `$ w/ r
3. callback = lambda e: print("intr")
   
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

4 Y, C" T) r( {0 _. P, a4 }计时器

请参阅pyb.Timer.

1. from pyb import Timer
   
2. 
   7 u; b- H6 q9 {: ?
3. tim = Timer(1, freq=1000)
   7 Q# h9 O8 J8 l6 |# @( J# v
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   ) @8 [6 D& s6 g8 ?
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

9 k6 x: b. S+ I9 ~0 U1 n9 mRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   3 Q& a  w5 p4 h) \$ {$ G! g
2. 
   
3. rtc = RTC()
   3 V5 h3 {% J9 f/ ]& G- V* ]
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   & n- q6 A# B( f. D2 q7 B( Z; A
5. rtc.datetime() # get date and time

复制代码

) I+ E( [9 \! [' ?$ z1 ?PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   % D, L/ l4 H7 P, i7 \
2. 
   9 t% I" I$ }, ~+ f: t5 f# F
3. p = Pin('X1') # X1 has TIM2, CH1
   3 D% |* q# {: m2 D  N0 H# I3 {
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'))
   
4. adc.read() # read value, 0-4095

复制代码

, f6 q; G. B  T3 H
. D& h& K* {( D1 a! fDAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   
3. dac = DAC(Pin('X5'))
   5 o" u* M$ r4 N/ O  E
4. dac.write(120) # output between 0 and 255

复制代码

( e5 H& R1 g; l; V5 y; t  F
UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   
3. uart = UART(1, 9600)
   * n: }6 I3 W' p0 E( T- E' X$ }3 r( f# q
4. uart.write('hello')
   # S8 O5 l0 E" a1 z
5. uart.read(5) # read up to 5 bytes

复制代码

$ ^7 j5 R2 S0 A+ W+ R& B- ^) ~+ T; O
SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   
2. 
   : z* y! u# |* g( S
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   . D4 Y, E3 Y! N* K5 O
5. spi.recv(5) # receive 5 bytes on the bus
   ' I0 ^% p8 ~0 P0 B) k7 G% i( p5 z& f
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

. S& A( x4 J- l. k$ PI2C总线

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

1. from machine import I2C
   
2. 
   , U; [  Y& n' V# M
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   3 m8 B$ w9 i1 |7 L0 u5 j- ]
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   - u9 O9 o3 F" C/ Z: m
5. 
   - d2 f% A- e+ x* k5 z0 V
6. i2c.scan()                          # returns list of slave addresses
   4 G/ ], p+ c1 T% v3 H) x
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   . Y$ `' `6 V8 c8 M- d
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    ; C* t" F* i. f$ h
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

! h' w3 U# k/ I8 L  I$ M1 P1 P( S

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

% P* {, G% U* XI2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   - @" ]/ {) }* E) M9 j" W6 A
2. 
   1 k( `( n9 ]5 i
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
   # W4 T7 c8 ?! {$ w
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   ) ~3 {: _5 \& f+ V8 H2 [) ?/ F
5. 
   ; X+ ]0 }3 U+ t7 {0 \
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
   ( ]$ n' y1 t' Z' f
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 共享。

) k: c0 `  P5 ~, K/ `CAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   . J( Z" h; @3 j
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   ; |6 _' |5 q: k# m6 q- Z
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   $ ~: N" Q) p1 q. W4 R+ o
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

- Y: [7 |0 e" F+ U
内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   1 F6 c6 v) ^1 p/ m) `
2. 
   
3. accel = Accel()
   
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

& e4 W% A1 p7 F
% O* w+ b( w. W. x

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
1 B$ N& b' F: b! _Thank you for posting this for all of us

9 O/ @' _& E& C2 x+ @7 X$ _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.