OpenHarmony移植案例：如何適配服務啟動引導部件bootstrap_lite

base/startup/bootstrap_lite/    # 啟動引導元件
└── services
    └── source                  # 啟動引導元件原始檔目錄

    {
      "subsystem": "startup",
      "components": [
        {
          "component": "bootstrap_lite"
        },
        ......
      ]
    },

static void RegisterCustomATCmd()
{
    cmd_tbl_t cmd_list[] = {
        {"AT+IFCFG", 8, at_lwip_ifconfig, "AT+IFCFG - ifconfig\n"},
        {"AT+STARTAP", 7, at_start_softap, "AT+STARTAP - start wifi softap\n"},
        {"AT+STOPAP", 1, at_stop_softap, "AT+STOPAP - stop wifi softap\n"},
        {"AT+STARTSTA", 1, at_start_wifista, "AT+STARTSTA - start wifi sta\n"},
        {"AT+STOPSTA", 1, at_stop_wifista, "AT+STOPSTA - stop wifi sta\n"},
        {"AT+DHCP", 3, at_setup_dhcp, "AT+DHCP - dhcp\n"},
        {"AT+DHCPS", 3, at_setup_dhcps, "AT+DHCPS - dhcps\n"},
    };
    for (int i = 0; i < sizeof(cmd_list) / sizeof(cmd_tbl_t); i++) {
        console_cmd_add(&cmd_list[i]);
    }
}
SYS_SERVICE_INIT(RegisterCustomATCmd);

/* zInit code and data - will be freed after init */
 .zInit (.) :
 {
  __zinitcall_bsp_start = .;
  KEEP (*(.zinitcall.bsp0.init))
  KEEP (*(.zinitcall.bsp1.init))
  KEEP (*(.zinitcall.bsp2.init))
  KEEP (*(.zinitcall.bsp3.init))
  KEEP (*(.zinitcall.bsp4.init))
  __zinitcall_bsp_end = .;
  . = ALIGN(4);
  __zinitcall_device_start = .;
  KEEP (*(.zinitcall.device0.init))
  KEEP (*(.zinitcall.device1.init))
  KEEP (*(.zinitcall.device2.init))
  KEEP (*(.zinitcall.device3.init))
  KEEP (*(.zinitcall.device4.init))
  __zinitcall_device_end = .;
  . = ALIGN(4);
  __zinitcall_core_start = .;
  KEEP (*(.zinitcall.core0.init))
  KEEP (*(.zinitcall.core1.init))
  KEEP (*(.zinitcall.core2.init))
  KEEP (*(.zinitcall.core3.init))
  KEEP (*(.zinitcall.core4.init))
  __zinitcall_core_end = .;
  . = ALIGN(4);
  __zinitcall_sys_service_start = .;
  KEEP (*(.zinitcall.sys.service0.init))
  KEEP (*(.zinitcall.sys.service1.init))
  KEEP (*(.zinitcall.sys.service2.init))
  KEEP (*(.zinitcall.sys.service3.init))
  KEEP (*(.zinitcall.sys.service4.init))
  __zinitcall_sys_service_end = .;
  . = ALIGN(4);
  __zinitcall_sys_feature_start = .;
  KEEP (*(.zinitcall.sys.feature0.init))
  KEEP (*(.zinitcall.sys.feature1.init))
  KEEP (*(.zinitcall.sys.feature2.init))
  KEEP (*(.zinitcall.sys.feature3.init))
  KEEP (*(.zinitcall.sys.feature4.init))
  __zinitcall_sys_feature_end = .;
  . = ALIGN(4);
  __zinitcall_run_start = .;
  KEEP (*(.zinitcall.run0.init))
  KEEP (*(.zinitcall.run1.init))
  KEEP (*(.zinitcall.run2.init))
  KEEP (*(.zinitcall.run3.init))
  KEEP (*(.zinitcall.run4.init))
  __zinitcall_run_end = .;
  . = ALIGN(4);
  __zinitcall_app_service_start = .;
  KEEP (*(.zinitcall.app.service0.init))
  KEEP (*(.zinitcall.app.service1.init))
  KEEP (*(.zinitcall.app.service2.init))
  KEEP (*(.zinitcall.app.service3.init))
  KEEP (*(.zinitcall.app.service4.init))
  __zinitcall_app_service_end = .;
  . = ALIGN(4);
  __zinitcall_app_feature_start = .;
  KEEP (*(.zinitcall.app.feature0.init))
  KEEP (*(.zinitcall.app.feature1.init))
  KEEP (*(.zinitcall.app.feature2.init))
  KEEP (*(.zinitcall.app.feature3.init))
         KEEP (*(.zinitcall.app.feature4.init))
  __zinitcall_app_feature_end = .;
  . = ALIGN(4);
  __zinitcall_test_start = .;
  KEEP (*(.zinitcall.test0.init))
  KEEP (*(.zinitcall.test1.init))
  KEEP (*(.zinitcall.test2.init))
  KEEP (*(.zinitcall.test3.init))
  KEEP (*(.zinitcall.test4.init))
  __zinitcall_test_end = .;
  . = ALIGN(4);
  __zinitcall_exit_start = .;
  KEEP (*(.zinitcall.exit0.init))
  KEEP (*(.zinitcall.exit1.init))
  KEEP (*(.zinitcall.exit2.init))
  KEEP (*(.zinitcall.exit3.init))
  KEEP (*(.zinitcall.exit4.init))
  __zinitcall_exit_end = .;
  . = ALIGN(4);
 } > FLASH

board_ld_flags = [
....
  "-lbootstrap",

int main(void);
extern void OHOS_SystemInit(void);
    ......
        OHOS_SystemInit();
    ......
    while (1) {
        osDelay(1000);
        TRACE(0, "main idle");
    }
}

  /**
  * @brief Identifies the entry for initializing and starting a core system service by the
  * priority 2.
  *
  * This macro is used to identify the entry called at the priority 2 in the core system
  * service phase of the startup process. \n
  *
  * @param func Indicates the entry function for initializing and starting a core system service.
  * The type is void (*)(void).
  */
  #define SYS_SERVICE_INIT(func) LAYER_INITCALL_DEF(func, sys_service, "sys.service")
  /**
  * @brief Identifies the entry for initializing and starting a core system service by the
  * specified priority.
  *
  * This macro is used to identify the entry called at the specified priority in the core system
  * service phase of the startup process. \n
  *
  * @param func Indicates the entry function for initializing and starting a core system service.
  * The type is void (*)(void).
  * @param priority Indicates the calling priority when starting the core system service in the
  * startup phase. The value range is [0,5), and the calling sequence is 0, 1, 2, 3, and 4.
  */
  #define SYS_SERVICE_INIT_PRI(func, priority) LAYER_INITCALL(func, sys_service, "sys.service", priority)

⑴  typedef void (*InitCall)(void);

    #define USED_ATTR __attribute__((used))

⑵  #ifdef LAYER_INIT_SHARED_LIB
⑶  #define LAYER_INIT_LEVEL_0 0
    #define LAYER_INIT_LEVEL_1 1
    #define LAYER_INIT_LEVEL_2 2
    #define LAYER_INIT_LEVEL_3 3
    #define LAYER_INIT_LEVEL_4 4
⑷  #define CTOR_VALUE_device 100
    #define CTOR_VALUE_core 110
    #define CTOR_VALUE_sys_service 120
    #define CTOR_VALUE_sys_feature 130
    #define CTOR_VALUE_app_service 140
    #define CTOR_VALUE_app_feature 150
    #define CTOR_VALUE_run  700
⑸  #define LAYER_INITCALL(func, layer, clayer, priority)                                     \
        static __attribute__((constructor(CTOR_VALUE_##layer + LAYER_INIT_LEVEL_##priority))) \
            void BOOT_##layer##priority##func() {func();}
    #else
⑹  #define LAYER_INITCALL(func, layer, clayer, priority)            \
        static const InitCall USED_ATTR __zinitcall_##layer##_##func \
            __attribute__((section(".zinitcall." clayer #priority ".init"))) = func
    #endif
    // Default priority is 2, priority range is [0, 4]
    #define LAYER_INITCALL_DEF(func, layer, clayer) \
        LAYER_INITCALL(func, layer, clayer, 2)

void OHOS_SystemInit(void)
{
    MODULE_INIT(bsp);
    MODULE_INIT(device);
    MODULE_INIT(core);
    SYS_INIT(service);
    SYS_INIT(feature);
    MODULE_INIT(run);
    SAMGR_Bootstrap();
}

{        extern InitCall __zinitcall_sys_start;      \
        InitCall *initCall = &__zinitcall_bsp_start; \
        (initCall);                                      \
}

{        extern InitCall __zinitcall_bsp_end;      \
        InitCall *initCall = &__zinitcall_bsp_end; \
        (initCall);                                    \
}    

⑴  #define SYS_CALL(name, step)                                      \
        do {                                                          \
            InitCall *initcall = (InitCall *)(SYS_BEGIN(name, step)); \
            InitCall *initend = (InitCall *)(SYS_END(name, step));    \
            for (; initcall < initend; initcall++) {                  \
                (*initcall)();                                        \
            }                                                         \
        } while (0)

⑵  #define MODULE_CALL(name, step)                                      \
        do {                                                             \
            InitCall *initcall = (InitCall *)(MODULE_BEGIN(name, step)); \
            InitCall *initend = (InitCall *)(MODULE_END(name, step));    \
            for (; initcall < initend; initcall++) {                     \
                (*initcall)();                                           \
            }                                                            \
        } while (0)

    ......
⑶  #define SYS_BEGIN(name, step)                                 \
        ({        extern InitCall __zinitcall_sys_##name##_start;       \
            InitCall *initCall = &__zinitcall_sys_##name##_start; \
            (initCall);                                           \
        })

⑷  #define SYS_END(name, step)                                 \
        ({        extern InitCall __zinitcall_sys_##name##_end;       \
            InitCall *initCall = &__zinitcall_sys_##name##_end; \
            (initCall);                                         \
        })

⑸  #define MODULE_BEGIN(name, step)                          \
        ({        extern InitCall __zinitcall_##name##_start;       \
            InitCall *initCall = &__zinitcall_##name##_start; \
            (initCall);                                       \
        })
⑹  #define MODULE_END(name, step)                          \
        ({        extern InitCall __zinitcall_##name##_end;       \
            InitCall *initCall = &__zinitcall_##name##_end; \
            (initCall);                                     \
        })

⑺  #define SYS_INIT(name)     \
        do {                   \
            SYS_CALL(name, 0); \
        } while (0)

⑻  #define MODULE_INIT(name)     \
        do {                      \
            MODULE_CALL(name, 0); \
        } while (0)

⑴   #define INHERIT_SERVICE                                          \
        const char *(*GetName)(Service * service);                   \
        BOOL (*Initialize)(Service * service, Identity identity);    \
        BOOL (*MessageHandle)(Service * service, Request * request); \
        TaskConfig (*GetTaskConfig)(Service * service)

    ......
⑵  typedef struct Bootstrap {
        INHERIT_SERVICE;
        Identity identity;
        uint8 flag;
    } Bootstrap;

/**
 * @brief Identifies a service and feature.
 *
 * You can use this structure to identity a {@link IUnknown} feature to which messages will be
 * sent through the asynchronous function of {@link IUnknown}. \n
 *
 */
struct Identity {
    /** Service ID */
    int16 serviceId;
    /** Feature ID */
    int16 featureId;
    /** Message queue ID */
    MQueueId queueId;
};

  static const char *GetName(Service *service);
  static BOOL Initialize(Service *service, Identity identity);
  static TaskConfig GetTaskConfig(Service *service);
  static BOOL MessageHandle(Service *service, Request *request);

  static void Init(void)
  {
      static Bootstrap bootstrap;
      bootstrap.GetName = GetName;
      bootstrap.Initialize = Initialize;
      bootstrap.MessageHandle = MessageHandle;
      bootstrap.GetTaskConfig = GetTaskConfig;
      bootstrap.flag = FALSE;
      SAMGR_GetInstance()->RegisterService((Service *)&bootstrap);
  }
  SYS_SERVICE_INIT(Init);

static const char *GetName(Service *service)
{
    (void)service;
    return BOOTSTRAP_SERVICE;
}

static BOOL Initialize(Service *service, Identity identity)
{
    Bootstrap *bootstrap = (Bootstrap *)service;
    bootstrap->identity = identity;
    return TRUE;
}

⑴  typedef enum BootMessage {
        /** Message indicating that the core system service is initialized */
        /** 標識核心系統服務初始化完成 */
        BOOT_SYS_COMPLETED,
        /** Message indicating that the system and application-layer services are initialized */
        /** 標識應用層服務初始化完成 */
        BOOT_APP_COMPLETED,
        /** Message indicating service registration during running */
        /** 標識執行時的服務註冊 */
        BOOT_REG_SERVICE,
        /** Maximum number of message IDs */
        /** 標識訊息最大值，butt是菸蒂；屁股；槍托的意思，表示尾部吧 */
        BOOTSTRAP_BUTT
    } BootMessage;
    ......
  static BOOL MessageHandle(Service *service, Request *request)
  {
      Bootstrap *bootstrap = (Bootstrap *)service;
      switch (request->msgId) {
          case BOOT_SYS_COMPLETED:
⑵            if ((bootstrap->flag & LOAD_FLAG) != LOAD_FLAG) {
                  INIT_APP_CALL(service);
                  INIT_APP_CALL(feature);
                  bootstrap->flag |= LOAD_FLAG;
              }
⑶            (void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);
              break;

          case BOOT_APP_COMPLETED:
              (void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);
              break;

          case BOOT_REG_SERVICE:
              (void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);
              break;

          default:
              break;
      }
      return TRUE;
  }

  static TaskConfig GetTaskConfig(Service *service)
  {
      (void)service;
      // The bootstrap service uses a stack of 2 KB (0x800) in size and a queue of 20 elements.
      // You can adjust it according to the actual situation.
      TaskConfig config = {LEVEL_HIGH, PRI_NORMAL, 0x800, 20, SHARED_TASK};
      return config;
  }