aCoral Development Rules

1. aCoral设计理念

aCoral由内核模块和外围模块组成，其中内核模块对应于kernel文件夹以及hal文件夹，外围模块对应driver文件夹和plugin文件夹，除此以外，user文件夹作为上层应用，也被放在aCoral源码中。aCoral的设计理念中，这些文件夹是分层的，其架构图如图所示

aCoral-architecture

分层设计理念中，上层需要通过下层提供的接口来访问更低级别的功能，而下层不能访问上层，例如：

kernel需要访问hal层，则必须通过hal或HAL开头的接口。这只需要#include "hal.h"即可
hal文件夹中需要使用kernel中的内容（函数、变量），则需要以参数的形式传入，这是为了保证在下层中，不包含上层的头文件。例如，在hal_timer_init()函数中，需要使用acoral_ticks_entry()函数来初始化定时器，此时不能直接在hal_timer_init中使用acoral_ticks_entry，而必须通过hal_timer_init的参数，将acoral_ticks_entry函数的指针以参数形式传进来使用。

这样分层的设计理念，可以尽可能降低上下层之间的耦合度。

aCoral内核将所有管理的对象抽象为资源（resource），包括线程控制块TCB、事件（event，包括信号量和互斥量）、消息队列、驱动控制块等，即万物皆资源。这点类似于RT-THREAD中的Object概念，都属于面向对象的编程思想。

aCoral的实时性通过实时调度策略、快速资源管理、快速中断管理三个方面来维护

aCoral对于资源的管理采取的策略为：分配时尽量快速（O(1)时间复杂度），回收交给daem线程，空时再做。

#ifndef ACORAL_XXX_H
#define ACORAL_XXX_H
......
#endif