Sysutils_Base

系统基础功能. 更多...

Sysutils_Base 的协作图:

结构体
struct	SUModelNum
	设备型号. 更多...
struct	SUVersion
	设备软件版本. 更多...
union	SUDevID
	设备ID. 更多...
struct	SUTime
	系统时间结构体. 更多...

宏定义
#define	DEVICE_ID_MAGIC   "53ef"
	设备ID逻辑编码
#define	DEVICE_ID_MAGIC_LEN   4
	设备ID逻辑编码长度
#define	DEVICE_ID_LEN   32
	设备ID长度
#define	MAX_INFO_LEN   64
	设备型号\设备ID\固件版本信息的最大长度

函数
int	SU_Base_GetModelNumber (SUModelNum *modelNum)
	获取设备型号. 更多...
int	SU_Base_GetVersion (SUVersion *version)
	获取设备版本. 更多...
int	SU_Base_GetDevID (SUDevID *devID)
	获取设备ID. 更多...
int	SU_Base_GetTime (SUTime *time)
	获得系统时间. 更多...
int	SU_Base_SetTime (SUTime *time)
	设置系统时间. 更多...
int	SU_Base_SUTime2Raw (SUTime *suTime, uint32_t *rawTime)
	将SUTime类型的时间转换为以秒为单位的Raw时间. 更多...
int	SU_Base_Raw2SUTime (uint32_t *rawTime, SUTime *suTime)
	将以秒为单位的Raw时间转换为SUTime类型的时间. 更多...
int	SU_Base_SetAlarm (SUTime *time)
	设定闹钟时间. 更多...
int	SU_Base_GetAlarm (SUTime *time)
	获得闹钟定时时间. 更多...
int	SU_Base_EnableAlarm (void)
	使能闹钟. 更多...
int	SU_Base_DisableAlarm (void)
	关闭闹钟. 更多...
int	SU_Base_PollingAlarm (uint32_t timeoutMsec)
	等待闹钟. 更多...
int	SU_Base_Shutdown (void)
	设备关机. 更多...
int	SU_Base_Reboot (void)
	设备重启. 更多...
int	SU_Base_Suspend ()
	设备休眠. 更多...

详细描述

系统基础功能.

函数说明

int SU_Base_DisableAlarm

(

void

)

关闭闹钟.

参数

无.

返回值

0	成功.
非0	失败.

备注

无.

注意

无.

int SU_Base_EnableAlarm

(

void

)

使能闹钟.

参数

无.

返回值

0	成功.
非0	失败.

备注

调用该函数之前，请调用SU_Base_GetAlarm（SUTime *time）设定闹钟时间.

注意

如果闹钟时间在当前系统时间之前返回失败.

int SU_Base_GetAlarm

(

SUTime *

time

)

获得闹钟定时时间.

参数

[out]

time

系统时间结构体指针.

返回值

0	成功.
非0	失败.

备注

无.

注意

无.

int SU_Base_GetDevID

(

SUDevID *

devID

)

获取设备ID.

参数

[out]

devID

设备ID结构体指针.

返回值

0	成功.
非0	失败.

备注

每颗CPU芯片的设备ID是唯一的.

注意

无.

int SU_Base_GetModelNumber

(

SUModelNum *

modelNum

)

获取设备型号.

参数

[out]

modelNum

设备型号结构体指针.

返回值

0	成功.
非0	失败.

备注

无.

注意

无.

int SU_Base_GetTime

(

SUTime *

time

)

获得系统时间.

参数

[in]

time

系统时间结构体指针.

返回值

0	成功.
非0	失败.

备注

无.

注意

无.

int SU_Base_GetVersion

(

SUVersion *

version

)

获取设备版本.

参数

[out]

version

设备版本结构体指针.

返回值

0	成功.
非0	失败.

备注

无.

注意

无.

int SU_Base_PollingAlarm

(

uint32_t

timeoutMsec

)

等待闹钟.

参数

[in]

超时时间，单位：毫秒.

返回值

0	成功.
非0	失败.

备注

调用该函数后，程序会进入阻塞状态，一直到闹钟响应退出或超时退出.

注意

无.

int SU_Base_Raw2SUTime	(	uint32_t *	rawTime,
		SUTime *	suTime
	)

将以秒为单位的Raw时间转换为SUTime类型的时间.

参数

[in]	rawTime	Raw时间(从1970-01-01 00:00:00开始算起).
[out]	suTime	系统时间结构体指针.

返回值

0	成功.
非0	失败.

备注

此函数可以用在设置相对秒数的Alarm.

注意

无.

int SU_Base_Reboot

(

void

)

设备重启.

参数

无.

返回值

0	成功.
非0	失败.

备注

调用该函数后设备会立即重启.

注意

在调用此函数之前请确保已保存所有文件.

int SU_Base_SetAlarm

(

SUTime *

time

)

设定闹钟时间.

参数

[in]

time

系统时间结构体指针.

返回值

0	成功.
非0	失败.

备注

暂支持24小时内的闹钟设定.

注意

系统时间参数需在合理范围，否则函数调用失败.

int SU_Base_SetTime

(

SUTime *

time

)

设置系统时间.

参数

[out]

time

系统时间结构体指针.

返回值

0	成功.
非0	失败.

备注

无.

注意

系统时间参数需在合理范围，否则函数调用失败.

int SU_Base_Shutdown

(

void

)

设备关机.

参数

无.

返回值

0	成功.
非0	失败.

备注

调用该函数后设备会立即关机并关闭主电源.

注意

在调用此函数之前请确保已保存所有文件.

int SU_Base_Suspend

(

void

)

设备休眠.

参数

无.

返回值

0	成功.
非0	失败.

备注

调用该函数后设备会立即进入休眠,函数正常退出后说明系统已经唤醒.

注意

无.

int SU_Base_SUTime2Raw	(	SUTime *	suTime,
		uint32_t *	rawTime
	)

将SUTime类型的时间转换为以秒为单位的Raw时间.

参数

[in]	suTime	系统时间结构体指针.
[out]	rawTime	Raw时间(从1970-01-01 00:00:00开始算起).

返回值

0	成功.
非0	失败.

备注

此函数可以用在设置相对秒数的Alarm.

注意

无.