pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

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

通用板控制

见 pyb.

1. import pyb
   / F' Z" V& }+ J# Q
2. 
   
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   % `* Y7 Z: T/ ]! r% r
4. pyb.wfi() # pause CPU, waiting for interrupt
   - v8 z. p+ [* e& |+ ?% I( _
5. pyb.freq() # get CPU and bus frequencies
   * `, m3 k1 ]0 F! V9 y! l) l
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

7 L+ U  `  m& ~* v( E
& N. L" ^) f1 w4 }- B8 b延迟和计时

使用 time模块：

1. import time
   4 U% D" U0 f; C6 Y3 B! R8 [0 M
2. 
   4 M& h5 J, }) n5 f6 [  z- Q
3. time.sleep(1)           # sleep for 1 second
   
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   
5. time.sleep_us(10)       # sleep for 10 microseconds
   8 X8 I$ n# t: n+ q! H6 O) c0 b2 L
6. start = time.ticks_ms() # get value of millisecond counter
   ' u: O( A' q& @: F
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   
5. led.on()
   2 Z$ x" O7 s! J- A1 b9 H
6. led.off()
   
7. 
   9 ^4 r% q5 X, D! u. p4 d6 c
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

复制代码

" l. H; j" g. S内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   . C# X) h( r* o" y5 y) ~
3. sw = Switch()
   
4. sw.value() # returns True or False
   % \/ W) _, p# T2 y8 Y
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

9 ^/ E( @. Z& S' G
* t2 O0 j/ j1 F5 z引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
     k0 g/ g6 Z# u2 \2 w
2. 
   * r7 D$ X2 }& b7 P6 X
3. p_out = Pin('X1', Pin.OUT_PP)
   : R4 Z  B; w/ l7 f4 a7 G
4. p_out.high()
   
5. p_out.low()
   
6. 
   & l3 Z) B- R" A' @; n
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

) w4 ?3 Z1 D7 s# j
2 W( ^+ T; u3 p7 B6 |; t: |( Y伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   ' D0 Z! u6 }, f5 \: `
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
   & p8 G* z: L& p. d. t
6. s1.speed(50) # for continuous rotation servos

复制代码

. v& O4 u8 T0 Q# M外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   & n# Z$ G& z  M) Z; K' g
3. callback = lambda e: print("intr")
   & ^9 U3 B: a9 t/ P+ Y1 _3 k6 }' f" O7 I
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

计时器

请参阅pyb.Timer.

1. from pyb import Timer
   . e! E. p4 g6 D& b/ a+ ~, M" X/ n4 q
2. 
   
3. tim = Timer(1, freq=1000)
   / R4 A) u7 h& A+ ?: m; \
4. tim.counter() # get counter value
   , T! y$ \5 E5 N" m( P, C$ T
5. tim.freq(0.5) # 0.5 Hz
   1 V4 Q& F) _, |0 p
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   / g( S$ ^& c4 s9 N2 i
3. rtc = RTC()
   7 J/ j) [- \, \% K! m. Z" N
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   
5. rtc.datetime() # get date and time

复制代码

PWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   
2. 
   & L9 U+ D& m2 a2 o
3. p = Pin('X1') # X1 has TIM2, CH1
   0 C" ]6 k5 c* A' C
4. tim = Timer(2, freq=1000)
   
5. ch = tim.channel(1, Timer.PWM, pin=p)
   
6. ch.pulse_width_percent(50)

复制代码

) P) m1 X) L' `4 W) LADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
     @3 \3 r, v, e6 g. s. J
2. 
   
3. adc = ADC(Pin('X19'))
   3 l6 h, A# p, W* [( `0 }
4. adc.read() # read value, 0-4095

复制代码

- @( P% |( h3 |1 [: C
: n" t( K& x3 b; i9 VDAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   
2. 
   : X7 D4 e. X4 ^& L/ d
3. dac = DAC(Pin('X5'))
   ! @# e" z3 P# W6 w9 A6 }* \
4. dac.write(120) # output between 0 and 255

复制代码

$ k+ v$ U1 @! b1 h4 Z( n8 H1 }
5 L' \6 H0 d; o0 g$ I' uUART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   4 n% _, N; ^8 ^0 _# k; S. G
2. 
   
3. uart = UART(1, 9600)
   + a$ Y& ~6 |5 E/ U: E
4. uart.write('hello')
   8 @) W, f/ t2 l  F- @
5. uart.read(5) # read up to 5 bytes

复制代码

, S( {% G6 ]; [, m6 ^: D5 Y3 R
SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   5 ]+ e9 b9 |  l' l
2. 
   7 t' V# _/ n$ J( \! C
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   9 J5 N+ m; i  d+ h" {, ]; @
4. spi.send('hello')
   , G/ C, u  M5 P
5. spi.recv(5) # receive 5 bytes on the bus
   / C$ J5 o6 ?+ t: B. D* }% }9 A
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

( I+ d  ^! n# T. P2 g; o( |0 }
: m" u  t3 Z$ ~/ j2 K6 WI2C总线

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

1. from machine import I2C
   - m  O: l: @( N1 J0 |
2. 
   * ^) f1 b. a2 |
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   5 B( t1 R  z+ N" w2 @3 J+ o8 \# K
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   ; Y0 f6 @( ~# d3 I; j
5. 
   % F3 a9 q6 V6 J$ V6 F# g6 O
6. i2c.scan()                          # returns list of slave addresses
   6 o3 B, ]' J! e4 ~2 l, {
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   0 V) D/ {. }: H. T- b
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    3 o) q! D& z& Z$ S4 k9 n
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

* t! ?' A* Z9 a) E+ A

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   
2. 
   9 K) x- w) h4 }* ~. K* r7 h9 W% M
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
   ' K7 w2 ?4 w) J6 C
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

复制代码

4 s4 o& J5 j% g, y$ F

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

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

" Q1 [1 q% d2 q* f4 g1 ]CAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   2 R1 o, H! G0 V% Y; \$ V
3. can = CAN(1, CAN.LOOPBACK)
   
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   
5. can.send('message!', 123)   # send a message with id 123
   9 \( ~% z7 S" Q$ F- Z. R
6. can.recv(0)                 # receive message on FIFO 0

复制代码

内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   
3. accel = Accel()
   . z6 }7 X) w: }0 y
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

$ R/ R) i  t- @1 @  }9 i; ]$ M8 Q; R% `6 g

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

8 }+ o4 Y+ n! e$ L" vVery 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.