microPython的源码解析之 modsys.c

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

microPython Python最小内核源码解析

这段代码是MicroPython系统模块的实现，它提供了与CPython标准库中的sys模块相似的功能。代码中定义了各种属性和函数，例如版本信息、平台信息、可执行文件路径、退出函数、打印异常信息等。这些功能对于MicroPython的运行和开发都是非常重要的。代码中的注释已经翻译成中文，并且添加了一些额外的注释来帮助理解代码的结构和功能。

#include "py/builtin.h" // 包含MicroPython内置类型和函数的头文件
#include "py/objlist.h" // 包含列表对象的实现
#include "py/objmodule.h" // 包含模块对象的实现
#include "py/objtuple.h" // 包含元组对象的实现
#include "py/objstr.h" // 包含字符串对象的实现
#include "py/objint.h" // 包含整数对象的实现
#include "py/objtype.h" // 包含类型对象的实现
#include "py/stream.h" // 包含流的实现
#include "py/smallint.h" // 包含小整数优化的实现
#include "py/runtime.h" // 包含MicroPython运行时环境的实现
#include "py/persistentcode.h" // 包含持久化代码的实现
#include "extmod/modplatform.h" // 包含平台相关扩展模块的实现
#include "genhdr/mpversion.h" // 包含MicroPython版本信息的生成

#if MICROPY_PY_SYS_SETTRACE
#include "py/objmodule.h"
#include "py/profile.h"
#endif

#if MICROPY_PY_SYS

// 每个端口定义的，这些的类型是无关紧要的，只需要指针
extern struct _mp_dummy_t mp_sys_stdin_obj; // 标准输入对象
extern struct _mp_dummy_t mp_sys_stdout_obj; // 标准输出对象
extern struct _mp_dummy_t mp_sys_stderr_obj; // 标准错误输出对象

#if MICROPY_PY_IO && MICROPY_PY_SYS_STDFILES
const mp_print_t mp_sys_stdout_print = {
   &mp_sys_stdout_obj, mp_stream_write_adaptor}; // 定义标准输出的打印方式
#endif

// version - Python语言版本，本实现遵循的版本，以字符串形式表示
static const MP_DEFINE_STR_OBJ(mp_sys_version_obj, "3.4.0; " MICROPY_BANNER_NAME_AND_VERSION); // 定义MicroPython版本字符串

// version_info - Python语言版本，本实现遵循的版本，以整数元组形式表示
// TODO: CPython现在已经是5元素数组（主版本号，次版本号，微版本号，发布级别，序列号），但目前只节省2个元素...
static const mp_rom_obj_tuple_t mp_sys_version_info_obj = {
   {
   &mp_type_tuple}, 3, {
   MP_ROM_INT(3), MP_ROM_INT(4), MP_ROM_INT(0)}}; // 定义版本信息元组

// sys.implementation对象
// 这个对象保存MicroPython版本信息
static const mp_rom_obj_tuple_t mp_sys_implementation_version_info_obj = {
   
    {
   &mp_type_tuple},
    4,
    {
   
        MP_ROM_INT(MICROPY_VERSION_MAJOR), // 微Python主版本号
        MP_ROM_INT(MICROPY_VERSION_MINOR), // 微Python次版本号
        MP_ROM_INT(MICROPY_VERSION_MICRO), // 微Python微版本号
        #if MICROPY_VERSION_PRERELEASE
        MP_ROM_QSTR(MP_QSTR_preview), // 如果是预发布版本，添加预览标签
        #else
        MP_ROM_QSTR(MP_QSTR_), // 否则添加空字符串
        #endif
    }
};
static const MP_DEFINE_STR_OBJ(mp_sys_implementation_machine_obj, MICROPY_BANNER_MACHINE); // 定义实现机器信息字符串

#define SYS_IMPLEMENTATION_ELEMS_BASE \
    MP_ROM_QSTR(MP_QSTR_micropython), // 微Python名称
    MP_ROM_PTR(&mp_sys_implementation_version_info_obj), // 微Python版本信息对象指针
    MP_ROM_PTR(&mp_sys_implementation_machine_obj) // 机器信息对象指针

#if MICROPY_PERSISTENT_CODE_LOAD
#define SYS_IMPLEMENTATION_ELEMS__MPY \
    , MP_ROM_INT(MPY_FILE_HEADER_INT) // 如果启用了持久化代码加载，添加文件头整数
#else
#define SYS_IMPLEMENTATION_ELEMS__MPY
#endif

#if MICROPY_PY_ATTRTUPLE
#if MICROPY_PREVIEW_VERSION_2
#define SYS_IMPLEMENTATION_ELEMS__V2 \
    , MP_ROM_TRUE // 如果是预览版本2，添加真值对象
#else
#define SYS_IMPLEMENTATION_ELEMS__V2
#endif

static const qstr impl_fields[] = {
   
    MP_QSTR_name, // 名称字段
    MP_QSTR_version, // 版本字段
    MP_QSTR__machine, // 机器字段
    #if MICROPY_PERSISTENT_CODE_LOAD
    MP_QSTR__mpy, // 持久化代码字段
    #endif
    #if MICROPY_PREVIEW_VERSION_2
    MP_QSTR__v2, // 预览版本2字段
    #endif
};
static MP_DEFINE_ATTRTUPLE(
    mp_sys_implementation_obj,
    impl_fields,
    3 + MICROPY_PERSISTENT_CODE_LOAD