---
title: "4.5. HandSet Device"
---

단말기에 장착된 장치를 제어하는 함수들이다.

### 관련 자료형

```c
//백라이트 제어관련 상수이다.

typedef enum MH_DevBackLight {
    MH_LIGHT_ON = 0, // 백라이트를 켬
    MH_LIGHT_OFF, // 백라이트를 끔
    MH_LIGHT_ALWAYS_ON, // 백라이트를 항상 켬
    MH_LIGHT_DEFAULT // 사용자 설정상태로 둠
} MH_DevBackLight;
```

### MH_devBacklight

**설명**

백라이트를 제어하는 함수 이다. 단말기에서 초기에 설정된 백라이트 설정이 존재 함을 가정한다. 어플리케이션에서 사용 후 원 상태로 돌리고 싶다면 `MH_LIGHT_DEFAULT` 값으로 재 설정 후 종료 한다. 타임아웃되면 자동으로 꺼진다. 이 함수를 호출 후 system 은 이 상태를 유지 하므로, 반드시 사용자가 정의한 기 본값으로 이 함수를 통화여 복귀 해야 한다. 백라이트 번호는 0 이면 주 LCD 의 백라이트이고 1 이면 보조 LCD 의 백라이트를 가르킨다. 만약 백라이트가 색상을 지정할 수 있을 경우 색상은 매개변수 color 로 지정하는데 color 값의 형식은 0xYYRRGGBB(네트웍 바이트 순서(network byte ordering)이다) 형태이다. 여기서 YY 는 무시되면 RR 은 빨강(Red), GG 는 녹색(Green), BB 는 파랑(Blue) 범위를 지정한다.

**프로토타입**

```c
M_Int32 MH_devBacklight (M_Int32 id, MH_DevBackLight on_off, M_Int32 color, M_Int32 timeout)
```

**매개 변수**

- `id` - [in] 백라이트 번호
- `on_off` - [in] 백라이트 조정 옵션
- `color` - [in] 백라이트 색상
- `timeout` - [in] 밀리초 단위, 타임아웃은 `MH_DEV_LIGHT_ON` 경우만 유효 하다

**반환 값**

성공

- 0

실패

- `M_E_ERROR` – 지정하는 백라이트가 존재하지 않을 경우

**부작용**

없음

**참고 항목**

없음

### MH_devVibrator

**설명**

Vibrator 를 제어 한다. 지정한 시간 동안 on 시킨 후 자동으로 꺼진다.

매개변수 level 값이 0 보다 큰 경우만 timeout 값이 유효하다. level 값 0 은 virbrator 가 꺼지는 것을 의미한다. 진동강도는 매개변수 level 값으로 정해지고 0-100 사이의 값이 올수 있다. 100 은 하드웨어가 지원하는 가장 강한 진동을 0 은 가장 약한 진동을 의미한다. 0-100 사이값을 어느정도의 진동세기와 일치시키는가 는 아래의 예처럼 하드웨어가 지원하는 진동단계를 백분율로 일치시킨것에 따른다. 하드웨어가 몇단계의 진동세기를 지원하는가는 `MH_sysGetInformation()`에서 반환 한다.

예)

- 진동세기가 하나인 하드웨어 => 1-100 : 진동
- 진동세기가 강,약 두개인 하드웨어 => 1-50 : 약진동, 51-100 : 강진동
- 진동세기가 강,중,약 세개인 하드웨어 => 1-33:약진동, 34 -66:중진동, 67-100:강진동

**프로토타입**

```c
void MH_devVibrator (M_Int32 level,  M_Int32 timeout)
```

**매개 변수**

- `level` - [in] 0 이면 off, 1-100 이면 운영체제에서 일치시킨 진동세기로 진동
- `timeout` - [in] 진동시간, 밀리초 단위

**반환 값**

없음

**부작용**

없음

**참고 항목**

없음

### MH_devLedControl

**설명**

LED 를 제어 한다.

예)

- 외장 LED 가 4 개 존재한다면 LSB BIT 부터 4 개를 사용한다.

![alt text](/wipi-wiki/assets/figures/hal/devledcontrol-img.png)

MH_devLedControl(0xF,0x6) 하위 led 4 개를 대상으로 그 중 가운데 2 개를 켠다.

**프로토타입**

```c
void MH_devLedControl (M_Int32 leds, M_Int32 mask)
```

**매개 변수**

- `leds` - [in] 제어할 LED
- `mask` - [in] 마스크할 비트

**반환 값**

없음

**부작용**

없음

**참고 항목**

없음

### MH_devGetLedCount

**설명**

외장된 LED 개수를 얻어 온다

**프로토타입**

```c
M_Int32 MH_devGetLedCount (void)
```

**매개 변수**

없음

**반환 값**

led 개수

**부작용**

없음

**참고 항목**

없음