AWTK 在騰訊 TOS 上的移植筆記

本文以 STM32f103ze 為例，介紹了 AWTK 在 RTOS 上移植的經(jīng)驗(yàn)。與其說移植，倒不如說是集成。因?yàn)?RTOS 通常沒有提供標(biāo)準(zhǔn)的 LCD 驅(qū)動(dòng)接口，顯示部分并不需要特別的改動(dòng)。所做的事情不過是把 AWTK 放到 RTOS 的一個(gè)線程中執(zhí)行而已。

1. 加入 TOS 相關(guān)文件。

AWTK 已經(jīng)移植到 STM32f103ze 裸系統(tǒng)上，為了簡(jiǎn)單起見，直接在 awtk-stm32f103ze-raw 基礎(chǔ)上加入 TOS 支持。

• 在 Keil 中增加下列文件：

TencentOS/kernel/core/tos_event.c
TencentOS/kernel/core/tos_fifo.c
TencentOS/kernel/core/tos_global.c
TencentOS/kernel/core/tos_mmblk.c
TencentOS/kernel/core/tos_mmheap.c
TencentOS/kernel/core/tos_msg.c
TencentOS/kernel/core/tos_mutex.c
TencentOS/kernel/core/tos_pend.c
TencentOS/kernel/core/tos_queue.c
TencentOS/kernel/core/tos_robin.c
TencentOS/kernel/core/tos_sched.c
TencentOS/kernel/core/tos_sem.c
TencentOS/kernel/core/tos_sys.c
TencentOS/kernel/core/tos_task.c
TencentOS/kernel/core/tos_tick.c
TencentOS/kernel/core/tos_time.c
TencentOS/kernel/core/tos_timer.c
TencentOS/kernel/pm/tos_pm.c
TencentOS/kernel/pm/tos_tickless.c
TencentOS/arch/arm/arm-v7m/common/tos_cpu.c
TencentOS/arch/arm/arm-v7m/common/tos_fault.c
TencentOS/arch/arm/arm-v7m/cortex-m3/armcc/port_c.c
TencentOS/arch/arm/arm-v7m/cortex-m3/armcc/port_s.S

• 增加 include 的路徑

TencentOS/arch/arm/arm-v7m/common/include
TencentOS/arch/arm/arm-v7m/cortex-m3/armcc
TencentOS/kernel/core/include
TencentOS/kernel/hal/include
TencentOS/kernel/pm/include
TencentOS/TOS-CONFIG

• 修改配置文件

根據(jù)自己的需要修改配置 TencentOS/TOS-CONFIG/tos_config.h：

一般來說不需要修改，使用官方提供的即可。我用的是 TencentOS-Demo 項(xiàng)目中的。

2. 加入針對(duì) TOS 實(shí)現(xiàn)的線程和同步的函數(shù)。

src/platforms/tos/mutex.c
src/platforms/tos/semaphore.c
src/platforms/tos/thread.c
src/platforms/common/sys_tick.c

3. 實(shí)現(xiàn) rtos.c

主要就是 SysTick 中斷的實(shí)現(xiàn)，從 TencentOS-Demo 中拷貝過來就行了。

ret_t rtos_init(void) {
  tos_knl_init();
  tos_robin_config(TOS_ROBIN_STATE_ENABLED, (k_timeslice_t)500u);

  return RET_OK;
}

ret_t rtos_start(void) {
  tos_knl_start();

  return RET_OK;
}

void rtos_tick(void) {
  if (tos_knl_is_running()) {
    tos_knl_irq_enter();
    tos_tick_handler();
    tos_knl_irq_leave();
  }
}

void rtos_delay(uint32_t ms) {
  tos_task_delay(ms);
}

4. 在線程中啟動(dòng) AWTK

void* awtk_thread(void* args) {
  gui_app_start(320, 480);

  return NULL;
}

static ret_t awtk_start_ui_thread(void) {
  tk_thread_t* ui_thread = tk_thread_create(awtk_thread, NULL);
  return_value_if_fail(ui_thread != NULL, RET_BAD_PARAMS);

  tk_thread_set_priority(ui_thread, 3);
  tk_thread_set_name(ui_thread, "awtk");
  tk_thread_set_stack_size(ui_thread, 2048);

  return tk_thread_start(ui_thread);
}

int main() {
  hardware_prepare();
  platform_prepare();

  rtos_init();
  awtk_start_ui_thread();
  rtos_start();
    
    return 0;
}

這里與裸系統(tǒng)不同的地方，主要有兩個(gè)：

• 1. 在線程中啟動(dòng) AWTK。
• 2. 要提前調(diào)用 platform_prepare，platform_prepare 負(fù)責(zé)初始化內(nèi)存，放在 tk_init 中就有些晚，需要單獨(dú)提出來調(diào)用。

為此 platform_prepare 函數(shù)做了防重復(fù)調(diào)用的處理。

static bool_t s_inited = FALSE;
static uint32_t s_heam_mem[4096];

ret_t platform_prepare(void) {
    if(!s_inited) {
        s_inited = TRUE;
    tk_mem_init(s_heam_mem, sizeof(s_heam_mem));
    }
  return RET_OK;
}

AWTK 集成 RTOS 是非常簡(jiǎn)單的，以上過程大概花了 2 個(gè)小時(shí)吧。只要 RTOS 本身好移植，集成 AWTK 和 RTOS 只是分分鐘的問題。