AWTK 在 RT-Thread 上的移植筆記

AWTK 在 RT-Thread 上的移植筆記

本文以 STM32f103ze 爲例，介紹了 AWTK 在 RTOS 上移植的經驗。與其說移植，倒不如說是集成。所作的事情不過是把 AWTK 放到 RTOS 的一個線程中執行而已。

1. 加入 RT-Thread 相關文件。

AWTK 已經移植到 STM32f103ze 裸系統上，爲了簡單起見，直接在 awtk-stm32f103ze-raw 基礎上加入 RT-Thread 支持。

• 在 Keil 中增長下列文件：

rtthread/
rtthread/bsp
rtthread/cortex-m3
rtthread/cortex-m3/context_gcc.S
rtthread/cortex-m3/context_iar.S
rtthread/cortex-m3/context_rvds.S
rtthread/cortex-m3/cpuport.c
rtthread/cortex-m3/SConscript
rtthread/include
rtthread/include/libc
rtthread/include/libc/libc_dirent.h
rtthread/include/libc/libc_errno.h
rtthread/include/libc/libc_fcntl.h
rtthread/include/libc/libc_fdset.h
rtthread/include/libc/libc_ioctl.h
rtthread/include/libc/libc_signal.h
rtthread/include/libc/libc_stat.h
rtthread/include/rtdbg.h
rtthread/include/rtdebug.h
rtthread/include/rtdef.h
rtthread/include/rthw.h
rtthread/include/rtlibc.h
rtthread/include/rtm.h
rtthread/include/rtservice.h
rtthread/include/rtthread.h
rtthread/rtconfig.h
rtthread/src
rtthread/src/clock.c
rtthread/src/cpu.c
rtthread/src/device.c
rtthread/src/idle.c
rtthread/src/ipc.c
rtthread/src/irq.c
rtthread/src/Kconfig
rtthread/src/kservice.c
rtthread/src/mem.c
rtthread/src/memheap.c
rtthread/src/mempool.c
rtthread/src/object.c
rtthread/src/scheduler.c
rtthread/src/SConscript
rtthread/src/signal.c
rtthread/src/slab.c
rtthread/src/thread.c
rtthread/src/timer.c

• 增長 include 的路徑

rtthread
rtthread/include

• 修改配置文件

根據本身的須要修改配置 rtthread/rtconfig.h

通常來講不須要修改，使用官方提供的便可。我用的是 stm32f103-mini-system 項目中的。

2. 加入針對 RT-Thread 實現的線程和同步的函數。

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

3. 實現rtos.c。

參考stm32/libraries/HAL_Drivers/drv_common.c和components.c修改的。

#include "rthw.h"
#include "rtthread.h"

static bool_t s_kernel_inited = FALSE;

static bool_t rtos_is_inited(void) {
  return s_kernel_inited;
}

static uint32_t s_heap[2 * 1024];

ret_t rtos_init(void) {
  rt_hw_interrupt_disable();

  /* show version */
  rt_show_version();

#ifdef RT_USING_HEAP
  rt_system_heap_init((void*)s_heap, s_heap + sizeof(s_heap) / sizeof(s_heap[0]));
#endif

  /* initialize scheduler system */
  rt_system_scheduler_init();

  /* initialize timer */
  rt_system_timer_init();

  /* initialize timer thread */
  rt_system_timer_thread_init();

  /* initialize idle thread */
  rt_thread_idle_init();

  s_kernel_inited = TRUE;

  return RET_OK;
}

ret_t rtos_start(void) {
  /* start scheduler */
  rt_system_scheduler_start();

  return RET_OK;
}

void rtos_tick(void) {
  if (rtos_is_inited()) {
    rt_interrupt_enter();
    rt_tick_increase();
    rt_interrupt_leave();
  }
}

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

4. 在線程中啓動 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();
}

這裏與裸系統不一樣的地方，主要有兩個：

• 1. 在線程中啓動 AWTK。
• 2. 要提早調用 platform_prepare，platform_prepare 負責初始化內存，放在 tk_init 中就有些晚，須要單獨提出來調用。

爲此 platform_prepare 函數作了防重複調用的處理。

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 是很是簡單的，以上過程大概花了 2 個小時吧。只要 RTOS 自己好移植，集成 AWTK 和 RTOS 只是分分鐘的問題。