microPython的源码解析之 nlrx64.c

MicroPython 是一种适用于微控制器和其他受限环境的 Python 编程语言的实现。它旨在提供与 Python 3 语言的紧密兼容，同时考虑到内存和计算资源的限制。MicroPython 库是这门语言的核心组成部分，提供了一系列的模块和函数，使得开发者能够在硬件上执行各种任务。
下面将通过系列文章,逐一解读microPython,以便让读者了解掌握microPython的整个核心逻辑.,以便读者可以透过这个Python的最小内核,掌握Python解析器的核心实现逻辑,学习世界上最优秀的源码设计之一.

microPython Python最小内核源码解析
以下是您提供的代码段，包括将中英文注释翻译为中文，并添加了一些额外的注释以便更好地理解代码的功能和结构：
此代码段主要涉及非本地返回（Non-Local Return，NLR）的实现，用于在异常处理和函数跳转中保存和恢复寄存器状态。代码中使用了内联汇编来直接操作硬件寄存器，以实现对NLR的底层支持。此外，代码还考虑了不同操作系统（Windows和非Windows）的情况，以及不同的编译器和其版本。

#include "py/mpstate.h"

// 如果定义了MICROPY_NLR_X64，则执行以下代码
#if MICROPY_NLR_X64

// 取消定义nlr_push，可能是为了使用下面自定义的函数
#undef nlr_push

// x86-64架构中，调用者需要保存的寄存器包括：
//  rbx, rbp, rsp, r12, r13, r14, r15

// 定义nlr_push_tail函数，用于保存非本地返回（NLR）信息
__attribute__((used)) unsigned int nlr_push_tail(nlr_buf_t *nlr);

// 如果不是MICROPY_NLR_OS_WINDOWS操作系统
#if !MICROPY_NLR_OS_WINDOWS
// 如果使用clang编译器或者GCC版本大于等于8，则定义USE_NAKED为1
#if defined(__clang__) || (defined(__GNUC__) && __GNUC__ >= 8)
#define USE_NAKED 1
// 否则，如果是较老的GCC版本，使用优化选项来省略帧指针
#else
__attribute__((optimize("omit-frame-pointer")))
#endif
#endif

// 如果没有定义USE_NAKED，则将其设为0
#ifndef USE_NAKED
#define USE_NAKED 0
#endif

// 如果定义了USE_NAKED，则nlr_push函数的入口不应该将帧指针寄存器ebp压入栈中
#if USE_NAKED
// 定义nlr_push函数，使用naked属性，表示该函数的栈帧可能不完整
__attribute__((naked))
#endif
unsigned int nlr_push(nlr_buf_t *nlr) {
   
    // 如果没有定义USE_NAKED，则忽略nlr参数
    #if !USE_NAKED
    (void)nlr;
    #endif

    // 如果是Windows操作系统
    #if MICROPY_NLR_OS_WINDOWS
    // 使用内联汇编将需要保存的寄存器值存储到nlr_buf结构体中
    __asm volatile (
        "movq   (%rsp), %rax        \n" // 加载返回地址%rip
        "movq   %rax, 16(%rcx)      \n" // 将返回地址存储到nlr_buf中
        "movq   %rbp, 24(%rcx)      \n" // 将%rbp寄存器值存储到nlr_buf中
        "movq   %rsp, 32(%rcx)      \n" // 将%rsp寄存器值存储到nlr_buf中
        "movq   %rbx, 40(%rcx)      \n" // 将%rbx寄存器值存储到nlr_buf中
        "movq   %r12, 48(%rcx)      \n" // 将%r12寄存器值存储到nlr_buf中
        "movq   %r13, 56(%rcx)      \n" // 将%r13寄存器值存储到nlr_buf中
        "movq   %r14, 64(%rcx)      \n" // 将%r14寄存器值存储到nlr_buf中
        "movq   %r15, 72(%rcx)      \n" // 将%r15寄存器值存储到nlr_buf中
        "movq   %rdi, 80(%rcx)      \n" // 将%rdi寄存器值存储到nlr_buf中
        "movq   %rsi, 88(%rcx)      \n" // 将%rsi寄存器值存储到nlr_buf中
        "jmp    nlr_push_tail       \n" // 跳转到C语言实现的nlr_push_tail函数继续执行
        );
    // 否则，如果是非Windows操作系统
    #else
    // 使用内联汇编将需要保存的寄存器值存储到nlr_buf结构体中
    __asm volatile (
        "movq   (%rsp), %rax        \n" // 加载返回地址%rip
        "movq   %rax, 16(%rdi)      \n" // 将返回地址存储到nlr_buf中
        "movq   %rbp, 24(%rdi)      \n" // 将%rbp寄存器值存储到nlr_buf中
        "movq   %rsp, 32(%rdi)      \n" // 将%rsp寄存器值存储到nlr_buf中
        "movq   %rbx, 40(%rdi)      \n" // 将%rbx寄存器值存储到nlr_buf中
        "movq   %r12, 48(%rdi)      \n" // 将%r12寄存器值存储到nlr_buf中
        "movq   %r13, 56(%rdi)      \n" // 将%r13寄存器值存储到nlr_buf中
        "movq   %r14, 64(%rdi)      \n" // 将%r14寄存器值存储到nlr_buf中
        "movq   %r15, 72(%rdi)      \n" // 将%r15寄存器值存储到nlr_buf中
        // 如果是苹果系统，则跳转到_nlr_push_tail，否则跳转到nlr_push_tail
        #if defined