Sysutils_Misc

其他功能. More...

Collaboration diagram for Sysutils_Misc:

Enumerations
enum	SUKeyEvent { KEY_RELEASED, KEY_PRESSED }
	按键事件. More...
enum	SULedCmd { LED_OFF, LED_ON }
	LED行为命令. More...

Functions
int	SU_Key_OpenEvent (void)
	获得按键事件句柄. More...
int	SU_Key_CloseEvent (int evfd)
	关闭按键事件. More...
int	SU_Key_ReadEvent (int evfd, int *keyCode, SUKeyEvent *event)
	读取按键事件. More...
int	SU_Key_DisableEvent (int keyCode)
	Disable按键事件. More...
int	SU_Key_EnableEvent (int keyCode)
	Enable按键事件. More...
int	SU_LED_Command (int ledNum, SULedCmd cmd)
	发送LED命令. More...

Detailed Description

其他功能.

Enumeration Type Documentation

enum SUKeyEvent

按键事件.

Enumerator
KEY_RELEASED	按键抬起
KEY_PRESSED	按键按下

enum SULedCmd

LED行为命令.

Enumerator
LED_OFF	LED关闭
LED_ON	LED打开

Function Documentation

int SU_Key_CloseEvent

(

int

evfd

)

关闭按键事件.

Parameters

[in]

evfd

按键事件句柄

Return values

0	成功.
非0	失败.

Remarks

无

Attention

无。

int SU_Key_DisableEvent

(

int

keyCode

)

Disable按键事件.

Parameters

[in]

keyCode

按键码

Return values

0	成功.
非0	失败.

Remarks

如果按键被配置为唤醒源，那么在系统suspend时，(无论该按键是否被Open)按下按键会使系统唤醒。 在Disable按键事件后，系统会关闭按键事件的中断，该按键也就无法唤醒系统

该API可用来Disable PIR"按键"唤醒系统。

Attention

无。

int SU_Key_EnableEvent

(

int

keyCode

)

Enable按键事件.

Parameters

[in]

keyCode

按键码

Return values

0	成功.
非0	失败.

Remarks

作为Disable按键事件的反过程。详见SU_Key_DisableEvent(int keyCode)

Attention

无。

int SU_Key_OpenEvent

(

void

)

获得按键事件句柄.

Parameters

无

Return values

>0	按键事件句柄.
<=0	失败.

Remarks

在成功获得一个按键事件句柄之后，即开始“记录”按键事件，直到关闭这个按键事件。

若打开多个句柄，则每个按键事件会记录一份按键事件。

例如，两个线程分别打开了一个按键事件，每个线程持有一个句柄，则这两个线程会读取到相同的事件序列。 但是如果两个线程共享同一个句柄，则每个按键事件只能被读取到一次。

Attention

无。

int SU_Key_ReadEvent	(	int	evfd,
		int *	keyCode,
		SUKeyEvent *	event
	)

读取按键事件.

Parameters

[in]	evfd	按键事件句柄
[in]	keyCode	按键码
[out]	event	按键事件指针.

Return values

0	成功.
非0	失败.

Remarks

该函数阻塞，直到有按键事件发生返回.

按键码的定义在linux/input.h中，与GPIO的映射关系定义在kernel板级文件中。

例如几个常用的按键：

#define KEY_HOME                102 //HOME键
#define KEY_POWER               116 //开关机键，一般也可用来作为唤醒键
#define KEY_WAKEUP              143 //唤醒键，除POWER键之外用来唤醒系统的按键
#define KEY_F13                 183 //当PIR作为按键使用时被定义为F13键

按键键码与GPIO号的定义，是否作为唤醒源，有效电平等信息均定义在内核板级文件中，如下所示：

struct gpio_keys_button __attribute__((weak)) board_buttons[] = {
#ifdef GPIO_HOME
   {
           .gpio           = GPIO_HOME,            //定义GPIO号
           .code           = KEY_HOME,                     //定义按键码
           .desc           = "home key",
           .active_low     = ACTIVE_LOW_HOME,      //定义有效电平
#ifdef WAKEUP_HOME
           .wakeup         = WAKEUP_HOME,          //定义是否可做为唤醒源，1为可唤醒suspend
#endif
#ifdef CAN_DISABLE_HOME
           .can_disable    = CAN_DISABLE_HOME,     //定义是否可以被Disable
#endif
   },
#endif
#ifdef GPIO_POWER
   {
           .gpio           = GPIO_POWER,
           .code           = KEY_POWER,
           .desc           = "power key",
           .active_low     = ACTIVE_LOW_POWER,
#ifdef WAKEUP_POWER
           .wakeup         = WAKEUP_POWER,
#endif
#ifdef CAN_DISABLE_POWER
           .can_disable    = CAN_DISABLE_POWER,
#endif
   },
#endif
}

Remarks

对于数字PIR，一种使用方式是把PIR作为一个按键定义，PIR触发相当于按键按下事件(KEY_PRESSED)， PIR恢复相当于按键抬起事件(KEY_RELEASED)。若需要PIR唤醒功能，则把PIR对应的按键定义为唤醒源即可。

API详细使用方法请参考sample-keyevent.c.

Attention

无。

int SU_LED_Command	(	int	ledNum,
		SULedCmd	cmd
	)

发送LED命令.

Parameters

[in]	ledNum	LED号.
[in]	cmd	LED行为命令.

Return values

0	成功.
非0	失败.

Remarks

LED号根据开发板的不同而不同。LED号定义在内核板级文件中，注册为Linux标 准Fixed Regulator设备。在板级文件中需定义LED的GPIO号，有效电平，电源递归关系等 信息。下面是定义了两个LED fixed regulator的例子：

FIXED_REGULATOR_DEF(  //定义fixed regulator
        led0,
        "LED0",         3300000,        GPIO_PA(14),
        HIGH_ENABLE,    UN_AT_BOOT,     0,
        "ldo7",         "vled0",        NULL);

FIXED_REGULATOR_DEF(
        led1,
        "LED1",         3300000,        GPIO_PA(15),
        HIGH_ENABLE,    UN_AT_BOOT,     0,
        "ldo7",         "vled1",        NULL);

static struct platform_device *fixed_regulator_devices[] __initdata = {
        &gsensor_regulator_device,
        &led0_regulator_device,
        &led1_regulator_device,
};

static int __init fix_regulator_init(void)  //在subsys_initcall_sync中注册regulator
{
        int i;

        for (i = 0; i < ARRAY_SIZE(fixed_regulator_devices); i++)
                fixed_regulator_devices[i]->id = i;

        return platform_add_devices(fixed_regulator_devices,
                                    ARRAY_SIZE(fixed_regulator_devices));
}
subsys_initcall_sync(fix_regulator_init);

此API的使用示例：

if (SU_LED_Command(0, LED_ON) < 0)  //使能LED0
    printf("LED0 turn on error\n");
if (SU_LED_Command(1, LED_ON) < 0)  //使能LED1
    printf("LED0 turn on error\n");
if (SU_LED_Command(0, LED_OFF) < 0)  //关闭LED0
    printf("LED1 turn off error\n");
if (SU_LED_Command(1, LED_OFF) < 0)  //关闭LED1
    printf("LED1 turn off error\n");

Attention

无。