合泰内建函数

Posted 2020-09-17 风一样的男人2

本使用手册版权为盛群半导体股份有限公司所有， 非经盛群半导体股份有限公司书面授权同意， 不得透过任何形
式复制、 储存或传输。
C COMPILER 使用手册
March 27, 2012

Rev 1.10

i

March 27, 2012

目录
目录
数据类型.................................................................................................... 1
数组........................................................................................................... 1
标识符保留字............................................................................................. 1
运算符 ....................................................................................................... 2
前置处理指令............................................................................................. 3
预处理指令 #pragma................................................................................. 3
const 变量功能 .......................................................................................... 4
预定义的头档............................................................................................. 4
main 函数 .................................................................................................. 4
中断函数.................................................................................................... 5
内建函数.................................................................................................... 5
其它的功能 ................................................................................................ 6

Rev 1.10

1

March 27, 2012

Holtek C、 Holtek Enhance C 和 ANSI C 的比较

撰写这份档依据
HOLTEK C 的版本	Holtek (R) Cross C Compiler Version V2.04 MRSC
HOLTEK Enhance C 的版本	Holtek (R) Cross C Compiler Version V2.40 E-MRSC (2010/1/20)

【注】 ： 下列表格中的“Y”代表有， “N 表没有。
数据类型

Data type	Size (bit) HOLTEK C	Size (bits) HOLTEK Enhance C	Size(bits) ANSI C
bit	1	1	N
char	8	8	8
signed char	8	8	8
unsigned char	8	8	8
short	8	16	16
unsigned short	8	16	16
int	8	16	16
unsigned int	8	16	16
long	16	32	32
unsigned long	16	32	32
float	N	32	32
double	N	32	64
long double	N	N	128

float/double 皆使用 IEEE754 32 位格式
bit 型态不可用于指标 (pointer) 的数据型态， 不可定义为 const。 为局域时， 占用一个 byte（但
只有一个 bit 有效） ， 为全域时， 占用一个 bit。
数组

维数	HOLTEK C ( 最大数组长度 )	HOLTEK Enhance C ( 最大数组长度 )	ANSI C ( 最大数组长度 )
一维数组	256	跟空间有关①	不限制
二维数组	N	跟空间有关①	不限制
三或三以上的多维数组	N	N	不限制
指针数组	N	跟空间有关①	不限制
函数数组	N	功能限制	不限制
字符串数组	不支持	不支持	不限制

【注】 ： ①若長度大於 1 page， 則有功能限制， 功能限制是指使用時編譯通過， 但可能會有 bug， 使用
時要小心。
标识符保留字

保留字	HOLTEK C	HOLTEK Enhance C	ANSI C
auto	●	●	●
break	●	●	●
bit	●	●
case	●	●	●
char	●	●	●
const	●	●	●
constant	●
continue	●	●	●
default	●	●	●

Rev 1.10 2 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较

保留字	HOLTEK C	HOLTEK Enhance C	ANSI C
do	●	●	●
double	●	●
else	●	●	●
enum	●	●	●
extern	●	●	●
float	●	●
for	●	●	●
goto	●	●	●
if	●	●	●
int	●	●	●
long	●	●	●
register	●	●
return	●	●	●
short	●	●	●
signed	●	●	●
sizeof	●	●	●
static	●	●	●
struct	●	●	●
switch	●	●	●
typedef	●	●	●
union	●	●	●
unsigned	●	●	●
void	●	●	●
volatile	●	●	●
while	●	●	●

运算符

运算符	HOLTEK C	HOLTEK Enhance C	ANSI C
算术运算符 (+,-,*,/,%)	●	●	●
关系运算符 (>,<,==,>=,<=,!=）	●	●	●
逻辑运算符 (!,&&,||）	●	●	●
位运算符 (<<,>>,~,|,^,&）	●	●	●
赋值运算符 (=,+=,-=,*=,/=,%=,>>=,<<=,&=,^=,|=)	●	●	●
条件运算符（? :）	●	●	●
逗号运算符（,）	●	●	●
指针运算符（* 和 &）	●	●	●
求字节数运算符（sizeof）	●	●	●
强制类型转换运算符 (( 类型 ))	●	●	●
分量运算符（. ->）	●	●	●
下标运算符（[ ]）	●	●	●
函数调用运算符（( )）	●	●	●
自增运算符（++）	●	●	●
自减运算符（--）	●	●	●
负号运算符（-）	●	●	●
正号运算符（+）	●	●	●
指定 RAM 变量地址运算符（@）	●	●

Rev 1.10 3 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较
前置处理指令

前置处理指令	HOLTEK C	HOLTEK Enhance C	ANSI C
#asm	Y	Y	N
#define	Y	Y	Y
#elif	Y	Y	Y
#else	Y	Y	Y
#endif	Y	Y	Y
#error ①	Y	Y	N
#if	Y	Y	Y
#ifdef	Y	Y	Y
#ifndef	Y	Y	Y
#include	Y	Y	Y
#pragma	Y	Y	N
#undef	Y	Y	Y

【注】 ： ①产出错误信息： #error Size too big
预处理指令 #pragma
格式：
#pragma keyword [option]
某些 keyword 会有 options。

Keyword	HOLTEK C	HOLTEK Enhance C	ANSI C
bp_free	●
bp_nofree	●
function	●
nobp	●
nolocal	●
nomp0	●
nomp1	●
rambank0 norambank	●	●
rombank0 norombank	●
rombank	●
vector	●	●
novectornest	●
inline

Rev 1.10 4 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较
const 变量功能

const 变量功能	HOLTEK C	HOLTEK Enhance C	ANSI C
适用的数据类型	除 bit	除 bit	any
属性	private	private	public/private/internal
直接被其它文件使用	N	N	Y( 引用时， 在 const 前加修饰词 extern)
必须宣告为全局型	Y	N	N
宣告时要设定初始值	Y	Y	Y
数组常量要指定数组的大小	Y	Y	Y
取址操作数①	N	N	Y

【注】 ： ①比如， 不能写：
const char a = 5;
void main()
{
char *b = &a;
}
但可以写：
const char a[1] = {5};
void main()
{
char *b = &a;
}
对于 enhanced c, 若要将 int 或 unsigned int 变量设定为常量时， 建议使用 constant 而不是 const，
这样会使程序更高效。
预定义的头档

预定义的头档	HOLTEK C	HOLTEK Enhance C	ANSI C
HTxxxxxx.h	Y	Y	N
assert.h	N	N	Y
ctype.h	N	N	Y
errno.h	N	N	Y
float.h	N	N	Y
limits.h	N	N	Y
locale.h	N	N	Y
math.h	N	N	Y
setjmp.h	N	N	Y
signal.h	N	N	Y
stdarg.h	N	N	Y
stddef.h	N	N	Y
stdio.h	N	N	Y
stdlib.h	N	N	Y
string.h	N	N	Y
time.h	N	N	Y

main 函数

main 函数的规定	HOLTEK C	HOLTEK Enhance C	ANSI C
个数（个）	1	1	1
返回数据类型	void	void	int
参数（个）	无	无	2（一个指针数组）

Rev 1.10 5 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较
中断函数

中断函数的规定	HOLTEK C	HOLTEK Enhance C	ANSI C
设定中断向量值	Y	Y	没有中断函数
个数（个）	可多个	可多个
返回数据类型	void	void
参数	无	无
重复进入中断	N	Y ①
在程序中调用中断	N	N
中断调用汇编函数	Y	Y
中断调用 C 函数	N	Y ②

【注】 ： ①虽然不同的中断事件可以重迭发生， 但是同一个中断事件不可以重迭产生， 必须等候前一个
发生被处理完成后， 才能认可下一个中断事件。 针对不具有中断可重迭（nested） 发生的微控
制器， 则在中断服务函式内不可开启中断功能。
②必须将被调用的函数定义成 #pragma nolocal。 否则会造成 ram 空间重用， 一般不推荐使用。
内建函数

函数	HOLTEK C ( 参数类型 )	HOLTEK Enhance C （参数类型）	ANSI C
_clrwdt()	Y	Y	N
_clrwdt1()	Y	Y	N
_clrwdt2()	Y	Y	N
_halt()	Y	Y	N
_nop()	Y	Y	N
_rr(int8 *)	Y(int *)	Y(char *)	N
_rrc(int8 *)	Y(int *)	Y(char *)	N
_lrr(int16 *)	Y(long *)	Y(int *)	N
_lrrc(int16 *)	Y (long*)	Y(int *)	N
_rl(int8 *)	Y(int *)	Y(char *)	N
_rlc(int8 *)	Y(int *)	Y(char *)	N
_lrl(int16 *)	Y(long *)	Y(int *)	N
_lrlc(int16 *)	Y(long *)	Y(int *)	N
_swap(int8 *)	Y(int *)	Y(char *)	N
_delay(unsigned long tick)	Y(tick<=65535)	Y(tick<= 263690)	N

Rev 1.10 6 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较
其它的功能

功能	HOLTEK C	HOLTEK Enhance C	ANSI C
内嵌式汇编语言	Y	Y	N
静态变量	不支持静态变量和静态函数	不支持静态变量和静态函数	支持局部的静态变量
常量	支持二进制常量	支持二进制常量	不支持二进制常量
结构体和共享体	bit field 置放于 8 位的单位 内 , 不会横跨两个 8 位的单 位， 且不能定义超过 9 位的 bit field	bit field 会置放于 8 位的单位内 , 不 会横跨两个 8 位的单位， 且不能定 义超过 9 位的 bit field	最大可定义 32 位的 bit field
函数	不支持递归函数	不支持递归函数	支持递归函数
指针	不能用于常量与位变量， 不 支持函数指针	不能用于常量与位变量， 若指向函 数， 则必须是全域的， 且所指函数不 能带有参数	不能用于常量（没有位变 量）
初始值	全局变量宣告时不可以同时 设定初始值， 但是 const 常 量在宣告时一定要设定初始 值	全局变量宣告时不可以同时设定初 始值， 但是 const 常量在宣告时一定 要设定初始值	全局变量、 局部变量在宣 告时可以设定初始值， const 常量在宣告时一定 要设定初始值
堆栈	层数有限①	层数有限①	层数不受限制

【注】： ①每个 MCU 的层数有限， HOLTEK C/Enhance C 程序中断调用函数时， 要考虑占用的堆栈层数，
一些运算符或函数在调用时所占用的堆栈层数如下：

运算符 / 函数	堆栈层数	运算符 / 函数	堆栈层数
main()	0	_rl(int */ char *);	0
_clrwdt()	0	_rlc(int *);	0
_clrwdt1()	0	_lrl(long */ int *);	0
_clrwdt2()	0	_lrlc(long *);	0
_halt()	0	_delay(unsigned long)	1
_nop()	0	*	1
_rr(int */ char *);	0	/	1
_rrc(int *);	0	%	1
_lrr(long */ int *);	0	Constant array	1
_lrrc(long *);	0	整型与浮点型转换	1

Rev 1.10 7 March 27, 2012
Holtek C、 Holtek Enhance C 和 ANSI C 的比较
盛群半导体股份有限公司 ( 总公司 )
新竹市科学工业园区研新二路 3 号
电话 : 886-3-563-1999
传真 : 886-3-563-1189
网站 : www.holtek.com
盛群半导体股份有限公司 ( 台北业务处 )
台北市南港区园区街 3 之 2 号 4 楼之 2
电话 : 886-2-2655-7070
传真 : 886-2-2655-7373
传真 : 886-2-2655-7383 (International sales hotline)
盛扬半导体有限公司 ( 深圳业务处 )
深圳市深南山区高新中二道 5 号生产力大楼 A 单元 5 楼 518057
电话 : 86-755-8616-9908
传真 : 86-755-8616-9722
Holmate Semiconductor, Inc. ( 北美业务处 )
46712 Fremont Blvd., Fremont, CA 94538
电话 : 1-510-252-9880
传真 : 1-510-252-9885
网站 : www.holmate.com
Copyright? 2012 by HOLTEK SEMICONDUCTOR INC.
使用指南中所出现的信息在出版当时相信是正确的， 然而盛群对于说明书的使用不负任何责任。 文中提到的应用
目的仅仅是用来做说明， 盛群不保证或表示这些没有进一步修改的应用将是适当的， 也不推荐它的产品使用在会
由于故障或其它原因可能会对人身造成危害的应用。 盛群产品不授权使用于救生、 维生器件或系统中做为关键组
件。 盛群拥有不事先通知而修改产品的权利， 对于最新的信息， 请参考我们的网址 http://www.holtek.com