嵌入式软件架构基础设施设计方法

大家好，今天分享一篇嵌入式软件架构设计相关的文章。

软件架构这东西，众说纷纭，各有观点。在我看来，软件架构是软件系统的基本结构，包含其组件、组件之间的关系、组件设计与演进的规则，以及体现这些规则的基础设施。

软件架构，从来不是一件容易事，它贯穿在产品的整个生命周期，需要所有团队成员遵守并自律，才能将架构思想在软件中体现。新手工程师，由于经历的项目太少，看不到项目全貌，很难从全局理解软件架构。但软件架构真的只是资深工程师的专利吗？这个也不见得。

古人作文，讲究立意为先。今天工程师做项目和产品，也应该先立意。这个意，就是指要有高度。工程师入门能从软件架构的高度出发，看待软件问题，相信对软件的理解，会更加深刻一些。因此，我总结了软件架构的六个步骤，供嵌入式工程师参考。

上次谈到了嵌入式软件架构的第一个步骤，抽象层。建立抽象层（HAL或者DAL）的目的，是为了隔离硬件，让代码与硬件无关。即使整个项目的代码，由某工程师一个人完成，抽象层仍是是有必要的。

但这次我们要聊的是，统一的基础设施，这是针对多人合作一个项目，或者多个项目共享同一个系统架构的情况。

如果说，你手头的项目，没有与他人合作，也不会有后续的相关项目，软件基础设施这一步，可以直接跳过。

基础设施，分为硬件基础设施和软件基础设施。硬件基础设施，包含常用器件库、封装库、原理图库和硬件参考设计等等；而今天我们讨论的重点，主要在于软件基础设施。软件基础设施包含以下内容：

• 基础数据结构。
• 底层库。比如C标准库、加密库、校验库、工具库等等。
• 操作系统/调度机制。包含操作系统以及调度相关服务。
• 中间件。比如文件系统、协议栈、数据库等。
• 框架与机制。比如消息通信机制、事件驱动机制、状态机框架、行为树框架。
• 工具支持。
• 统一的编程工具链。
• 统一的代码风格和编程规范。

在一些小公司粗放的开发模式中，并不规定工程师所依赖的软件平台、硬件平台和工具，而是由工程师自己决定。很多工程师，也喜欢这种自由奔放的开发模式，认为只有在这种环境中，才能发挥自身创造力。这种认知是有偏差的，这个我们后续找机会详细讨论。

随着小公司研发能力的提升，对软件基础设施进行约束和规定，几乎是注定的事情。因为软件区别于其他技术的本质，是在于其复用性。

复用程度越高的软件，质量越高，对开发效率和开发质量的提升，就越大。无论从公司的降本增效还是科学管理的角度，都有着强大的动机，去统一软件基础设施。当软件的基础设施统一之后，会产生如下优点：

• 软件质量提升，风格的高度一致性
• 软件复用性，会提升至一个新的水平
• 将可复用的功能，尽量抽象到基础设施层，减少软件冗余，提升开发效率。
• 为高层模块提供约束和纪律
• 有利于团队的技术积累和技术传承
• 有利于团队的技术培训
• 是团队进行单元测试和测试驱动开发，以及跨平台开发的前提。

因此，是否统一，根本不是一个有争议的问题；如何统一，才是今天我们的重点。

一、基础类型与宏定义

统一的软件基础设施的前提，就是声明统一的基础数据类型和宏，以克服不同的硬件平台和编译器的差异性。

比如下面是我从开源项目EventOS中摘录出来的代码，不见得很完整，只能代表在我在项目里需求。

#include <stdbool.h>

typedef unsigned int                    eos_u32_t;
typedef signed int                      eos_s32_t;
typedef unsigned short                  eos_u16_t;
typedef signed short                    eos_s16_t;
typedef unsigned char                   eos_u8_t;
typedef signed char                     eos_s8_t;
typedef bool                            eos_bool_t;

#define EOS_NULL                        ((void *)0)

#define EOS_U32_MAX                     (0xffffffffU)
#define EOS_U32_MIN                     (0U)
#define EOS_U16_MAX                     (0xffffU)
#define EOS_U16_MIN                     (0U)
#define EOS_U8_MAX                      (0xffU)
#define EOS_U8_MIN                      (0U)

编译器相关的宏定义。使用宏，屏蔽掉编译器的差异，会

/* Compiler Related Definitions */
#if defined(__ARMCC_VERSION)           /* ARM Compiler */

    #define eos_section(x)              __attribute__((section(x)))
    #define eos_used                    __attribute__((used))
    #define eos_align(n)                __attribute__((aligned(n)))
    #define eos_weak                    __attribute__((weak))
    #define eos_inline                  static __inline

#elif defined (__GNUC__)                /* GNU GCC Compiler */

    #define eos_section(x)              __attribute__((section(x)))
    #define eos_used                    __attribute__((used))
    #define eos_align(n)                __attribute__((aligned(n)))
    #define eos_weak                    __attribute__((weak))
    #define eos_inline                  static __inline

#elif defined (__IAR_SYSTEMS_ICC__)     /* for IAR Compiler */

    #define eos_section(x)              @ x
    #define eos_used                    __root
    #define eos_align(n)                PRAGMA(data_alignment=n)
    #define eos_weak                    __weak
    #define eos_inline                  static inline

#else
    #error "The current compiler is not supported. "
#endif

一些常用的数据结构。这些数据结构，与硬件和编译器无关，是在代码中频繁使用，并在多个模块间共享的数据结构，有必要将其提升至基础设施的层面进行支持，以避免各个模块，对同一个数据类型，进行不同的定义带来的数据转换问题。

这些数据结构，与产品紧密相关，不同的产品类型之间，各自是不同的。比如下面的定义。

typedef struct eos_date
{
    eos_u32_t year               : 16;
    eos_u32_t month              : 8;
    eos_u32_t day                : 8;
} eos_date_t;

typedef struct eos_time
{
    eos_u32_t hour               : 8;
    eos_u32_t minute             : 8;
    eos_u32_t second             : 6;
    eos_u32_t ms                 : 10;
} eos_time_t;

typedef struct eos_imu_data
{
    float acc[3];
    float gyr[3];
    float mag[3];
} eos_imu_data_t;

二、操作系统

有些芯片的资源太小，是不能运行操作系统的。这些芯片，一般而言，也没有办法建立严谨的嵌入式软件架构，我们会在后续《小资源芯片的软件开发平台》中，单独进行讨论。这里只讨论芯片的。

不同的芯片，所能跑的操作系统是不同的。但如果要建立软件基础设施，应该尽量选取同一个操作系统。

在现存的操作系统中，FreeRTOS和国产RT-Thread对各种不同的硬件架构的芯片，支持比较广泛，可以作为RTOS的首选。

而当产品线异常丰富时，特别是使用了某些小众芯片，或者使用芯片商提供的操作系统时，就没有办法建立统一的软件基础设施。这时，有两个办法解决这一问题：

• 编写高层模块时，使用宏定义和条件编译，选择对应的RTOS API。这种一般用于所使用的操作系统较少的情况，比如说只有两三种。

static void *task_handler = NULL;

static void task_func_module_one(void *parameter);

void module_one_init(void)
{
    /* Newly creating a task to run the module. */
#if (EOS_RTOS_NAME == EOS_RTOS_NAME_FREERTOS)
    xTaskCreate(task_func_module_one,
                "TaskModule", 2048, NULL, 2,
                (TaskHandle_t *)&task_handler);
#elif (EOS_RTOS_NAME == EOS_RTOS_NAME_RTTHREAD)
    task_handler = rt_thread_create("led1", task_func_module_one, NULL,
                                    2048, 2, 20);
#else
    eos_assert(false);
#endif

    eos_assert(task_handler != NULL);
}

/* The task function of the module one. */
static void task_func_module_one(void *parameter)
{
    (void)parameter;

    /* Initialization. */

    while (1)
    {
        /* Add the task function. */
    }
}

• 建立操作系统抽象层（OSAL，Operating System Abstraction Layer），以屏蔽操作系统的差异，使高层模块依赖于OSAL。这种情况适合于资源丰富的情况。
著名的POSIX标准，就是为了建立OSAL的，FreeRTOS和RT-Thread都在不同程度上对POSIX标准进行了支持；在 v嵌入式领域，CMSIS_OS也是为了建立操作系统的统一接口；但无论是POSIX和CMSIS_OS，被各RTOS支持的力度是不同，因此如果我们产品中需要建立严谨的嵌入式软件架构，还是要建立属于自己的OSAL，以便屏蔽掉操作系统的不同带来的差异。