第1部分 T-Engine工程和T-Kernel 3
1 何谓T-Engine 3
2 单一源化的T-Kernel和T-License 6
3 T-Engine开发组件 7
4 T-Engine的系统构成 9
4.1 标准开发平台T-Engine 9
4.2 T-Engine的软件构成 11
4.3 T-Kernel概要 13
4.4 T-Kernel的核心对象 14
4.5 T-Kernel的动态资源管理 15
4.6 T-Kernel的内存管理 16
4.7 T-Kernel的标准化 18
第2部分 T-Kernel规范 21
1 T-Kernel概述 21
1.1 T-Kernel定位 21
1.2 可裁剪性 22
2 T-Kernel规范的基本概念 24
2.1 基本术语 24
2.2 任务状态和调度规则 25
2.2.1 任务状态 25
2.2.2 任务调度规则 28
2.5.1 非任务部分执行时的系统状态 31
2.5 系统状态 31
2.4 任务异常处理 31
2.3 中断处理 31
2.5.2 任务无关部分（运行状态）与准任务部分（运行状态） 32
2.6 对象 34
2.7 内存 35
2.7.1 地址空间 35
2.7.2 非驻留内存 35
2.7.3 保护级别 36
3 通用T-Kernel规范 37
3.1 数据类型 37
3.1.1 普通数据类型 37
3.1.2 其他定义的数据类型 39
3.2 系统调用（函数） 40
3.2.1 系统调用（函数）格式 40
3.2.2 在任务无关部分（状态）中可用的系统调用（函数） 40
3.2.3 限制系统调用函数的调用 41
3.2.4 参数数据包的修改 41
3.2.5 函数代码 42
3.2.6 错误代码 42
3.2.7 时限 43
3.2.8 相对时间和系统时间 44
3.3 高级语言支持程序 45
4.1 任务管理函数 46
tk_cre_tsk（建立任务） 46
4 T-Kernel/OS函数 46
tk_del_tsk（删除任务） 51
tk_sta_tsk（启动任务） 51
tk_ext_tsk（退出调用任务） 52
tk_exd_tsk（退出和删除调用任务） 53
tk_ter_tsk（终止其他任务） 54
tk_chg_pri（改变任务的优先级） 55
tk_chg_slt（改变任务时间片） 57
tk_get_tsp（获取任务固定空间） 58
tk_set_tsp（设置任务固定空间） 59
tk_get_rid（获取任务资源ID） 60
tk_set_rid（设置任务资源ID） 61
tk_get_reg（获取任务寄存器的内容） 61
tk_set_reg（设置任务寄存器） 62
tk_get_cpr（获取协处理器寄存器的内容） 63
tk_set_cpr（设置协处理器寄存器） 64
tk_inf_tsk（获取任务统计信息） 65
tk_ref_tsk（查询任务状态） 66
tk_slp_tsk（使调用任务进入睡眠状态） 69
4.2 任务相关的同步函数 69
tk_wup_tsk（唤醒其他任务） 70
tk_can_wup（取消唤醒任务） 71
tk_rel_wai（释放等待） 72
tk_sus_tsk（挂起其他任务） 74
tk_frsm_tsk（强制恢复挂起状态的任务） 75
tk_rsm_tsk（恢复挂起状态的任务） 75
tk_sig_tev（发送任务事件） 77
tk_dly_tsk（延迟任务） 77
tk_wai_tev（等待任务事件） 78
tk_dis_wai（禁止任务等待） 79
4.3 任务异常处理函数 82
tk_ena_wai（允许任务等待） 82
tk_def_tex（定义任务异常处理程序） 83
tk_dis_tex（禁止任务异常） 85
tk_ena_tex（允许任务异常） 85
tk_ras_tex（提交任务异常） 86
tk_end_tex（终止任务异常处理程序） 87
tk_ref_tex（查询任务异常状态） 88
4.4.1 信号量 89
4.4 同步和通信函数 89
tk_cre_sem（建立信号量） 90
tk_sig_sem（释放信号量） 92
tk_del_sem（删除信号量） 92
tk_wai_sem（等待信号量） 93
tk_ref_sem（查询信号量状态） 94
4.4.2 事件标志 95
tk_cre_flg（建立事件标志） 96
tk_del_flg（删除事件标志） 97
tk_clr_flg（清除事件标志） 98
tk_set_flg（设置事件标志） 98
tk_wai_flg（等待事件标志） 99
tk_ref_flg（查询事件标志状态） 102
4.4.3 邮箱 103
tk_cre_mbx（建立邮箱） 104
tk_del_mbx（删除邮箱） 106
tk_snd_mbx（发送消息到邮箱中） 107
tk_rcv_mbx（接收邮箱中的消息） 108
tk_ref_mbx（查询邮箱状态） 109
4.5 扩展同步和通信函数 110
4.5.1 互斥体 110
tk_cre_mtx（建立互斥体） 112
tk_del_mtx（删除互斥体） 114
tk_loc_mtx（锁定互斥体） 115
tk_unl_mtx（解锁互斥体） 116
tk_ref_mtx（查询互斥体状态） 117
4.5.2 消息缓冲区 118
tk_cre_mbf（建立消息缓冲区） 119
tk_snd_mbf（发送消息到消息缓冲区） 122
tk_del_mbf（删除消息缓冲区） 122
tk_rcv_mbf（从消息缓冲区中接收消息） 124
tk_ref_mbf（获取消息缓冲区的状态） 125
4.5.3 集合点端口 126
tk_cre_por（建立集合点端口） 128
tk_cal_por（调用集合点端口） 130
tk_del_por（删除集合点端口） 130
tk_acp_por（接受集合点端口） 132
tk_fwd_por（转发集合点到其他端口） 136
tk_rpl_rdv（回应集合点） 140
tk_ref_por（查询端口状态） 142
4.6.1 固定大小的内存池 143
4.6 内存池管理函数 143
tk_cre_mpf（建立固定大小的内存池） 144
tk_get_mpf（获取固定大小的内存块） 146
tk_del_mpf（删除固定大小的内存池） 146
tk_ref_mpf（查询固定大小的内存池的状态） 148
tk_rel_mpf（释放固定大小的内存块） 148
4.6.2 大小可变的内存池 149
tk_cre_mpl（建立大小可变的内存池） 150
tk_del_mpl（删除大小可变的内存池） 152
tk_get_mpl（获取大小可变的内存块） 153
tk_rel_mpl（释放大小可变的内存块） 154
tk_ref_mpl（查询大小可变的内存池的状态） 155
tk_set_tim（设置系统时间） 156
4.7.1 系统时间管理函数 156
4.7 时间管理函数 156
tk_get_otm（获取运行时间） 157
tk_get_tim（查询系统时间） 157
4.7.2 周期性处理程序 158
tk_cre_cyc（建立周期性处理程序） 159
tk_sta_cyc（启动周期性处理程序） 162
tk_del_cyc（删除周期性处理程序） 162
tk_stp_cyc（停止周期性处理程序） 163
tk_ref_cyc（查询周期性处理程序的状态） 163
4.7.3 报警处理程序 164
tk_cre_alm（建立报警处理程序） 165
tk_del_alm（删除报警处理程序） 167
tk_sta_alm（启动报警处理程序） 167
tk_stp_alm（停止报警处理程序） 168
tk_ref_alm（查询报警处理程序的状态） 169
tk_def_int（定义中断处理程序） 170
4.8 中断管理函数 170
tk_ret_int（从中断处理程序中返回） 173
tk_rot_rdq（翻转就绪队列） 175
4.9 系统管理函数 175
tk_get_tid（获取任务标识符（ID）） 176
tk_dis_dsp（禁止分派） 177
tk_ena_dsp（允许分派） 178
tk_ref_sys（查询系统状态） 179
tk_set_pow（设置电源模式） 180
tk_ref_ver（查询版本信息） 182
4.10 子系统管理函数（功能） 184
tk_def_ssy（定义子系统） 185
tk_cln_ssy（调用子系统的清除函数） 190
tk_sta_ssy（调用子系统的启动函数） 190
tk_evt_ssy（调用子系统的事件处理函数） 191
tk_ref_ssy（查询子系统的状态） 192
tk_cre_res（建立资源组） 193
tk_get_res（获取资源管理块） 195
tk_del_res（删除资源组） 195
5 T-Kernel/SM函数 197
tk_ref_smb（查询系统内存块） 198
tk_rel_smb（释放系统内存块） 198
tk_get_smb（分配系统内存块） 198
5.1.1 系统内存分配 198
5.1 系统内存管理函数 198
5.2 地址空间管理函数 199
Krealloc（重新分配驻留内存） 199
5.1.2 内存分配库 199
Vrealloc（重新分配非驻留内存） 199
Vmalloc（分配非驻留内存） 199
Vcalloc（分配非驻留内存单元） 199
Kcalloc（分配驻留内存单元） 199
Kmalloc（分配驻留内存） 199
Vfree（释放非驻留内存） 199
Kfree（释放驻留内存） 199
SetTaskSpace（设置任务空间） 200
5.2.1 地址空间配置 200
5.2.2 地址空间检查 200
ChkSpaceTstrRW（检查读-写访问权（TRON代码）） 201
ChkSpaceTstrR（检查读访问权（TRON代码）） 201
ChkSpaceRW（检查读-写访问权） 201
ChkSpaceRE（检查读-执行访问权） 201
ChkSpaceR（检查读访问权） 201
ChkSpaceBstrR（检查读访问权（字符串）） 201
5.2.3 锁定地址空间 201
ChkSpaceBstrRW（检查读-写访问权（字符串）） 201
5.2.5 映射内存 202
MapMemory（映射内存） 202
5.2.4 获取物理地址 202
CnvPhysicalAddr（获取物理地址） 202
LockSpace（锁定地址空间） 202
UnlockSpace（解锁地址空间） 202
UnmapMemory（解除映射内存） 203
5.3.1 基本概念 203
5.3 设备管理函数 203
5.3.2 应用程序接口 206
tk_opn_dev（打开设备） 207
tk_cls_dev（关闭设备） 208
tk_rea_dev（读取设备数据） 209
tk_wri_dev（写入设备数据） 210
tk_srea_dev（同步读） 210
tk_swri_dev（同步写） 211
tk_wai_dev（等待设备） 211
tk_sus_dev（挂起设备） 212
tk_ref_dev（通过设备名查询设备） 214
tk_oref_dev（通过设备描述符查询设备） 214
tk_get_dev（获取设备名称） 214
tk_evt_dev（发送驱动器请求事件） 215
tk_lst_dev（获取注册的设备信息） 215
5.3.3 设备注册 216
tk_def_dev（注册设备） 217
tk_ref_idv（查询设备初始化信息） 218
5.3.4 设备驱动程序接口 218
5.3.5 属性数据 224
5.3.6 设备事件通知 226
5.3.7 设备挂起／恢复处理 227
5.3.8 磁盘驱动程序的特殊作用 228
5.4 中断管理函数 229
5.4.1 CPU中断控制 229
isDI（获取中断禁止的状态） 230
EI（允许中断） 230
DI（禁止中断） 230
5.4.2 中断控制器的控制 230
T-Kernel API索引 231
本规范中描述的T-Kernel API（系统调用、扩展SVC、库和宏）按字母顺序列出如下。CheckInt（检查中断） 231
5.5 I/O端口访问支持函数 231
ClearInt（清除中断） 231
DINTNO（获取中断定义编号） 231
DisableInt（禁止中断） 231
EnableInt（允许中断（中断优先级）） 231
EndOfInt（发出中断结束） 231
WaitNsec(Microwait(ns)) 232
WaitUsec(Microwait(μs)) 232
out_h（写半字数据） 232
in_w（读字数据） 232
in_h（读半字数据） 232
in_b（读字节数据） 232
out_w（写字数据） 232
out_b（写字节数据） 232
5.5.2 Micro等待 232
5.5.1 I/O端口访问 232
5.6 电源管理函数 233
5.7 系统配置信息管理函数 233
low_pow（进入低功耗模式） 233
off_pow（挂起系统） 233
5.7.1 获得系统配置信息 234
tk_get_cfn（获取数字串） 234
tk_get_cfs（获取字母串） 235
5.7.2 标准系统配置信息 235
5.8 子系统和设备驱动程序启动 236
6 T-Kernel/DS函数 239
td_lst_sem（查询对象ID列表） 240
td_lst_por（查询对象ID列表） 240
td_lst_ssy（查询对象ID列表） 240
td_lst_tsk（查询对象ID列表） 240
td_lst_flg（查询对象ID列表） 240
td_lst_mtx（查询对象ID列表） 240
td_lst_mpl（查询对象ID列表） 240
td_lst_mpf（查询对象ID列表） 240
td_lst_mbx（查询对象ID列表） 240
td_lst_cyc（查询对象ID列表） 240
td_lst_alm（查询对象ID列表） 240
td_lst_mbf（查询对象ID列表） 240
6.1 内核内部状态查询函数 240
td_cal_que（查询队列） 241
td_acp_que（查询队列） 241
td_smbf_que（查询队列） 241
td_flg_que（查询队列） 241
td_sem_que（查询队列） 241
td_rdy_que（获得优先执行的任务） 241
td_mtx_que（查询队列） 241
td_rmbf_que（查询队列） 241
td_mbx_que（查询队列） 241
td_mpl_que（查询队列） 241
td_mpf_que（查询队列） 241
td_ref_tsk（查询任务状态） 242
td_ref_ssy（查询对象状态） 244
td_ref_sem（查询对象状态） 244
td_ref_alm（查询对象状态） 244
td_ref_cyc（查询对象状态） 244
td_ref_por（查询对象状态） 244
td_ref_flg（查询对象状态） 244
td_ref_mbf（查询对象状态） 244
td_ref_mbx（查询对象状态） 244
td_ref_mpf（查询对象状态） 244
td_ref_mpl（查询对象状态） 244
td_ref_mtx（查询对象状态） 244
td_ref_tex（查询任务异常状态） 247
td_inf_tsk（查询任务统计信息） 248
td_set_reg（设置任务寄存器） 249
td_get_reg（获得任务寄存器） 249
td_ref_sys（查询系统状态） 250
td_get_tim（获得系统时间） 251
td_get_otm（获得系统运行时间） 252
td_ref_dsname（查询DS对象名称） 253
td_set_dsname（设置DS对象名称） 254
6.2 执行跟踪函数 255
td_hok_svc（定义系统调用／扩展SVC挂钩程序） 255
td_hok_dsp（定义任务分派挂钩程序） 257
td_hok_int（定义中断处理挂钩程序） 258
第3部分 T-Monitor规范 263
1 T-Monitor规范概述 263
2 系统函数 264
2.1 硬件初始化 264
2.2 系统启动 264
2.3 异常／中断／陷阱处理函数 265
3.2 命令格式 266
3 调试函数 266
3.1 控制台连接 266
3.3 命令列表 268
4 程序支持函数 286
5 引导处理的细节 293
5.1 引导处理概述 293
5.2 搜索可引导的设备 293
5.3 装载和启动主引导程序 294
第4部分 T-Engine相关参考文献目录 297
1 T-Engine的相关专刊 297
2 T-Engine的相关大事记总索引（2002年1月～2005年4月） 298
3 你该如何使用T-Kernel 306
4 T-License［T-Kernel的源代码许可协议］ 308
第5部分 参考 315
1 C语言接口的列表 315
2 错误代码列表 324
3 修订记录 327