128 lines
3.8 KiB
C
128 lines
3.8 KiB
C
#ifndef DCFTIME_H
|
|
#define DCFTIME_H
|
|
|
|
/**
|
|
* \file dcftime.h
|
|
* \brief Decoder for DCF-77 time signals
|
|
* \author Ronald Schaten & Thomas Stegemann
|
|
* \version $Id: dcftime.h,v 1.1 2007/01/02 21:30:40 rschaten Exp $
|
|
*
|
|
* License: See documentation.
|
|
*/
|
|
|
|
#include "boole.h"
|
|
|
|
/*
|
|
dcf-signal samples per second
|
|
*/
|
|
#ifndef DCF_RATE
|
|
#define DCF_RATE 244 /**< number of samples per second. dcf_signal() should be called this often */
|
|
#endif
|
|
#if (DCF_RATE < 100) || (250 < DCF_RATE)
|
|
#error DCF_RATE should be between 100 and 250
|
|
#endif
|
|
|
|
typedef unsigned int dcf_second; /**< seconds (0-59) */
|
|
typedef unsigned int dcf_minute; /**< minutes (0-59) */
|
|
typedef unsigned int dcf_hour; /**< hours (0-24) */
|
|
typedef unsigned int dcf_dayofmonth; /**< day of month (1-31) */
|
|
typedef unsigned int dcf_year; /**< year (0-99) */
|
|
typedef boolean dcf_is_dst; /**< daylight saving: True: MESZ, False: MEZ */
|
|
|
|
/** definition of weekdays */
|
|
enum dcf_dayofweek_enum {
|
|
dcf_monday = 1, /**< monday = 1 */
|
|
dcf_tuesday, /**< tuesday */
|
|
dcf_wednesday, /**< wednesday */
|
|
dcf_thursday, /**< thursday */
|
|
dcf_friday, /**< friday */
|
|
dcf_saturday, /**< saturday */
|
|
dcf_sunday, /**< sunday = 7 */
|
|
};
|
|
/** definition of weekdays */
|
|
typedef enum dcf_dayofweek_enum dcf_dayofweek;
|
|
|
|
/** definition of months */
|
|
enum dcf_month_enum {
|
|
dcf_january = 1, /**< january = 1 */
|
|
dcf_february, /**< february */
|
|
dcf_march, /**< march */
|
|
dcf_april, /**< april */
|
|
dcf_may, /**< may */
|
|
dcf_june, /**< june */
|
|
dcf_july, /**< july */
|
|
dcf_august, /**< august */
|
|
dcf_september, /**< september */
|
|
dcf_october, /**< october */
|
|
dcf_november, /**< november */
|
|
dcf_december /**< december = 12 */
|
|
};
|
|
/** definition of months */
|
|
typedef enum dcf_month_enum dcf_month;
|
|
|
|
/** format of the dcf_time */
|
|
struct dcf_time_struct {
|
|
dcf_second second; /**< seconds */
|
|
dcf_minute minute; /**< minutes */
|
|
dcf_hour hour; /**< hours */
|
|
dcf_is_dst is_dst; /**< daylight saving time */
|
|
};
|
|
/** definition of dcf_time */
|
|
typedef struct dcf_time_struct dcf_time;
|
|
|
|
/** format of the dcf_date */
|
|
struct dcf_date_struct {
|
|
dcf_dayofweek dayofweek; /**< day of week */
|
|
dcf_dayofmonth dayofmonth; /**< day of month */
|
|
dcf_month month; /**< month */
|
|
dcf_year year; /**< year */
|
|
};
|
|
/** definition of dcf_date */
|
|
typedef struct dcf_date_struct dcf_date;
|
|
|
|
/** format of the dcf_datetime */
|
|
struct dcf_datetime_struct {
|
|
dcf_time time; /**< the time */
|
|
dcf_date date; /**< the time */
|
|
boolean is_valid; /**< if is_valid is False: no complete signal received, do not use date and times */
|
|
boolean has_signal; /**< if has_signal is True: currently receiving signal */
|
|
};
|
|
/** definition of dcf_datetime */
|
|
typedef struct dcf_datetime_struct dcf_datetime;
|
|
|
|
/**
|
|
* Initialize the DCF-module. Call dcf_init before any other DCF function.
|
|
*/
|
|
void dcf_init(void);
|
|
|
|
/**
|
|
* Tell the DCF-module if the signal is high or low. This function decides if
|
|
* the received bit is a long or a short one, and if it is usable at all. It
|
|
* should be called regularly, the number of calls per second is defined in
|
|
* DCF_RATE.
|
|
* \param signal: True if the input signal is high, False if it is low.
|
|
*/
|
|
void dcf_signal(boolean signal);
|
|
|
|
/**
|
|
* Fetch the current date and time.
|
|
* \return The current date and time in a dcf_datetime structure
|
|
*/
|
|
dcf_datetime dcf_current_datetime(void);
|
|
|
|
/**
|
|
* Get the name of the current weekday.
|
|
* \param dow: Day of the current week. Monday = 1, tuesday = 2...
|
|
* \return Pointer to the name
|
|
*/
|
|
const char* dcf_dayofweek_name(dcf_dayofweek dow);
|
|
|
|
/**
|
|
* Get the name of the current daylight saving time (summertime, wintertime).
|
|
* \param dst: daylight saving time bit from the time signal
|
|
* \return Pointer to the name
|
|
*/
|
|
const char* dcf_is_dst_name(dcf_is_dst dst);
|
|
|
|
#endif
|