嵌入汇编代码

blake

MicroPython 包涵可内联的汇编，允许用户使用汇编语言作为 Python 的子程序，且你可以像正常使用函数般使用它们。

返回值

内联汇编函数用特定的函数装饰器标示。我们从最简单的例子下手：

1. @micropython.asm_thumb
   
2. def fun():
   
3.    movw(r0, 42)

复制代码

你可以在脚本或是解释器里边使用该函数。该函数没有任何参数且返回数值42 。r0 是一个寄存器，其中的数值在函数返回值返回时被更改。MicroPython 一直将 r0视为一个整数并将其作为整数变量供使用者调用。

如果使用了命令 print(fun( )) 将能看到数值42被打印出来。

汇编语言基础

稍微复杂一些些，我们尝试点亮一盏灯：

1. @micropython.asm_thumb
   
2. def led_on():
   
3.    movwt(r0, stm.GPIOA)
   
4.    movw(r1, 1 << 13)
   
5.    strh(r1, [r0, stm.GPIO_BSRRL])

复制代码

上述代码使用了一些新的概念：

. stm 为 pyboard 的微处理器提供了一系列内容以便于连接寄存器。尝试在 REPL 里运行 import stm 和 help(stm) 。这将得到一清单的有用内容：

. stm.GPIOA 对应外围设备GPIOA 在内存中的地址。在 pyboard 板上红色的led 灯对应 A端口，PA13 引脚；

. movwt 将32位数值放入寄存器中。其可视为由两个指令集组成的简便函数：先是 movw 然后 movt 。movt 将16位立即数移 动。

.strh 存储半字数据。上述代码里将r1的低16位数值存入 r0 +stm.GPIO_BSRRL 的内存地址中。这将按照 r0 里设定的数值将 A 端口对应的引脚设置为高。例程中r0的第13位值被置位，故PA13 被拉高。因此红色LED 灯被点亮。

接受参数

内联汇编语言最多可以接收四个参数。一旦被使用，必须为 r0,r1,r2,r3 的寄存器或其里边的调用内容。以下是使用了这些参数的函数：

1. @micropython.asm_thumb
   
2. def asm_add(r0, r1):
   
3.    add(r0, r0, r1)

复制代码

这里使用了 r0=r0+r1 的计算。由于将结果放入了 r0 中，故其为返回结果。尝试运行asm(1,2)，将能得到 3 的返回值。

循环

我们可以分配 label(my_label)的标号，然后使用 b(my_label) 跳转到该分支，或者用 bgt(my_lable)进行有条件的跳转。下面例程使绿色的 LED 灯闪烁，闪烁次数存放在 r0 里边。

1. @micropython.asm_thumb
   
2. def flash_led(r0):
   
3.    # get the GPIOA address in r1
   
4.    movwt(r1, stm.GPIOA)
   
5.    # get the bit mask for PA14 (the pin LED #2 is on)
   
6.    movw(r2, 1 << 14)
   
7.    b(loop_entry)
   
8.    label(loop1)
   
9.    # turn LED on
   
10.    strh(r2, [r1, stm.GPIO_BSRRL])
    
11.    # delay for a bit
    
12.    movwt(r4, 5599900)
    
13.    label(delay_on)
    
14.    sub(r4, r4, 1)
    
15.    cmp(r4, 0)
    
16.    bgt(delay_on)
    
17.    # turn LED off
    
18.    strh(r2, [r1, stm.GPIO_BSRRH])
    
19.    # delay for a bit
    
20.    movwt(r4, 5599900)
    
21.    label(delay_off)
    
22.    sub(r4, r4, 1)
    
23.    cmp(r4, 0)
    
24.    bgt(delay_off)
    
25.    # loop r0 times
    
26.    sub(r0, r0, 1)
    
27.    label(loop_entry)
    
28.    cmp(r0, 0)
    
29.    bgt(loop1)

复制代码