 
/****************************************************************************
* NAME: DMW_SysTime.c  
*----------------------------------------------------------------------------
* Copyright (c) 2003 DST Inc.
*----------------------------------------------------------------------------
* CREATED_BY: DIGITAL STREAM Technology Inc.
* CREATION_DATE: 2003/09/15
* AUTHOR: Kyu-hong Park 
* REVISION: Ver 1.001      
* DATE: 
*----------------------------------------------------------------------------
* PURPOSE: 
* - 시스템 시간관련 함수 및 시간경과 측정 함수 구현                               
*****************************************************************************/


#include "DMW_Platform.h"

#include "DMW_SysTime.h"

//#include <string.h>


DHL_MODULE("$stm", 1);

/*------------------------------------------------------------------*/

#define DONT_USE_C_STD_LIB 1
	/*
	 multi 개발 환경에서는 time() 과 같은 stdlib 함수를 절대 사용하면 안된다.
	*/


/*_____ D E F I N I T I O N ________________________________________________*/

                                   
#define DEF_TIME_OFFSET   630687600  /* 2000년 1월1일 한국에서의 UTC.. */
																						

/*	모든 API에 사용되는 SysTimeContext를 지정하지 않았을때
	공통으로 사용되는 디폴트 context이다.
*/

SysTimeContext g_DefaultSysTimeContext = 
{
	0, /* BOOL bTimebaseAdjusted  */
	DEF_TIME_OFFSET, /* int nTimeSystemBase */
	
	9, /* int nTimeZone; */
	0, /* BOOL bDaylightSavingOn; */	/* 1: use daylight saving , 0: not use daylight saving  */

	13, /* int GPS_UTC_offset; */

};


/*-----------------------------
 for debugging and testing..
*/


const char *DayOfWeekString(int n)
{
	/* n: [0 ~ 6]  */
	char *name[] = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", };
	static char err[12];
	if (n < 0 || n > 6) {
		sprintf(err, "?(%d)", n);
		return err;
	}
	return name[n];
}

const char *STimeString(STime_t *s, char *buf)
{
	static char _buf[64];
	
	if (buf == NULL) buf = _buf;
	
	sprintf(buf, "%d/%d/%d %s %d:%02d:%02d", 
		s->year, s->month, s->day, DayOfWeakString(s->wday), s->hour, s->min, s->sec);
		
	return buf;
}


/*
http://www.leapsecond.com/java/gpsclock.htm

Local time is the date/time reported by your PC (as seen by your web browser).
If your PC clock is accurate to a second then the other time scales displayed
above will also be accurate to within one second. 

UTC, Coordinated Universal Time, popularly known as GMT (Greenwich Mean Time),
or Zulu time. Local time differs from UTC by the number of hours of your 
timezone. 

GPS, Global Positioning System time, is the atomic time scale implemented by 
the atomic clocks in the GPS ground control stations and the GPS satellites 
themselves. GPS time was zero at 0h 6-Jan-1980 and since it is not perturbed 
by leap seconds GPS is now ahead of UTC by 13 seconds. 
*/



#if COMMENT
____UTC_Core_____(){}
#endif

/*======================================================================
// ANSI 표준 함수인 time()은 문서상 UTC time을 리턴하는 것으로 되어 있다
// ----
// The time function returns the number of seconds elapsed since midnight (00:00:00), 
// January 1, 1970, coordinated universal time, according to the system clock
// ----
// 그러나 플랫폼 상에 RTC가 없기 때문에 절대적인 값은 정확하지 않다.
// 그래서 time()에서 리턴되는 값과의 차이를 기억하여 값을 보정함으로써
// Set/Get time 함수를 구현한다.
//
//  정의:
//        UTC time = time() + timeSystemBase
//
//        timeSystemBase = UTC_time_to_set - time()
// 
// 참고
// 시스템에 RTC가 없으므로 부팅후 최초 1회 SetUTCTime()을 불러서 시간보정을
// 해 줘야만 한다.
//
*/
/****************************************************************************
Function Name:
	DMW_SetUTCTime

Description:
	UTC Time 으로 시스템 시간 설정

Note:
	시스템 시간을 변경가능할 시에는 이 함수를 수정 필요! 
*****************************************************************************/
void DMW_SetUTCTime(SysTimeContext *stc, UINT32 utc)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	stc->tickTimeAdjusted = DHL_OS_GetMsCount();
	stc->nTimeSystemBase = utc;
	
	stc->bTimebaseAdjusted = TRUE;
}


/****************************************************************************
Function Name:
	DMW_GetUTCTime

Description:
	UTC Time 얻어옮
	DMW_SetUTCTime 이 한번도 호출되지 않았다면 잘못된 값이 리턴될 것이다.

Note:
	
*****************************************************************************/
STATUS DMW_GetUTCTime(SysTimeContext *stc, UINT32 *utc)
{
	long int now;

	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	if (stc->bTimebaseAdjusted == FALSE) {
		if (utc) *utc = 0;
		dprint(0, "!! GetUTCTime: time not initialized\n");
		
		/* cafrii 050315 add
		// 한번도 초기화 (set time)를 하지 않은 상태에서 get time이 불린 경우이다.
		// 원칙적으로는 에러 값을 리턴하고, caller는 이 리턴값을 항상 체크해야 한다.
		// 그런데 application 에서 그냥 간단하게 set time 하기 전까지는 
		// time context의 디폴트 값을 사용하기를 원하며 리턴값 에러 체크도 잘 하지 않는 경우가 많다.
		// context에 디폴트 utc time을 설정해 놓았기 때문에 이 값을 사용할 수도 있을 것 같다.
		//
		// 리턴값은 에러로 리턴하지만, utc 값은 대략 비슷하게 설정해서 돌려주도록 한다.
		// time(0) 은 부팅 이후 경과된 시간 (초) 이므로 이 값을 더해서 리턴하자.
		*/
		
		if (utc)
			*utc = (DHL_OS_GetMsCount()-0)/1000 + stc->nTimeSystemBase;

		
		return statusError;  /* time not initialized..  */
	}


	/* 마지막으로 SetUTC 한 이후의 경과 시간을 이용. */
	now = stc->nTimeSystemBase + 
		(DHL_OS_GetMsCount()-stc->tickTimeAdjusted)/1000;
	
	if (utc) *utc = now;
		
	return statusOK;	
}


#if COMMENT
____UTC_Conversion_____(){}
#endif

/****************************************************************************
Function Name:
	DMW_ConvertLocalTime2UTC

Description:
	Local Time을 UTC로 변경함.
	변환에는 여러가지 parameter가 필요하다. (time_zone, 등)
	ex:
		2004년 6월 15일 --> 0x........
Note:
	STime_t::wday 값은 사용되지 않는다.
	
계산 방식:
	먼저 1980년 1월 1일 0시 이후로 몇초가 되는지 계산을 하고,
	daylight saving 고려하여 3600초를 보정하고,
	timezone 고려하여 n*3600 초를 보정,
	그리고 나서 1980년 1월 6일 
	
	cafrii 081008, consider daylight savings.
	 
*****************************************************************************/
UINT32 DMW_ConvertLocalTime2UTC(SysTimeContext *stc, STime_t *s)
{
	UINT32	utc=0;
	int		leap;
	UINT32 	i, tmp;
	char *msg1;
	
	BOOL bEffectiveDS = FALSE;

	UINT32 daytab[2][13] = {
		{365, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31},
		{366, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}
	};

	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	/* exception handling by hschang, 2004/1/18  */
	if(s->year<1980 || s->month<1 || s->day<1) {
		dprint(0, "!! ConvertLocalTime2UTC: invalid time, set to 0\n");
		utc = 0;   /* 1980/1/6 00:00:00  */
		return utc;
	}

	if (stc->bDaylightSavingOn) 
	{
		bEffectiveDS = stc->DS_status;

		if (stc->DS_day_of_month && 
			stc->DS_day_of_month == s->day && /* we only consider matched date. */
			stc->DS_hour <= s->hour)
		{
			bEffectiveDS = bEffectiveDS ? 0 : 1;
		}
	}
	
	tmp = s->year - 1980; /* 누적 계산해야 할 연도 수 */

	for(i=s->year-1; i>=1980; i--) /* 비교계산시 약간의 효율 증대를 위해서 거꾸로 셈.. */
	{
		leap = ((i%4==0)&&(i%100!=0)) || (i%400==0);		
		utc += daytab[leap][0]*86400;
	}
	
	leap = (((s->year)%4==0)&&((s->year)%100!=0)) || ((s->year)%400==0);
	tmp = s->month - 1;

	for(i=1; i<(tmp+1); i++)
		utc += daytab[leap][i]*86400;

	/* 우리가 원하는 달력날짜 이상의 값이 올 수도 있다. 이유는 host에서 달력을 가지고 있지 않으므로
	// 날짜에 대한 exception handling (28, 29,30,31보다 큰것)은 하지 말아야 한다.
	// 하지만, 0에 대한 exception handling은 앞에서 미리 하여야 할 것 같다. -hschang-
	*/
	tmp = s->day - 1;
	utc += 86400*tmp;
	utc += s->hour*3600;
	utc += s->min*60;		
	utc += s->sec;

	/* daylightsaving과, timezone 보정하면서 utc 가 음의 값으로 내려가지 않도록 각별히 주의하라!!
	*/
	msg1 = "!! before 1980/1/6 !! reset to 0\n";
	if (bEffectiveDS) {
		if (utc < 3600) {
			dprint(0, msg1);
			return 0;
		}
		utc -= 3600;
	}
	
	/* cafrii 041005 bugfix
	// timezone의 값이 음의 값일 수 있으므로 utc와 직접 비교하는 것은 문제가 된다.
	// 아직 1월1일부터 1월6일까지의 5일 간의 여유분이 있으므로 최대 +12시간까지는 문제 없으므로
	// 바로 '뺄셈'을 해도 된다.
	*/ 
	utc -= stc->nTimeZone*3600;

	if (utc < 432000) { /* 1980/1/6 이전의 시간이다.. 에러..  */
			dprint(0, msg1);
		return 0;
	}
	else {
		utc -= 432000;
	}

	return utc;
}

/****************************************************************************
Function Name:
	DMW_ConvertUTC2LocalTime

Description:
	UTC를 Local Time으로 변경함.

Note:
	 
*****************************************************************************/
void DMW_ConvertUTC2LocalTime(SysTimeContext *stc, UINT32 utc_in, STime_t *t)
{
	STime_t s;
	UINT32 utc = utc_in;

	UINT32 daytab[2][13] = {
		{365, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31},
		{366, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}
	};
	int acc_day;
	int i, leap;

	if (stc == NULL) stc = &g_DefaultSysTimeContext;

	/* timezone 설정에 따른 보정을 한다. */
	utc += (stc->nTimeZone * 3600);
	
	/* daylight saving에 따른 보정을 한다. */
	
	/* note:
		이곳에는 trick이 있다.
		DS_status가 1이라고 하더라도 month, day가 일치하면 동작여부가 반대로 되어야 한다.
		하지만 시간 계산이 완료되기 전까지는 month, day 일치 여부를 알 수 없다.
		
		즉, 시간 계산을 하려면 daylight saving 동작 여부가 결정되어야 하고,
		동작 여부를 결정하려면 month, day을 알아야 하는 chicken & egg 문제이다.

		해법은, 먼저 month, day 일치 여부는 신경쓰지 말고 DS_status 만으로 계산을 하고,
		계산후에 month, day가 일치하게 되면 다시 DS_status를 바꾸어서 한번 더 계산을 한다.
		
		어떠한 경우에라도 bDaylightSavingOn 가 false이면 daylight saving은 결코 동작하지 않는다.
	*/
	if (stc->bDaylightSavingOn && stc->DS_status) {
		utc += 3600;
		stc->bDaylightSavingActive = TRUE;
	}
	else
		stc->bDaylightSavingActive = FALSE;
	


#if 1
	/* 1980/1/1 부터 UTC의 기준인 1980/1/6 까지의 시간을 더한 다음
	// 1980년 부터 계산해 나가면 편하다. 그러면 UINT32 wrap-around로 인한 버그를 피할수 있다.
	*/
	utc += 432000;   /* 5일간의 초  */
	acc_day = -5;
	s.year = 1980;
	s.month = 1;
	s.day = 1;
	s.wday = 2;	/* Tuesday: 1980년 1월 1일은 화요일 */
	s.hour = 0;
	s.min = 0;
	s.sec = 0;
	leap = 1;   /* 1980년은 4의 배수이므로 윤년.. */
#else

	/* 이 방식은 1981년 1월 1일 0시를 기준으로 계산하므로 1980년 1월 6일 부터 
	// 1980년 12월 말 까지의 구간 동안에는 UTC 시간 변환을 못하는 결정적인 단점이 있다.
	// 사용하지 말도록 하자.
	*/
	if (utc < 31190400)
		dprint(0, "!! utc before 1981/1/1 cannot be used!!\n");

	acc_day=361;
	s.year = 1981;  /* 1981/1/1 0:0:0 에서부터 계산해 나간다 */
	s.month = 1;
	s.day = 1;
	s.wday = 4;	/* Thurday */
	s.hour = 0;
	s.min = 0;
	s.sec = 0;
	utc -= 31190400; 	/* 1980.1.6~1980.12.31까지의 초. */
	leap = 0;
#endif

	/*while ((stime/(daytab[leap][0]*86400))>0) */

	/* year를 계산 */
	while (utc >= (daytab[leap][0]*86400))
	{
		utc -= daytab[leap][0]*86400;
		acc_day += daytab[leap][0];
		s.year ++;
		leap = ((s.year%4==0)&&(s.year%100!=0))||(s.year%400==0);
	}

	/* month를 계산 */
	i=1;
	while (utc >= (daytab[leap][i]*86400))
	{
		utc -= daytab[leap][i]*86400;
		acc_day += daytab[leap][i];
		s.month ++;
		i++;
	}

	s.day += (utc/86400);
	acc_day += (utc/86400);
	utc = utc%86400;
	
	/* s.wday = acc_day%7; */
	s.wday = (acc_day + 7) % 7;
		/*
		// cafrii 050315 fix
		// acc_day의 초기값이 -5 부터 시작하여 accumulated 되었으므로
		// 아직 0 이하의 값으로 남아 있을 수도 있다. (물론 잘못된 utc 값인 경우임)
		// 그래도 wday를 정확하게 리턴할 수 있도록 조정을 해주자.
		*/
	
	s.hour = (utc/3600);

	/* cafrii 081008 add.
	// because day and hour is calculated, we can check daylight saving again.
	*/
	if (stc->bDaylightSavingOn &&
		stc->DS_day_of_month && 
		stc->DS_day_of_month == s.day &&
		stc->DS_hour <= s.hour)
	{
		/* 이 코드는 일종의 trick이다.
			local time을 계산 해 본 결과, DS in/out 조건에 부합되었으므로 
			실제로는 daylight saving 동작 여부가 반대가 되어야 한다.
			예를 들면, 
			DS_status가 0(동작안함)이었지만 day와 month가 일치하면 DS가 동작해야 하고,
			DS_status가 1(동작)이었지만 day와 month가 일치하면 DS가 동작하면 안된다.

			다시 계산해야 하는 불편함이 있는데, 재귀호출을 사용하여 쉽게 해결 가능하다.
			단 원래 사용중인 stc는 건드리면 안되고, clone을 하나 만들어야 한다.
		*/
		SysTimeContext stc_clone = *stc;
		
		/* consider daylight saving in/out condition.
		// re-calculate with modified parameter. 
		*/
		stc_clone.DS_status = stc->DS_status ? 0 : 1;
		stc_clone.DS_day_of_month = 0; /* so as not to re-consider again. */
		/* TIP: DS_day_of_month 처리를 안해주면 무한 루프에 들어갈 수 있다. 주의.. */

		DMW_ConvertUTC2LocalTime(&stc_clone, utc_in, t);

		/* 실제로 daylight saving의 동작 여부 flag를 갱신. */
		stc->bDaylightSavingActive = stc_clone.DS_status;

		return;
	}
	
	utc = utc%3600;

	s.min = (utc/60);		
	s.sec = utc%60;
	
	if (t) *t = s;
}

/****************************************************************************
Function Name:
	DMW_SetLocalTime

Description:
	Local Time 으로 시스템 시간 설정

Note:
	시스템 시간을 변경가능할 시에는 이 함수를 수정 필요! 
*****************************************************************************/

void DMW_SetLocalTime(SysTimeContext *stc, STime_t *t)
{
	UINT32 utc;
	STime_t t2;
	
	utc = DMW_ConvertLocalTime2UTC(stc, t);

	DMW_SetUTCTime(stc, utc);
	
	/* verifying.. */
	DMW_ConvertUTC2LocalTime(stc, utc, &t2);
	
	if (t->wday != t2.wday) {
		/* dprint(2, "SetLocalTime: original wday %d wrong. correct it to %d\n", t->wday, t2.wday);  */
		t->wday = t2.wday;   /* wday is newly calculated.. so we copy it! */
	}
	
	if (memcmp(t, &t2, sizeof(STime_t))) {
		char c1[50], c2[50];
		dprint(0, "!! conversion err!! %s, %s\n", STimeString(t, c1), STimeString(&t2, c2));
	}
}

void DMW_SetLocalTime2(SysTimeContext *stc, int year, int month, int day, int hour, int min, int sec)
{
	STime_t system_time;

	system_time.year = year;
	system_time.month = month;
	system_time.day = day;
	system_time.hour = hour;
	system_time.min = min;
	system_time.sec = sec;

	DMW_SetLocalTime(stc, &system_time);
}


/****************************************************************************
Function Name:
	DMW_GetLocalTime

Description:
	Local Time 시각을 가져옴.

Note:
	 
*****************************************************************************/
int DMW_GetLocalTime(SysTimeContext *stc, STime_t *sys_time)
{
	UINT32 utc;
	int err;
	
	if (stc == NULL) stc = &g_DefaultSysTimeContext;

	err = DMW_GetUTCTime(stc, &utc);

	DMW_ConvertUTC2LocalTime(stc, utc, sys_time);
	
	return err;
}


/****************************************************************************
Function Name:
	DMW_ConvertUTC2GPS

Description:
	UTC를 GPS로 변경함.

Note:
	 
*****************************************************************************/
UINT32 DMW_ConvertUTC2GPS(SysTimeContext *stc, UINT32 UTC)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	return (UTC + (UINT32)stc->GPS_UTC_offset);
}

/****************************************************************************
Function Name:
	DMW_ConvertGPS2UTC

Description:
	GPS를 UTC로 변경함.

Note:
	 
*****************************************************************************/
UINT32 DMW_ConvertGPS2UTC(SysTimeContext *stc, UINT32 GPS)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	if (GPS < (UINT32)(stc->GPS_UTC_offset)) { /* cafriii 040617 add */ /*ARZHNA, 090618, (UINT32)추가 */
		return 0; /* 음의 utc 값은 지원하지 않음.. */
	}
	return (GPS - (UINT32)stc->GPS_UTC_offset);
}


#if COMMENT
____Param_Set____(){}
#endif

/****************************************************************************
Function Name:
	void DMW_SetLocalTimeZone(int time_zone) 

Description:
	Set Time Zone with Offset Hours

Note:
	time_zone : -12 ~ +12	
*****************************************************************************/
void DMW_SetLocalTimeZone(SysTimeContext *stc, int time_zone) 
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	if (time_zone<=12 && time_zone>=-12)
		stc->nTimeZone = time_zone;
	else dprint(0, "!! Time Zone %d out of range\n", time_zone);
}

/****************************************************************************
Function Name:
	int DMW_GetLocalTimeZone(void);

Description:
	Get Time Zone with Offset Hours

Note:
	time_zone : -12 ~ +12	
*****************************************************************************/
int DMW_GetLocalTimeZone(SysTimeContext *stc) 
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	return stc->nTimeZone;	
}

/****************************************************************************
Function Name:
	void DMW_SetDayLightSaving(char dayLightSavingOn) 

Description:
	Day Light Saving 준수 여부 설정
	주의: 지금 현재 daylight saving을 강제로 동작 시키라는 의미가 아니다.

	"준수"로 설정해 놓으면, daylight saving의 실제 동작은 
	stc내의 DS_status및 month, day 등의 값들로부터 자동으로 결정된다.

Note:		
*****************************************************************************/
void DMW_SetDayLightSaving(SysTimeContext *stc, BOOL dayLightSavingOn) 
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;

	stc->bDaylightSavingOn = dayLightSavingOn;

	/* daylight saving parameter는 변경하지 않는다. */
}

/****************************************************************************
Function Name:
	BOOLEAN DMW_GetDayLightSaving(void) 

Description:
	Day Light Saving 준수 여부 읽음.
	주의: 실제로 daylight saving 이 동작하고 있는지의 여부가 아니다.

Note:		
*****************************************************************************/
BOOL DMW_GetDayLightSaving(SysTimeContext *stc) 
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	return stc->bDaylightSavingOn;
}

/****************************************************************************
Function Name:
	DMW_SetDayLightSavingParam() / DMW_GetDayLightSavingParam()

Description:
	Day Light Saving parameter 설정 및 조회.
	DS_day_of_month 및 DS_hour parameter를 같이 사용.

Note:		
*****************************************************************************/

void DMW_SetDayLightSavingParam(SysTimeContext *stc, int status, int day, int hour) 
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;

	stc->DS_status = status;
	stc->DS_day_of_month = day;
	stc->DS_hour = hour;
}


void DMW_GetDayLightSavingParam(SysTimeContext *stc, int *pStatus, int *pDay, int *pHour)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;

	if (pStatus) *pStatus = stc->DS_status;
	if (pDay)  *pDay  = stc->DS_day_of_month;
	if (pHour) *pHour = stc->DS_hour;
}

/****************************************************************************
Function Name:
	DMW_CheckDayLightSavingActive()

Description:
	DayLight Saving 이 현재 동작 중인지의 상태를 리턴.
	실제로 이 함수가 필요한 경우는 많지 않다. 
	사용자에게는 그냥 현재 시간만 보여주는 것으로 충분하다.

	주의:
	DMW_ConvertUTC2LocalTime() 실행시에 이 정보가 정확하게 결정된다.
	따라서 정확한 정보를 얻으려면 먼저 DMW_ConvertUTC2LocalTime()를 호출하고,
	바로 이어서 이 함수를 호출하면 된다.
	
Note:		
*****************************************************************************/

BOOL DMW_CheckDayLightSavingActive(SysTimeContext *stc)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	return stc->bDaylightSavingActive;
}

/****************************************************************************
Function Name:
	UINT8 DMW_GetGPS_UTC_offset(void) 

Description:
	GPS_UTC_offset 값을 리턴.

Note:		
*****************************************************************************/
int DMW_GetGPS_UTC_offset(SysTimeContext *stc)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	return stc->GPS_UTC_offset;
}

/****************************************************************************
Function Name:
	void DMW_SetGPS_UTC_offset(UINT8 offset) 

Description:
	GPS_UTC_offset 값을 설정함.

Note:		
*****************************************************************************/
void DMW_SetGPS_UTC_offset(SysTimeContext *stc, int offset)
{
	if (stc == NULL) stc = &g_DefaultSysTimeContext;
	
	stc->GPS_UTC_offset = offset;
}


/* cafrii 050725 add */

void DMW_InvalidateSysTime(SysTimeContext *stc)
{
	if (stc)
		stc->bTimebaseAdjusted = FALSE;
		
	/* 이후 GetUTCTime 과 같은 함수를 부르면 에러를 리턴할 것임.. */
}



#if COMMENT
____Util____(){}
#endif


/****************************************************************************
Function Name:
	STime_t DMW_ChangedTimeInfo(STime_t norm_time, int changed_sec )

Description:
	변화된 날짜/요일/시간 정보를 가져옮 

Note:	
	
*****************************************************************************/
void DMW_ChangedTimeInfo(STime_t *norm_time, int offset, STime_t *ret_time)
{	
	int utc;
	
	utc = DMW_ConvertLocalTime2UTC(NULL, norm_time);	
	DMW_ConvertUTC2LocalTime(NULL, utc + offset, ret_time);	
}

/****************************************************************************
Function Name:
	int DMW_GetTimeGap(STime_t start_time, STime_t end_time )

Description:
	두 시간정보의 차에 대해 초시간을 반환함

Note:	
	만약 end_time 이 start_time 보다 앞선 과거의 시간이라면,
	결과값이 음의 값이 될 수 있다.
	
	따라서 이 함수를 이용해서 두 시간중 어느 것이 더 미래/과거인지 체크할 수도 있다.
	
*****************************************************************************/
int DMW_GetTimeGap(STime_t *start_time, STime_t *end_time)
{	
	UINT32 utc1, utc2;
	
	utc1 = DMW_ConvertLocalTime2UTC(NULL, start_time);
	utc2 = DMW_ConvertLocalTime2UTC(NULL, end_time);

	return (INT32) (utc2 - utc1);
}






/*-------------------------------------------------------------------------------------*/



#if COMMENT
____Test____(){}
#endif

#if COMMENT

void TestPrintSysTimeContext(SysTimeContext *stc)
{
	if (stc == NULL) {
		stc = &g_DefaultSysTimeContext;
		dprint(2, "   [DefaultSysTimeContext] 0x%x\n", stc);
	}
	dprint(2, "   timebase %d\n", stc->nTimeSystemBase);
	dprint(2, "   timezone %+d, dst %d\n", stc->nTimeZone, stc->bDaylightSavingOn);
	dprint(2, "   GPS_UTC_offset %d\n", stc->GPS_UTC_offset);
	if (stc->bTimebaseAdjusted) 
	{
		UINT32 utc;
		utc = DHL_OS_GetMsCount()/1000 + stc->nTimeSystemBase;
		dprint(2, "   current utc: %d (0x%x)\n", utc, utc);
	}
	else
		dprint(2, "   !! time not initialized..\n");
}



/* 아래 테스트 함수들은 디폴트 타임 컨텍스트 상에서 동작함. */


void TestSetLocalTime(int year, int month, int day, int hour, int min, int sec)
{
	DMW_SetLocalTime2(NULL, year,  month,  day,  hour,  min,  sec);
}

void TestPrintCurTime()
{
	STime_t s;
	UINT32 utc;
	int err;

	err = DMW_GetLocalTime(NULL, &s);
	
	DMW_GetUTCTime(NULL, &utc);

	/*dprint(2, "%s %d/%d/%d %s %d:%02d:%02d [tz %+d] %s UTC 0x%x\n", err ? "!!err " : "", 
			s.year, s.month, s.day, DayOfWeakString(s.wday), s.hour, s.min, s.sec, 
			DMW_GetLocalTimeZone(NULL), DMW_GetDayLightSaving(NULL) ? "DS on" : "", utc);*/
}

void TestPrintLocalTime()
{
	TestPrintCurTime();
}


extern TSD *Dmc_GetCurrentTsd(void);

void TestTimeSync()
{
	sttSectionPtr_t sttSectPtr;
	int err;

	/* STT를 하나 다운로드 받아서 System time에 adjust한다.
	// 
	// 디폴트 컨텍스트에 적용한다. 제대로 하려면 컨텍스트를 하나 만드는게 좋겠다..
	//
	// 실제 Application에서는 STT에 discontinuity가 발견되면 이런 작업을 해줘야 할 것이다.
	//   1. 채널이 변경되었을 때 (채널마다 STT 시계의 오차가 있으므로..)
	//   2. 같은 채널인데 PsiLostPacket 같은 discontinuity로 추정되는 상황 발생시 (녹화 스트림을 재생한다든지.. )
	//   3. 그리고 잘 모르겠으면 주기적으로 이러한 기능을 해 주는게 좋다. (약 1분?)
	*/ 
	DMW_SetLocalTimeZone(NULL, 9); /* TimeZone은 부팅시 1회, 또는 사용자가 변경했을때 1회만 해도 된다. */

	err = GetSttSection((TSD *)Dmc_GetCurrentTsd(), &sttSectPtr, 1000*3);
	if (err) {
		dprint("TestTimeSync: no STT!!\n");
		return;
	}
	DMW_SetGPS_UTC_offset(NULL, sttSectPtr->GPS_UTC_offset);
	DMW_SetDayLightSaving(NULL, sttSectPtr->daylight_savings.DS_status);
	DMW_SetUTCTime(NULL, DMW_ConvertGPS2UTC(NULL, sttSectPtr->system_time));
	
	FreeAtscTable(sttSectPtr);

	/* 적용된 새 시간을 표시..	 */
	/* TestPrintLocalTime(); */
	TestPrintSysTimeContext(NULL);
}

/* 테스트 코드 예: 1초마다 현재 시간 표시
//
// 		DMW_SYS_SetTimer (7710, 1000, TestPrintCurTime, 0, 0)
//
// 테스트 코드 예: 10분에 한번씩 STT sync를 수행한다.
//
// 		DMW_SYS_SetTimer (7711, 10*60*1000, TestTimeSync, 0, 0)
*/

#endif /* 0 */






#if COMMENT
______DebugSymbol____(){}
#endif





#if DMW_REGISTER_DEBUG_SYMBOL

static DHL_SymbolTable SysTimeSymbols[] =
{
	/*---- functions */
	
	/*---- variables */
	//DHL_VAR_SYM_ENTRY(g_Trace_bSysTimeDebug),
	0,
};

#endif /* DMW_REGISTER_DEBUG_SYMBOL */


void DMW_RegisterSysTimeSymbols()
{
#if DMW_REGISTER_DEBUG_SYMBOL
	DHL_DBG_RegisterSymbols(SysTimeSymbols, DHL_NUMSYMBOLS(SysTimeSymbols));
	
#endif
}






/* Revision History ///////////////////////////////////////////////////////// 

	2.07 2005/3/15 GetUtcTime 에서 timebaseAdjust 되지도 않은 상태일 경우
	                 디폴트 time 값을 이용하여 utc 근사치를 리턴
	               ConvertLocalTime2UTC 에서 acc_day의 시작값이 -5라서 utc = 0일 경우와 같은
	                 에러 상황에서 요일 변환이 잘 안되는 문제 수정
	
	2.06           DMW_SYS_XXX Standard 호환 API는 모두 삭제.. 더이상 지원하지 않음.

	2.05 2004/12/20 cafrii DMW_SYS_GetCurUtcTime 추가 (PodIf 에서 사용)
	2.04 2004/11/02 cafrii DMW_SYS_GetTimeFromGPS 버그 수정
	2.03 2004/10/5 cafrii DMW_ConvertLocalTime2UTC 에서 음의 timezone 고려안한 버그
	2.02 2004/6/17 cafrii DMW_ConvertGPS2UTC: prevent negative utc 
	                      DMW_SYS_GetTimeFromGPS 추가 구현
	2.01 2004/6/15 cafrii 전체 구조 정리, DMW_Timer.c 에 있던 StdAPI를 이곳에 포팅 정리..
	
	ver 2.000 -	Date  :	2003/10/21
				WHO	  : Hyunsik Chang
				To Do :	Timer 삭제 필요. 여기는 시계만 있도록!

	ver 1.001 -	Date  :	2003/09/15
				WHO	  : K.H. Park
				To Do :	UTC Time 관련 추가 
				
	ver 1.000 -	Date  :	2003/08/18
				WHO	  : K.H. Park
				To Do :	시스템 시간관련 함수 및 시간경과 측정 함수 구현

////////////////////////////////////////////////////////////////////////// */