/**
	@file
		DHL_OSAL_Priv.h

	@brief
		Private (internal) APIs

	이 모듈에 대한 간단한 설명.. 
	ex: AudioVideo decoding/capture/output implementation

	Copyright 2006~2010 Digital STREAM Technology, Inc.
	All Rights Reserved
*/


#ifndef __DHL_OSAL_PRIV_H__
#define __DHL_OSAL_PRIV_H__


#include "DHL_OSAL.h"



#ifdef __cplusplus
extern "C" {
#endif



#if COMMENT
____Overview____(){}
#endif

/**
	@file DHL_OSAL_Priv.h
	
	이곳에 이 모듈에 대해 설명이 필요한 각종 내용 기술..
	
	module overview
		- 
		-

	APIs
	
	implementations
	
	dependencies		
	
	nv parameters
		
	
	
*/


#if COMMENT
____Config____(){}
#endif

/*
	이 부분은 별도의 DHL_XXX_Config configuration file 을 
	활용하는 것이 좋을 것 같음.
*/


#if COMMENT
____Types____(){}
#endif

/*
	다른 모듈들과 공유 되는 structure 및 enumerations.
*/




#if COMMENT
____Defines____(){}
#endif


/**

	bitwise flags.
*/
typedef enum 
{
	eDHL_OS_GLF_NORMAL = 0x0, ///<
	eDHL_OS_GLF_NOECHO = 0x1, ///<
	eDHL_OS_GLF_PASSWD = 0x2, ///< 암호 입력..

} DHL_OS_GET_LINE_FLAGS;



#if COMMENT
____API____(){}
#endif



/** @brief 콘솔에서 라인 명령 입력받는 함수.

	라인 단위 입력 API.
	입력 도중 Backspace 키를 지원하여 수정이 가능하다.
	입력의 종료는 엔터키이다. 엔터키 자체는 버퍼에 기록 안된다.

	버퍼의 최대 크기만큼 입력될 경우 더 이상 입력 안됨.
	특수 키는 현재 지원되지 않음.

	@param[inout] buf    입력 받을 메모리 버퍼 포인터.
	@param[in]    size   buf의 최대 크기.
	@param[in]    flags  입력 동작 모드 제어 플래그.

	@return
		- 끝 CR/LF 부분을 제외한 입력된 글자 수를 리턴한다.
		- 입력이 ESC에 의해 취소된 경우라면 -1을 리턴한다.
		- 기타 에러 발생시 <-1을 리턴한다.
		
*/
int dhl_os_get_line(char *buf, int size, DHL_OS_GET_LINE_FLAGS flags);


/**
	console APIs
	MMAC 인터럽트 API를 사용하여 UART RX의 수신 성능을 보장해 준다.
	DHL_OS_GetChar 내부에서 사용됨.
*/
void dhl_console_init(void);
void dhl_console_uninit(void);
BOOL dhl_console_getbyte(UINT8 *key);

// DHL_Timer에서 사용하기 위해 private 용도로 정의
DHL_RESULT dhl_os_delete_task(DHL_OS_TASK_ID tid);

// Debug 메모리 용도로 사용되는 함수
UINT32 dhl_os_check_valid_ptr(void *block);
void *dhl_os_internal_malloc(UINT32 size, const char *filename, UINT32 lineNumber);
void dhl_os_internal_free(void *block, const char *filename, UINT32 line);


#ifdef __cplusplus
} /* extern "C" */
#endif



#endif	/* __DHL_OSAL_PRIV_H__ */