pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

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

, h  A1 U% A# a) Q通用板控制

见 pyb.

1. import pyb
   
2. 
   
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   1 t, v; \( d& _! X
4. pyb.wfi() # pause CPU, waiting for interrupt
   ! U* C' Z& o+ ^, ]5 G
5. pyb.freq() # get CPU and bus frequencies
   " ~8 k$ F9 Q( f0 S# I
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

: Z& S3 C8 {6 {% Y
, F4 |8 {5 }/ [! K& ?, e# l延迟和计时

使用 time模块：

1. import time
   1 c: l& j! `* ?
2. 
   
3. time.sleep(1)           # sleep for 1 second
   8 q0 m' G/ Y1 t  |
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   ! d6 j1 W1 U2 A5 R
5. time.sleep_us(10)       # sleep for 10 microseconds
     |! |0 S+ i9 E4 Y1 I7 m) ~2 X3 T
6. start = time.ticks_ms() # get value of millisecond counter
   1 d9 X% c4 Y( S- U4 O
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

6 S" T/ H1 @6 ?, o, g内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   8 ~; l; ^' v$ T+ I9 v9 y: P$ n- E
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   
4. led.toggle()
   
5. led.on()
   ) \- B, R$ k3 s! H% e1 g4 @; G
6. led.off()
   
7. 
   ' R; |; X' d$ G" t! B: K
8. # LEDs 3 and 4 support PWM intensity (0-255)
   
9. LED(4).intensity()    # get intensity
   ) y. i2 A2 ?& `( q$ V1 T
10. LED(4).intensity(128) # set intensity to half

复制代码

' _' Q' Z/ f9 d3 B
3 H" R+ k  C, W  D7 D2 X+ T! B内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   5 ~% [9 w: o/ J* X& n% r: z; A5 p
3. sw = Switch()
   3 s" i& i% \; L8 u( X. M( g
4. sw.value() # returns True or False
   5 q' D3 M. ]( j
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

, O9 j! W2 H7 U2 [1 o4 r. Q# w引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   
2. 
   / H$ v1 F( t' m  y& t
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
   
5. p_out.low()
   - z# v) f+ C( k) G1 z, \
6. 
   
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
     C+ C8 B; v, z8 e5 l
8. p_in.value() # get value, 0 or 1

复制代码

伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   
2. 
   ; Q0 }( A$ e) W( c! g/ ~( X* F
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   0 k5 a  |$ o' k
4. s1.angle(45) # move to 45 degrees
   + ]; w' J3 b# ]* ], \
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   6 r. j) S0 L, ]2 D
6. s1.speed(50) # for continuous rotation servos

复制代码

! Y' k2 l9 W! I7 I+ n3 V0 j
4 a9 Q% R) H. ?* D# v9 K2 I* f外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   
3. callback = lambda e: print("intr")
   
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

% h# j6 Y6 J# W  ]# T3 q
# K5 x% T7 E* D. }+ d9 l# @+ C计时器

请参阅pyb.Timer.

1. from pyb import Timer
   , C$ H$ b- @- ~: {5 n+ F
2. 
   ; t3 u* Q3 k6 I7 ?0 }
3. tim = Timer(1, freq=1000)
   & B; }- F/ t1 s3 t
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   9 |5 l  s$ x( a
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

RTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   7 J( r4 @+ Y( e7 g; j- j
2. 
   / s3 o) a5 D3 y( g" J' y. ~
3. rtc = RTC()
   ) B5 l6 u; N3 P2 Y$ ~, O
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. 
   
3. p = Pin('X1') # X1 has TIM2, CH1
   
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
   ) o, t$ O, n+ \7 `% z, y4 X
2. 
   ) S7 t; B5 K8 g" J( m- C
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   3 b4 C1 ~/ U/ \5 n1 B1 n0 b
2. 
   + ^7 w4 F6 b. |# Q4 k9 c7 g
3. dac = DAC(Pin('X5'))
   ! k. N! l5 A1 B6 u0 }. x% g9 W
4. dac.write(120) # output between 0 and 255

复制代码

UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   
3. uart = UART(1, 9600)
   
4. uart.write('hello')
   & }2 ?) o9 U( s
5. uart.read(5) # read up to 5 bytes

复制代码

+ Z1 Z- B2 {" k9 O/ P
7 x2 b( S1 a; H; c! kSPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   % T" }! f) c% _
2. 
   5 D+ e% I! ]3 D- G9 [6 ]1 s
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
   4 }, d* h) _& S- S6 c* I" K0 [6 y6 H& N! B
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

" U( P* H& V: d6 s5 U
I2C总线

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

1. from machine import I2C
   - n! g, X* ~  A% f1 ^/ N9 s' l. [
2. 
   
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   % I; S: I* c7 j5 N* y  L5 a$ _
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   
5. 
   2 D6 n3 {" c: Y' D- Q' Y: \
6. i2c.scan()                          # returns list of slave addresses
   4 H3 t% c. k+ ^8 ]9 t( c
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   ; e0 {' }& y' k4 X* j' C% @
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   
9. 
   
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

复制代码

2 M3 f: w" _) ~7 I$ E

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

I2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   ' u1 M0 K* e, z% V
2. 
   ; o8 C) P: g" V
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
   % F7 U4 ~2 O0 f1 z: [& Q/ f) ]
5. 
   " ]2 h6 |9 M9 R; L, F% M
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
     L! X* X2 R" j
7. i2s.readinto(buf)          # fill buffer with audio samples from I2S device

复制代码

# j+ H) l: h  m1 W: s

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

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

% L# A; l. t6 O, I* t' X/ kCAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   3 f/ d7 u" I' q, u7 L2 W4 @% e, M
3. can = CAN(1, CAN.LOOPBACK)
   - H3 g$ T# ~8 |" @0 d7 a3 X
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

复制代码

: {% a5 F' E* P
7 M7 M! F+ }8 s/ @) J" ]. n# `内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   
2. 
   3 {% @3 F( ~7 p1 ?7 z& E& F
3. accel = Accel()
   
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.