pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  7 \# }4 L( d2 x

& X$ ~; M( b$ I0 y8 F0 }通用板控制

见 pyb.

1. import pyb
   / J8 D; C* o, Y" z& m: ]$ n
2. 
   / f7 o+ C* \. H1 V4 ]
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   ; ?7 z# }6 ?( [
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. 
   " b/ V5 j+ B* X9 f5 t* Q$ D
3. time.sleep(1)           # sleep for 1 second
   # k: q% r0 y0 u( `2 _- {& E
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   * b3 b; N( ]" e$ e, A% Y
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

复制代码

; f1 J7 m7 y0 E- P0 Y8 i6 I# V7 q5 s内部 LED

见 pyb.LED.

1. from pyb import LED
   & V- U' b* b# O) J4 q
2. 
   
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   ) X& t9 j- G3 I
4. led.toggle()
   - R* `5 A  A+ t+ ~. j- y
5. led.on()
   ' `+ C7 C( Q  d' r# _+ F4 g" _6 D
6. led.off()
   3 n: w: ^! r5 g. q( ]2 d0 S9 v
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

复制代码

5 p9 `" Y" x' _( t
, c# e5 E- Y5 S: c4 f内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   1 ?: s2 C; w6 r5 c
2. 
   7 }( a0 w; E: ?; j3 c) a% L6 N
3. sw = Switch()
   
4. sw.value() # returns True or False
     t: f+ G" F" R
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

9 _/ d& u7 P9 K3 E9 _引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   0 f% w5 ~; C& X7 \5 Q4 _) H
2. 
   , W+ Y% {9 z( y$ ]3 \! X( R
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   
5. p_out.low()
   
6. 
   + I6 \- X, `4 P
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   8 b& D# P: W  f  W3 Z- p  |; `$ m! @
8. p_in.value() # get value, 0 or 1

复制代码

& `% a9 Y  Q  q" C. M/ `: Q
伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
     h; }. R, D3 t1 H
2. 
   7 K' L( g4 h  J+ E  E: Z3 c
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   0 k" s9 x& t0 U1 g1 Y% U5 J
4. s1.angle(45) # move to 45 degrees
     ~9 K8 _2 v  k' ?) J6 `
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   
6. s1.speed(50) # for continuous rotation servos

复制代码

* b8 q8 [( U" |0 y! Z
外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   3 @# }+ }5 v' e
2. 
   % H( j" v8 R# X; V3 H. P, W
3. callback = lambda e: print("intr")
   
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

8 }' T$ S  r- A
4 P: B7 Q+ h4 q# Z; a计时器

请参阅pyb.Timer.

1. from pyb import Timer
   + T. ]3 n5 S0 t1 I5 ?0 N
2. 
   
3. tim = Timer(1, freq=1000)
   . C0 u8 P# {% @0 \( @
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

$ v. d/ h0 Z1 y5 g( S3 HRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   7 m- T( L8 D6 b5 R
3. rtc = RTC()
   
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   
5. rtc.datetime() # get date and time

复制代码

/ Y, n1 E7 G$ h0 m% M! e- EPWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   4 O' X9 e$ l* @0 v5 S+ |
2. 
   6 Y* m9 h+ w2 m
3. p = Pin('X1') # X1 has TIM2, CH1
   , X5 A/ v( ]! \. ~
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
   / Z9 |7 T1 [' f4 I% {
2. 
   
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

9 m" j( w2 }8 v7 g, @, _, YDAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   ) E! i1 A, Q  b* P! \  U( z8 z
2. 
   
3. dac = DAC(Pin('X5'))
   " l8 `+ z3 g, {
4. dac.write(120) # output between 0 and 255

复制代码

/ Q: P6 o! F2 d2 M2 h
UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   ( c, F/ y8 P8 f! J3 i3 i" H6 ]3 ^) E6 H
2. 
   2 ~7 B3 Y: q2 {5 F$ `  W
3. uart = UART(1, 9600)
   ) H+ A; U% y5 ~! ^5 {
4. uart.write('hello')
   
5. uart.read(5) # read up to 5 bytes

复制代码

& v" u7 t' x$ E- |
SPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   9 n$ B1 X* m, x- v1 Z
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
   - z! s/ e1 ?1 c! r- u7 N1 y5 y3 k4 J
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

, f) `! C2 m4 X7 o5 s) U4 B5 k0 Q5 x
I2C总线

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

1. from machine import I2C
   ; s! l! G  l7 i' X. g! _
2. 
   7 h6 M8 f6 }7 k" I) h5 Z# w
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   0 M" F8 ]5 |8 k; F
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   $ W2 U$ k7 z  H; W! O3 H
5. 
   
6. i2c.scan()                          # returns list of slave addresses
   $ l. x3 {) j& N% S' A8 B8 S7 W) w% L
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   # Z4 @, t% u$ {
9. 
   7 ?4 X' \$ }5 A; ~' C* j; q
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

复制代码

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   1 K4 ~, X$ [. T, O, N  M  m+ ?' T
2. 
   
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
   4 Z7 \0 z6 P$ h& v5 k" M! L8 S' |
5. 
   0 J+ {% N: \8 n7 I( P9 Y
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

复制代码

5 q0 Y$ t* s- Z

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

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

CAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   
3. can = CAN(1, CAN.LOOPBACK)
   4 i7 O: j4 h2 h7 {6 {" {
4. can.setfilter(0, CAN.LIST16, 0, (123, 124, 125, 126))
   
5. can.send('message!', 123)   # send a message with id 123
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   . M5 ?: n7 |$ R- z; @' ]
3. accel = Accel()
   
4. print(accel.x(), accel.y(), accel.z(), accel.tilt())

复制代码

% O7 l6 M9 D6 M, k

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
& b- c! e6 e9 Y3 `0 |- R( y0 C' _Thank you for posting this for all of us

- m6 j1 f& R) M+ V! X1 Q1 YVery 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.