2.3. 시스템

표준 플랫폼 커널에서 단말기의 정보 또는 이벤트를 입력받아 다음 수행 동 작을 결정하는 함수들이다. 커널의 동작 수행 상태를 확인 하기 위해 디버깅 하는 콘솔을 지원하는 함수와 크리티컬 섹션(Critical Section) 을 보호 하기 위해 서 단말기 운영체제에서 지원하는 잠금 메커니즘을 구현한 함수와 커널이 사용 할 메모리영역을 잡아주는 함수 등으로 구성되어 있다.

관련 자료형

운영체제에서 발생한 이벤트 중 플랫폼에 필요한 모든 이벤트는 MH_pltEvent() 함수를 통하여 플랫폼으로 전달된다. enum _MH_Event는 플랫폼 에 전달될 이벤트들을 정의한다. enum _MH_Event에 정의되어 있는 이벤트 중 더 세분화된 이벤트가 전달될 필요가 있을 때에는 각 모듈에서 enum MH_SUB_XXX_EVENT와 같이 세부 이벤트를 정의 한다. 예) MH_SERIAL_EVENT의 세부이벤트 정의

enum _MH_SUB_SERIAL_EVENT{
    MH_SERIAL_READ = 0, // READ 인터럽트가 발생한 경우
    MH_SERIAL_WRITE, // SERIAL에 write할 수 있다는 event
    MH_SERIAL_ERROR, // 시리얼 H/W 에러
};

정의된 세부 이벤트의 전달방법은 해당 모듈설명을 참고한다.

enum _MH_Event {
    MH_EXIT_EVENT = 1, // 시스템을 종료시켜주는 이벤트.
    MH_KEY_PRESSEVENT, // 키가 눌려 질 때 알려 주는 이벤트
    MH_KEY_RELEASEEVENT, // 키가 떼어 질 때 알려 주는 이벤트
    MH_KEY_REPEATEVENT, // 키를 누르고 있을 때 알려 주는 이벤트
    MH_TIMER_EVENT, // 타이머가 만료될 때 알려 주는 이벤트
    MH_SMS_EVENT, // SMS 메시지가 수신되었음을 알려 주는 이벤트
    MH_CALL_EVENT, // 전화가 왔음을 알려 주는 이벤트
    MH_ANN_EVENT, // 화면 표시 장치 정보가 변경 되었을 때
    // 알려주는 Event
    MH_NETWORK_EVENT, // 네트워크또는소켓의연결과 해제, 데이터
    // 쓰기 읽기 완료를 통지해 주는이벤트
    MH_SERIAL_EVENT, // 시리얼 읽기, 쓰기 및 에러 상태을 통지해
    // 주는 이벤트
    MH_MEDIA_EVENT // 미디어 관련 버퍼의 상태 또는 재생
    // 상태를 통지해 주는 이벤트
};

<표 2-3-1> 시스템 관련 이벤트

이벤트 세부이벤트 이벤트 발생 함수/상황 MH_EXIT_EVENT 플랫폼 종료를 위하여 운 영체제에서 발생시킴

MH_KEY_PRESSEVENTKeyPress
MH_KEY_RELEASEEVENTKeyRelease
MH_KEY_REPEATEVENT일정시간이상keypress시 - MH_TIMER_EVENT MH_timerSet()
MH_SMS_EVENTMH_SMS_NEWSMS도착 - MH_SMS_SEND_NOTIFY MH_smsSend()
MH_CALL_EVENTMH_CALL_INCOMING전화가왔을때발생 - MH_CALL_NOTIFY MH_callPlace()
MH_ANN_EVENTAnnunciator와관련된상 - 태변화 MH_NETWORK_EVENT MH_NETEV_NETWORK_OPEN MH_netConnect() MH_ NETEV_NETWORK_CLOSE MH_netClose() MH_ NETEV_SOCKET_CONNECT MH_netSocketConnect() MH_ NETEV_SOCKET_CLOSE MH_netSocketClose() MH_NETEV_SOCKET_READ MH_netSocketRead() MH_NETEV_SOCKET_WRITE MH_netSocketWrite() MH_SERIAL_EVENT MH_SERIAL_READ MH_serialRead() MH_SERIAL_WRITE MH_serialWrite() MH_SERIAL_ERROR 시리얼 H/W 문제
MH_SERIAL_DTR시리얼케이블의상태변화 - MH_MEDIA_EVENT MH_MDAEV_MEDIA_EMPTY MH_mdaWriteData() MH_mdaPlay() MH_MDAEV_MEDIA_FULL MH_mdaRecord() MH_MDAEV_TONE_EMPTY MH_mdaTonePlay() MH_mdaFreqTonePlay() MH_MDAEV_TONE_ERROR MH_mdaTonePlay() MH_mdaFreqTonePlay()

enum _MH_KeyCode{
    MH_KEY_0 = '0',
    MH_KEY_1 = '1',
    MH_KEY_2 = '2',
    MH_KEY_3 = '3',
    MH_KEY_4 = '4',
    MH_KEY_5 = '5',
    MH_KEY_6 = '6',
    MH_KEY_7 = '7',
    MH_KEY_8 = '8',
    MH_KEY_9 = '9',
    MH_KEY_ASTERISK = '*',
    MH_KEY_POUND = '#',
    MH_KEY_UP = -1,
    MH_KEY_DOWN = -2,
    MH_KEY_LEFT = -3,
    MH_KEY_RIGHT = -4,
    MH_KEY_SELECT = -5,
    MH_KEY_SOFT1 = -6,
    MH_KEY_SOFT2 = -7,
    MH_KEY_SOFT3 = -8,
    MH_KEY_SEND = -10,
    MH_KEY_END = -11,
    MH_KEY_POWER = -12,
    MH_KEY_SIDE_UP = -13,
    MH_KEY_SIDE_DOWN = -14,
    MH_KEY_SIDE_SEL = -15,
    MH_KEY_CLEAR = -16,
    MH_KEY_FLIPDOWN = -17,
    MH_KEY_FLIPUP = -18,
    MH_KEY_INVALID = 0
};
enum MH_CallState {
    MH_CS_IDLE = 0,
    MH_CS_CALLING,
    MH_CS_CALLED,
    MH_CS_CALLREJECTED,
    MH_CS_INCOMING, // 이때, 발신 번호가 매개변수로
    // 전달 되어야 함
    MH_CS_OTHERCALL, // 통화 중 대기
    MH_CS_TRANSFERCALL, // 대기 통화로 전환
    MH_CS_END
}
enum _MH_Annunciator{
    MH_ANN_RSSI, // 현재 RSSI 수준이 갱신 열거형의 경우 시
    작값 // 명시
    MH_ANN_BATT, // 현재 배터리 수준이 갱신
    MH_ANN_NOSERVICE, // 통화권 이탈
    MH_ANN_SILENTMODE, // 진동, 벨소리 모드
    MH_ANN_ALARM, // 알람 설정 유무
}
typedef _MH_Annunciator MH_Annunciator;
struct _MH_AnnInfo{
    MH_Annunciator type; //Annunciator info type
    M_Int32 data;
}
typedef struct _MH_AnnInfo MH_AnnInfo;

MH_sysGetHeapBlock

프로토타입

void MH_sysGetHeapBlock (M_Uint32* start, M_Uint32* size)

설명

이 함수는 플랫폼이 사용할 휘발성 메모리의 크기와 시작번지를 얻어오는 함수 이다. 이 메모리는 고정되어야 하며, 플랫폼을 제외한 타 소프트웨어 모듈 이 메모리를 사 용해서는 안된다.

매개 변수

start - [out] Heap의 시작 번지 반환
size - [out] Heap의 사이즈 반환

반환 값

없음

부작용

없음

참고 항목

없음

MH_sysGetInformation

프로토타입

M_Int32 MH_sysGetInformation (M_Char* command, M_Char* buf,
M_Int32 bufSize)

설명

이 함수는 단말기의 시스템 정보를 얻어오는 함수이다. 반환할 값이 정수일 때는 10 진수 string으로 변환하여 버퍼를 통하여 반환한다. 제조사나 이통사가 플랫폼에서 정 의되지 않은 정보를 확장하고 싶은 경우, command값을 추가하여 확장한다. 예) M_Char buf[16]; MH_sysGetInformation(”ESN”, buf, sizeof(buf));

매개 변수

command - [in] String 값
buf - [out] 버퍼
bufSize - [out] 버퍼 크기

<표 2-3-2> 시스템 커맨드

Command 비고 “ESN” ESN번호 “NID” 네트워크 식별(Network Identification ) “SID” 시스템 식별(System Identification) “BASEID” 기본 스테이션 식별(Base station Identification) “BASELAT” 기본 스테이션 위도(Base station Latitude) “BASELONG” 기본 스테이션 경도(Base station longitude) “CURRENTCH” 현재 채널 번호(Current Channel number) “PHONENUMBER” 전화 번호 “RSSILEVEL” 현재 RSSI 레벨 “BATTERYLEVEL” 현재 배터리레벨 “MAXRSSILEVEL” 최대 RSSI 레벨 “MAXBATTLEVEL” 최대 배터리 레벨 “MAXSERIALNUM” 최대 지원되는 시리얼포트 개수 “MAXSOCKETNUM” 최대 지원되는 소켓 개수 “MEDIADEVICES” 지원하는 미디어 device의 문자열, 여러 개일 경우 “,” 로 구분함. 지원되는 device가 없으면 M_E_NOTSUP를 반환. 미리 정의된 문자열 문자열 Device “Qualcomm_CMX” Qualcomm CMX “Yamaha_MA1” Yamaha MA1 “Yamaha_MA2” Yamaha MA2 “Yamaha_MA3” Yamaha MA3 “Yamaha_MA5” Yamaha MA5 “audio/MIDI” MIDI 포맷을 play할 수 있는 디바이스일 경우, “audio/MP3” MP3 포맷을 play할 수 있는 디바이스일 경우, “IS96” QCELP-8K “IS96A” QCELP-8K “IS733” QCELP-13K “IS127” EVRC-8K 디바이스가 미리 정의된 문자열을 지원할 시에는 정의 된 문자열을 반환하고, 그렇지 않을 경우에는 벤더나 이 통사에서 정의하여 확장한다. 지원되는 포맷이 하드웨어 종속적이 아닌 경우에는 “audio/xxx”와 MIME타입에 따 라 확장한다. 예) 운영체제가 CMX, MA1 EVRC-8K을 지원할 경우, 반 환되는 문자열 “Qualcomm_CMX, Yamaha_MA1” “DNS” 도메인 네임 서버를 지정한다. IP 주소 문자열. 예) “127.0.0.1” “TIMEZONE” “GMT+시:분 “, “GMT-시:분“와 같은 형태로 현재의 time zone을 반환한다. 시, 분은 각각 두 자리 문자열을 사용한다. 예) “GMT+09:30”, “GMT-12:00” “PHONEMODEL” 단말기의 모델 ID string 폰 모델 “KEYREPEAT” “반복시작시간:반복주기시간”, 단위는 ms이다. 지원하지 않으면 M_E_NOTSUP반환할 수 있다. 예) “600:250” 버튼이 눌려지고 600ms후에 MH_KEYREPEAT_EVENT가 처음 발생한 후, 250ms마다 주기적으로 버튼이 떼어질 때까지 발생한다. “VIBRATORLEVEL” 하드웨어가 지원하는 진동세기의 단계를 반환한다. (최소 0, 최대 100) 예) “3” 3단계의 진동세기 지원 “1” 1단계의 진동세기 지원 “VOLUMELEVEL” 하드웨어가 지원하는 볼륨세기의 단계를 반환한다. (최소 0, 최대 100) 예) “10” 10단계의 볼륨세기 지원 “4” 4단계의 볼륨세기 지원

반환 값

성공

실패

M_E_INVALID - 지원하지 않는 command값
M_E_NOTSUP - command값에 대하여 반환할 문자열이 존재 하지 않음
M_E_SHORTBUF - 저장할 버퍼가 작음

부작용

없음

참고 항목

없음

MH_sysSetInformation

프로토타입

M_Int32 MH_sysSetInformation(M_Char* cmd, M_Char* value)

설명

시스템 정보 값을 변경할 때 사용하는 함수이다. HAL 구현 시 단말기 기본 소프트웨 어에 따라 변경이 불가능한 정보가 있을 수 있다.

매개 변수

cmd - [in] 변경하고자 하는 정보명.
value - [in] cmd에 해당하는 정보값을 나타내는 문자열

반환 값

성공

실패

M_E_ACCESS - 변경할 수 없는 정보임
M_E_INVALID - cmd값이나 value값이 잘못됨

부작용

없음

참고 항목

없음

MH_sysLock

프로토타입

void MH_sysLock (void)

설명

크리티컬 섹션을 보호하기 위한 함수 이다. 플랫폼 외부 문맥의 진입을 금지하는 영역의 시작을 지정한다. MH_sysUnlock 함수의 해 재진입을 허용한다. MH_pltEvent() 같은 함수는 운영체제가 플랫폼에 이벤트를 전달하기 위하여 부른다. 운영체제가 MH_pltEvent()를 호출 할 때는 운영체제의 인터럽트 서비스 루틴(Interrupt Service Routine)에서 호출할 수도 있고, 플랫폼 태스크가 아닌 다른 태스크에서 호출 할 수도 있다. 이때 호출된 MH_pltEvent() 함수와 플랫폼의 context에서 사용하는 영 역간에 크리티컬 섹션이 발생한다. 포팅자는 MH_sysLock()이 불려진 경우에는 MH_sysUnlock()이 호출될 때까지 운영체제가 MH_pltEvent()를 부르지 않도록 HAL을 구현해야 한다. MH_sysLock(), MH_sysUnlock은 중복되게 호출될 수 있다. 이때 맨 처음 MH_sysLock()이 호출될 때 lock이 되고, 맨 마지막 MH_sysUnlock이 호출될 때 lock 이 해제 되어야 한다.

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

MH_sysUnlock

MH_sysUnlock

프로토타입

void MH_sysUnlock (void)

설명

MH_sysLock에서 진입 금지한 상태를 해제 한다..

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

MH_sysLock

MH_sysHalInit

프로토타입

void MH_sysHalInit (void)

설명

Hal 초기화 루틴 이다. 이 함수는 어떤 HAL API도 사용되기 이전에 최초 호출 되어야 한다. HAL에서 지원하 는 API중 초기화가 필요한 API는 여기서 초기화 과정을 수행하도록 한다.

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

없음

MH_sysHalExit

프로토타입

void MH_sysHalExit()

설명

플랫폼 종료 시 호출되는 함수이다. HAL 계층에서 사용된 자원 해제 등 각 단말기 HAL에 맞도록 플랫폼 종료 시 취해야 할 작업을 정의한다.

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

없음

MH_sysWait

프로토타입

void MH_sysWait (void)

설명

Binary semaphore wait 기능이다. 플랫폼은 내부적으로 더 이상 처리할 일이 없을 때 이 함수를 부른다. HAL은 이 함수 가 불리면 태스크를 blocking시켜 CPU power를 소비하지 않도록 구현해야 한다.

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

없음

MH_sysSignal

프로토타입

void MH_sysSignal (void)

설명

Binary semaphore signal 기능이다. 이 함수가 불리면 MH_sysWait()에서 blocking된 태스크를 깨워주어야 한다. 이 함수는 주로 MH_pltEvent()내에서 주로 사용한다. MH_sysSignal()은 인터럽트 서비 스 루틴 안에서 불려도 동작하게 포팅 해야 한다.

매개 변수

없음

반환 값

없음

부작용

없음

참고 항목

없음

MH_debugPutChar

프로토타입

void MH_debugPutChar(M_Char ch);

설명

플랫폼의 디버깅정보를 출력한다. 플랫폼의 표준출력은 모두 이 API로 오게 된다. HAL구현자는 이 API를 시리얼, 네트워크, 콘솔(console)등 적절한 곳으로 연결하여 메시지를 볼 수 있다.

매개 변수

ch - [in] 출력한 문자

반환 값

없음

부작용

없음

참고 항목

없음