/**************************************************************************** * NAME: DMW_SysTime.h *---------------------------------------------------------------------------- * 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: * - Set System Time and Get System Time *****************************************************************************/ #ifndef __DMW_SYSTIME_H #define __DMW_SYSTIME_H /* //////////////////////////////////////////////////////////////////////////// */ #include "DMW_Platform.h" /*_____ I N C L U D E S ____________________________________________________*/ /* #define SYSTIME_DEBUG 1 */ /* DMW_SysTime debugging. */ #ifdef __cplusplus extern "C"{ #endif /*_____ T Y P E _ D E F I N I T I O N ______________________________________*/ typedef struct { BOOL bTimebaseAdjusted; int nTimeSystemBase; /* offset between UTC time and ANSI time() function result */ /* UTC <--> LocalTime conversion parameters */ int nTimeZone; /* -12 ~ +12 */ BOOL bDaylightSavingOn; /* 1: use day light saving , 0: not use day light saving */ /* 이 boolean 변수는 daylight saving의 "준수(observe)" 여부이다. 이 파라미터는 사용자 선택에 의해 설정된다. "동작" 여부를 지시하는 DS_status 와는 혼돈하면 안된다. 또한 현재의 "적용 상태"를 알려주는 bDaylightSavingActive 와도 구분해야 한다. */ /* UTC, GPS offset parameter */ int GPS_UTC_offset; /*------------------------------------------------------------*/ /* belows are statistics variable, not parameters set by user */ UINT32 tickTimeAdjusted; /* only used when DONT_USE_C_STD_LIB option enabled. system time tick (got by OS_GetTickCount()) when last timebase adjusted. */ BOOL bDaylightSavingActive; /* 1 if daylight saving is active now. */ /* 현재 daylight saving 구간에 들어가 있는지를 알려준다. LocalTime 변환 함수를 호출 해야 이 정보가 update 된다. */ /* below fields have exactly same usage in PSIP stt or SCTE stt. */ UINT8 DS_status; /* 1 if DS_day_of_month and DS_hour is valid. */ UINT8 DS_day_of_month; /* 1~31. 0 if automatic DST in/out correction */ UINT8 DS_hour; /* 0~23. usually 2 in United States. */ /* 이 값들은 stt section 정보로부터 가져온다. */ } SysTimeContext; /* 보통 Application은 두개의 SysTime context를 유지/관리 해야 한다. 하나는 manual time context이고, 하나는 STT에 의해 동기화 되는 time context이다. 실제로 사용자가 어떤 것을 사용하던지 간에, EPG를 표시하기 위해 사용되는 기준 시간은 STT time context이다. */ /* typedef struct timespec timespec_t; */ typedef struct { int year; /* xxxx (ex. 2003) */ int month; /* 1-12 */ int day; /* 0-31 */ int wday; /* Day of Week -> 0: Sunday, 1: Monday, ... */ int hour; /* 0-24 */ int min; /* 0-59 */ int sec; /* 0-59 */ } STime_t; /* Struct for Getting & Saving Date/Time Info. */ /*_____ D E C L A R A T I O N ______________________________________________*/ void DMW_SetUTCTime(SysTimeContext *stc, UINT32 utc); STATUS DMW_GetUTCTime(SysTimeContext *stc, UINT32 *utc); UINT32 DMW_ConvertLocalTime2UTC(SysTimeContext *stc, STime_t *system_time); void DMW_ConvertUTC2LocalTime(SysTimeContext *stc, UINT32 utc, STime_t *t); void DMW_SetLocalTime(SysTimeContext *stc, STime_t *t); void DMW_SetLocalTime2(SysTimeContext *stc, int year, int month, int day, int hour, int min, int sec); int DMW_GetLocalTime(SysTimeContext *stc, STime_t *sys_time); void DMW_SetLocalTimeZone(SysTimeContext *stc, int time_zone); int DMW_GetLocalTimeZone(SysTimeContext *stc); /* daylight saving 준수 여부를 설정/조회 한다. daylight saving param은 건드리지 않음. */ void DMW_SetDayLightSaving(SysTimeContext *stc, BOOL dayLightSavingOn); BOOL DMW_GetDayLightSaving(SysTimeContext *stc); /* daylight saving parameter만 설정/조회 한다. daylight saving 준수 여부는 관련 없음. */ void DMW_SetDayLightSavingParam(SysTimeContext *stc, int status, int day, int hour); void DMW_GetDayLightSavingParam(SysTimeContext *stc, int *pStatus, int *pDay, int *pHour); /* 기존의 코드들과의 backward compatibility 기존 코드들은 이 함수를 부르면 parameter 설정과 함께 준수 여부도 같이 설정을 했다. */ #define DMW_SetDayLightSaving2(stc, status, day, hour) \ do { \ DMW_SetDayLightSavingParam(stc, status, day, hour); \ DMW_SetDayLightSaving(stc, TRUE); \ } while(0) /* 현재 stc의 시간이 daylight saving 구간에 들어가 있는지를 알려준다. */ BOOL DMW_CheckDayLightSavingActive(SysTimeContext *stc); int DMW_GetGPS_UTC_offset(SysTimeContext *stc); void DMW_SetGPS_UTC_offset(SysTimeContext *stc, int offset); UINT32 DMW_ConvertUTC2GPS(SysTimeContext *stc, UINT32 UTC); UINT32 DMW_ConvertGPS2UTC(SysTimeContext *stc, UINT32 GPS); void DMW_InvalidateSysTime(SysTimeContext *stc); /* cafrii 050725 add */ void DMW_ChangedTimeInfo(STime_t *norm_time, int offset, STime_t *ret_time); int DMW_GetTimeGap(STime_t *start_time, STime_t *end_time); /* --------------------------------------------------------------------------------- debugging util.. */ extern const char *DayOfWeekString(int n); /* Sun, Mon.. 등의 문자열 리턴.. 0 ~ 6 */ extern const char *STimeString(STime_t *s, char *buf); /* many codes uses wrong spelling. so, keep compatibility */ #define DayOfWeakString(n) DayOfWeekString(n) void DMW_RegisterSysTimeSymbols(void); #ifdef __cplusplus } #endif /*=========================================================================== */ #endif /* __DMW_SYSTIME_H */ /* Revision History ///////////////////////////////////////////////////////// 2005/3/15 Standard API, 관련 structure 모두 삭제 DMW_TIME_T 도 삭제되었음. App 계층에서 추가 요망.. 2004/12/20 cafrii, DMW_SYS_GetCurUtcTime 추가 ver 1.001 - Date : 2003/09/15 WHO : K.H. Park To Do : Added UTC time related functions ////////////////////////////////////////////////////////////////////////// */