pyboard 快速参考手册

闪电

pyboard 的快速参考

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

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

• 关于 pyboard 的一般信息
• pyboard 的 MicroPython 教程
  ) }) n8 B; o% u0 v

通用板控制

见 pyb.

1. import pyb
   
2. 
   
3. pyb.repl_uart(pyb.UART(1, 9600)) # duplicate REPL on UART(1)
   
4. pyb.wfi() # pause CPU, waiting for interrupt
   8 Z' h- I6 S9 j1 e
5. pyb.freq() # get CPU and bus frequencies
   ! M# h& \  b& n) ^+ l
6. pyb.freq(60000000) # set CPU freq to 60MHz
   
7. pyb.stop() # stop CPU, waiting for external interrupt

复制代码

, W' F( }" X, j- s% F
. w! ]7 L( a: M4 M延迟和计时

使用 time模块：

1. import time
   - q/ p, C, j( Z2 {6 I( W
2. 
   
3. time.sleep(1)           # sleep for 1 second
   : E( B% A! x$ \' Z
4. time.sleep_ms(500)      # sleep for 500 milliseconds
   
5. time.sleep_us(10)       # sleep for 10 microseconds
   6 Y: n" T0 z4 |9 z! a) G5 W4 m
6. start = time.ticks_ms() # get value of millisecond counter
   
7. delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference

复制代码

& Y& t7 g2 [+ Y. Z& P, |, \
! Q! z! [! A$ B内部 LED

见 pyb.LED.

1. from pyb import LED
   
2. 
   % {6 ?+ C% S0 z% x+ _% J6 M
3. led = LED(1) # 1=red, 2=green, 3=yellow, 4=blue
   6 h$ w' X$ ?" I+ m
4. led.toggle()
   - B5 r! N1 `- b$ `1 N: S
5. led.on()
   
6. led.off()
   ' x) i4 I" U8 ~8 x4 k
7. 
   $ `* X' |' m' I; ^4 R
8. # LEDs 3 and 4 support PWM intensity (0-255)
   
9. LED(4).intensity()    # get intensity
   - ~/ B" R, w5 y
10. LED(4).intensity(128) # set intensity to half

复制代码

% T5 x, l2 ?5 n) t! ^4 S
4 K( w9 w8 ~5 D! i6 }内部开关

请参阅 pyb.Switch.

1. from pyb import Switch
   
2. 
   
3. sw = Switch()
     S7 z& e' r5 C
4. sw.value() # returns True or False
   
5. sw.callback(lambda: pyb.LED(1).toggle())

复制代码

* r0 f  \* A6 N引脚和 GPIO

请参阅 pyb.Pin.

1. from pyb import Pin
   ; p, p% D; N8 x1 \9 p
2. 
   # x3 D, C# K& t& W1 t3 D
3. p_out = Pin('X1', Pin.OUT_PP)
   
4. p_out.high()
     U5 e- z" c$ w0 d# l" {
5. p_out.low()
   ( ^9 l8 w1 Z8 @8 x" \) ?
6. 
   4 z2 M4 C. {( w' M9 U3 T
7. p_in = Pin('X2', Pin.IN, Pin.PULL_UP)
   
8. p_in.value() # get value, 0 or 1

复制代码

4 {& h2 L8 J; B7 r( i6 l伺服控制

请参阅pyb.Servo.

1. from pyb import Servo
   8 k5 S) b4 o* C( J0 J
2. 
   % c! B- B$ j* e; r3 o1 h
3. s1 = Servo(1) # servo on position 1 (X1, VIN, GND)
   % ^( U0 L* y, c3 f% G
4. s1.angle(45) # move to 45 degrees
   ! g/ R# ]9 D- G) g
5. s1.angle(-60, 1500) # move to -60 degrees in 1500ms
   ) ~' Y* F9 z. A
6. s1.speed(50) # for continuous rotation servos

复制代码

外部中断

请参阅 pyb.ExtInt.

1. from pyb import Pin, ExtInt
   
2. 
   
3. callback = lambda e: print("intr")
   , Y% R" l. q9 Z. G7 Z6 G! J' z8 [
4. ext = ExtInt(Pin('Y1'), ExtInt.IRQ_RISING, Pin.PULL_NONE, callback)

复制代码

6 b% n, v* Q" n% F4 `' R* Y5 S( }9 F
4 D# ~& s: Z! f计时器

请参阅pyb.Timer.

1. from pyb import Timer
   + c! s9 e; Z' u* H' k# r% g; X
2. 
   " P+ Q4 l2 p0 K% l( v5 g4 [0 M
3. tim = Timer(1, freq=1000)
   
4. tim.counter() # get counter value
   
5. tim.freq(0.5) # 0.5 Hz
   
6. tim.callback(lambda t: pyb.LED(1).toggle())

复制代码

& r+ c/ {7 k5 Y9 h7 `% [; ~! ?2 b; wRTC（实时时钟）

请参阅 pyb.RTC

1. from pyb import RTC
   
2. 
   
3. rtc = RTC()
   1 G, _+ j: A. r) O# R
4. rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time
   
5. rtc.datetime() # get date and time

复制代码

7 z4 r$ s$ o" g7 h( s9 d& EPWM（脉宽调制）

请参阅pyb.Pin 和 pyb.Timer.

1. from pyb import Pin, Timer
   0 a$ n) @/ I2 {% m
2. 
   2 l) g8 c- A( N9 M
3. p = Pin('X1') # X1 has TIM2, CH1
   ' }: E" _& @1 o6 K
4. tim = Timer(2, freq=1000)
   6 N6 u3 C2 ]' v- O& {
5. ch = tim.channel(1, Timer.PWM, pin=p)
   ' v6 }2 E: Y: s% h( ?7 {
6. ch.pulse_width_percent(50)

复制代码

5 s8 h2 Q. d' i; j5 d& LADC（模数转换）

请参阅pyb.Pin 和pyb.ADC.

1. from pyb import Pin, ADC
   , ~. N+ q/ x. g
2. 
   
3. adc = ADC(Pin('X19'))
   
4. adc.read() # read value, 0-4095

复制代码

DAC（数模转换）

请参阅pyb.Pin 和 pyb.DAC.

1. from pyb import Pin, DAC
   ( {2 S6 z$ t$ T' C8 p2 p
2. 
   
3. dac = DAC(Pin('X5'))
   $ ?' z6 P! d# ~. U7 f  _% Q& h  f
4. dac.write(120) # output between 0 and 255

复制代码

6 u- g. ^7 p/ J' |' f+ @
UART（串行总线）

请参阅 pyb.UART.

1. from pyb import UART
   
2. 
   
3. uart = UART(1, 9600)
   
4. uart.write('hello')
   " `9 o1 P2 r& X% ^" P5 o- X
5. uart.read(5) # read up to 5 bytes

复制代码

) n6 X; C4 M  C# U1 f' z" eSPI总线

请参阅 pyb.SPI.

1. from pyb import SPI
   1 |) Y  `# i/ |# E' d* f, s
2. 
   
3. spi = SPI(1, SPI.MASTER, baudrate=200000, polarity=1, phase=0)
   
4. spi.send('hello')
   : w5 f$ A9 P; ?( Z+ q6 [
5. spi.recv(5) # receive 5 bytes on the bus
   # U/ B" f5 B) w% C, k- b
6. spi.send_recv('hello') # send and receive 5 bytes

复制代码

) L% D- U. I. g
( |6 w# E& |$ b3 @I2C总线

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

1. from machine import I2C
   
2. 
   ; N3 u' n& H* I# E" y' i* o
3. i2c = I2C('X', freq=400000)                 # create hardware I2c object
   1 x6 B5 i  W0 @5 j! Y2 R
4. i2c = I2C(scl='X1', sda='X2', freq=100000)  # create software I2C object
   - R# }  f9 C  f2 P/ X. |) o
5. 
   4 L$ G& _3 @! j; p+ |6 \2 R  d
6. i2c.scan()                          # returns list of slave addresses
   
7. i2c.writeto(0x42, 'hello')          # write 5 bytes to slave with address 0x42
   
8. i2c.readfrom(0x42, 5)               # read 5 bytes from slave
   ) S- C0 ^, z5 Z# i' `/ r4 a
9. 
   $ S) e# n% `, @! p+ x. Y4 I
10. i2c.readfrom_mem(0x42, 0x10, 2)     # read 2 bytes from slave 0x42, slave memory 0x10
    ( u2 R3 K' L8 _, e
11. i2c.writeto_mem(0x42, 0x10, 'xy')   # write 2 bytes to slave 0x42, slave memory 0x10

复制代码

. \# w' l2 G+ M& [3 a( e! P& U
6 I! x5 r! B2 ?

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

! Q+ I$ e5 }# H- N5 Z$ II2S总线

参见 machine.I2S.

1. from machine import I2S, Pin
   
2. 
   * a" w& ~8 I3 t8 y- c, N7 K
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
   ; |. _& P+ E9 g0 i7 [
4. i2s.write(buf)             # write buffer of audio samples to I2S device
   
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

复制代码

& T, ^$ e2 c4 Y& W

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

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

6 _1 u& q# i0 B7 g5 }2 ~CAN总线（控制器局域网）

参见 pyb.CAN.

1. from pyb import CAN
   
2. 
   
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
   
6. can.recv(0)                 # receive message on FIFO 0

复制代码

2 ^" D% w9 m7 p  `) C) B
: F, R* K8 J' b6 l内部加速度计

参见pyb.Accel.

1. from pyb import Accel
   - g, c: G/ S% R' y9 _
2. 
   
3. accel = Accel()
   9 c4 J+ S& [* q& c
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
9 U1 `0 `& a" n  }* g+ eThank 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.