Go to the documentation of this file.
38 #include "drv_digital_out.h"
39 #include "drv_digital_in.h"
40 #include "drv_i2c_master.h"
52 #define RTC8_MAP_MIKROBUS( cfg, mikrobus ) \
53 cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
54 cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
55 cfg.evi = MIKROBUS( mikrobus, MIKROBUS_CS ); \
56 cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
63 #define RTC8_RETVAL uint8_t
66 #define RTC8_INIT_ERROR 0xFF
73 #define RTC8_REG_SECONDS 0x00
74 #define RTC8_REG_MINUTES 0x01
75 #define RTC8_REG_HOURS 0x02
76 #define RTC8_REG_WEEKDAY 0x03
77 #define RTC8_REG_DATE 0x04
78 #define RTC8_REG_MONTH 0x05
79 #define RTC8_REG_YEAR 0x06
80 #define RTC8_REG_MINUTES_ALARM 0x07
81 #define RTC8_REG_HOURS_ALARM 0x08
82 #define RTC8_REG_WEEKDAY_ALARM 0x09
83 #define RTC8_REG_TIMER_VALUE_0 0x0A
84 #define RTC8_REG_TIMER_VALUE_1 0x0B
85 #define RTC8_REG_TIMER_STATUS_0 0x0C
86 #define RTC8_REG_TIMER_STATUS_1 0x0D
87 #define RTC8_REG_STATUS 0x0E
88 #define RTC8_REG_CONTROL1 0x0F
89 #define RTC8_REG_CONTROL2 0x10
90 #define RTC8_REG_GP_BITS 0x11
91 #define RTC8_REG_CLOCK_INT_MASK 0x12
92 #define RTC8_REG_EVENT_CONTROL 0x13
93 #define RTC8_REG_COUNT_TS 0x14
94 #define RTC8_REG_SECONDS_TS 0x15
95 #define RTC8_REG_MINUTES_TS 0x16
96 #define RTC8_REG_HOURS_TS 0x17
97 #define RTC8_REG_DATE_TS 0x18
98 #define RTC8_REG_MONTH_TS 0x19
99 #define RTC8_REG_YEAR_TS 0x1A
100 #define RTC8_REG_UNIX0 0x1B
101 #define RTC8_REG_UNIX1 0x1C
102 #define RTC8_REG_UNIX2 0x1D
103 #define RTC8_REG_UNIX3 0x1E
104 #define RTC8_REG_USER_RAM_1 0x1F
105 #define RTC8_REG_USER_RAM_2 0x20
106 #define RTC8_REG_PASSWORD_0 0x21
107 #define RTC8_REG_PASSWORD_1 0x22
108 #define RTC8_REG_PASSWORD_2 0x23
109 #define RTC8_REG_PASSWORD_3 0x24
110 #define RTC8_REG_EEPROM_ADDRESS 0x25
111 #define RTC8_REG_EEPROM_DATA 0x26
112 #define RTC8_REG_EEPROM_COM 0x27
113 #define RTC8_REG_ID 0x28
114 #define RTC8_REG_EEPROM_BACKUP 0x37
121 #define RTC8_STATUS_EEPROM_BUSY 0x80
122 #define RTC8_STATUS_CLOCK_INT_FLAG 0x40
123 #define RTC8_STATUS_BACKUP_SWITCH_FLAG 0x20
124 #define RTC8_STATUS_UPDATE_FLAG 0x10
125 #define RTC8_STATUS_TIMER_FLAG 0x08
126 #define RTC8_STATUS_ALARM_FLAG 0x04
127 #define RTC8_STATUS_EVENT_FLAG 0x02
128 #define RTC8_STATUS_POR_FLAG 0x01
129 #define RTC8_STATUS_REG_CLEAR 0x00
136 #define RTC8_CTRL1_TRPT_SINGLE_MODE 0x00
137 #define RTC8_CTRL1_TRPT_REPEAT_MODE 0x80
138 #define RTC8_CTRL1_WADA_WEEKDAY_ALARM 0x00
139 #define RTC8_CTRL1_WADA_DATE_ALARM 0x20
140 #define RTC8_CTRL1_USEL_SECOND_UPDATE 0x00
141 #define RTC8_CTRL1_USEL_MINUTE_UPDATE 0x10
142 #define RTC8_CTRL1_EERD_REFRESH_ACTIVE 0x00
143 #define RTC8_CTRL1_EERD_REFRESH_NO_ACTIVE 0x08
144 #define RTC8_CTRL1_TE_TIMER_STOPS 0x00
145 #define RTC8_CTRL1_TE_TIMER_STARTS 0x04
146 #define RTC8_CTRL1_TD_TIMER_CLK_4096Hz 0x00
147 #define RTC8_CTRL1_TD_TIMER_CLK_64Hz 0x01
148 #define RTC8_CTRL1_TD_TIMER_CLK_1Hz 0x02
149 #define RTC8_CTRL1_TD_TIMER_CLK_1_60Hz 0x03
156 #define RTC8_CTRL2_TIME_STAMP_DISABLE 0x00
157 #define RTC8_CTRL2_TIME_STAMP_ENABLE 0x80
158 #define RTC8_CTRL2_INT_CLOCK_DISABLE 0x00
159 #define RTC8_CTRL2_INT_CLOCK_ENABLE 0x40
160 #define RTC8_CTRL2_TIME_UPDATE_INTERRUPT 0x20
161 #define RTC8_CTRL2_TIME_UPDATE_NO_INTERRUPT 0x00
162 #define RTC8_CTRL2_TIMER_INTERRUPT 0x10
163 #define RTC8_CTRL2_TIMER_NO_INTERRUPT 0x00
164 #define RTC8_CTRL2_ALARM_INTERRUPT 0x08
165 #define RTC8_CTRL2_ALARM_NO_INTERRUPT 0x00
166 #define RTC8_CTRL2_EVENT_INTERRUPT 0x04
167 #define RTC8_CTRL2_EVENT_NO_INTERRUPT 0x00
168 #define RTC8_CTRL2_HOUR_MODE_12 0x02
169 #define RTC8_CTRL2_HOUR_MODE_24 0x00
170 #define RTC8_CTRL2_RESET_ACTIVE 0x01
171 #define RTC8_CTRL2_NO_RESET 0x00
178 #define RTC8_CLKIM_EVENT_INT_ENABLE 0x08
179 #define RTC8_CLKIM_EVENT_INT_DISABLE 0x00
180 #define RTC8_CLKIM_ALARM_INT_ENABLE 0x04
181 #define RTC8_CLKIM_ALARM_INT_DISABLE 0x00
182 #define RTC8_CLKIM_TIMER_INT_ENABLE 0x02
183 #define RTC8_CLKIM_TIMER_INT_DISABLE 0x00
184 #define RTC8_CLKIM_TIME_UPDATE_INT_ENABLE 0x01
185 #define RTC8_CLKIM_TIME_UPDATE_INT_DISABLE 0x00
192 #define RTC8_EC_EVENT_LOW_LEVEL 0x00
193 #define RTC8_EC_EVENT_HIGH_LEVEL 0x40
194 #define RTC8_EC_EVENT_PERIOD_256Hz 0x10
195 #define RTC8_EC_EVENT_PERIOD_64Hz 0x20
196 #define RTC8_EC_EVENT_PERIOD_8Hz 0x30
197 #define RTC8_EC_EVENT_NO_FILTERING 0x00
198 #define RTC8_EC_TIME_STAMP_RESET_ENABLE 0x04
199 #define RTC8_EC_TIME_STAMP_RESET_DISABLE 0x00
200 #define RTC8_EC_TSOW_EVF_CLEARED 0x00
201 #define RTC8_EC_TSOW_EVF_NO_CLEARED 0x02
202 #define RTC8_EC_TSS_TSE_ON_EVI 0x00
203 #define RTC8_EC_TSS_TSE_ON_VBACKUP 0x01
210 #define RTC8_EECMD_WRITE_ALL_EEPROM_REG 0x11
211 #define RTC8_EECMD_READ_ALL_EEPROM_REG 0x12
212 #define RTC8_EECMD_WRITE_ONE_EEPROM_REG 0x21
213 #define RTC8_EECMD_READ_ONE_EEPROM_REG 0x22
220 #define RTC8_ALARM_IS_ACTIVE 0x01
221 #define RTC8_ALARM_NO_ACTIVE 0x00
pin_name_t evi
Definition: rtc8.h:266
uint8_t rtc8_set_time(rtc8_t *ctx, rtc8_time_t *time_s)
Set new time - 24 hour format.
uint8_t hours
Definition: rtc8.h:281
uint8_t weekdays
Definition: rtc8.h:295
uint8_t i2c_address
Definition: rtc8.h:272
void rtc8_generic_read(rtc8_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic read function.
uint8_t year
Definition: rtc8.h:294
uint8_t hours
Definition: rtc8.h:305
uint8_t rtc8_get_interrupt_state(rtc8_t *ctx)
Get interrupt state.
Time structure definition.
Definition: rtc8.h:279
void rtc8_default_cfg(rtc8_t *ctx)
Click Default Configuration function.
Click configuration structure definition.
Definition: rtc8.h:257
void rtc8_reset_alarm_flag(rtc8_t *ctx)
Reset alarm.
uint32_t i2c_speed
Definition: rtc8.h:271
uint8_t rtc8_set_date(rtc8_t *ctx, rtc8_date_t *date_s)
Set new date.
uint8_t minutes
Definition: rtc8.h:282
uint8_t minutes
Definition: rtc8.h:306
uint8_t rtc8_get_status(rtc8_t *ctx)
Get status.
uint8_t weekdays
Definition: rtc8.h:304
uint8_t rtc8_set_alarm(rtc8_t *ctx, rtc8_alarm_t *alarm_s)
Set Alarm.
pin_name_t scl
Definition: rtc8.h:261
uint8_t seconds
Definition: rtc8.h:283
#define RTC8_RETVAL
Definition: rtc8.h:63
void rtc8_set_external_event_input(rtc8_t *ctx, uint8_t state)
Set EVI(External Event Input) pin.
Date structure definition.
Definition: rtc8.h:290
void rtx8_get_time_and_date(rtc8_t *ctx, rtc8_time_t *time_s, rtc8_date_t *date_s)
Get RTC data ( Time and Data )
uint8_t rtc8_get_alarm_flag(rtc8_t *ctx)
Get Alarm flag.
void rtc8_set_unix_time(rtc8_t *ctx, int32_t unix_time)
Set UNIX time.
uint32_t rtc8_get_uinx_time(rtc8_t *ctx)
Get current UNIX time.
RTC8_RETVAL rtc8_init(rtc8_t *ctx, rtc8_cfg_t *cfg)
Initialization function.
Alarm structure definition.
Definition: rtc8.h:302
uint8_t slave_address
Definition: rtc8.h:250
pin_name_t sda
Definition: rtc8.h:262
pin_name_t int_pin
Definition: rtc8.h:267
uint8_t rtc8_write_data_bcd_format(rtc8_t *ctx, uint8_t reg, uint8_t _data)
Write data ( Convert and send data in BCD format )
uint8_t rtc8_read_data_bcd_format(rtc8_t *ctx, uint8_t reg)
Read one byte data from register in DEC format.
uint8_t day
Definition: rtc8.h:292
uint8_t month
Definition: rtc8.h:293
digital_in_t int_pin
Definition: rtc8.h:242
digital_out_t evi
Definition: rtc8.h:238
void rtc8_cfg_setup(rtc8_cfg_t *cfg)
Config Object Initialization function.
Click ctx object definition.
Definition: rtc8.h:234
i2c_master_t i2c
Definition: rtc8.h:246
void rtc8_generic_write(rtc8_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic write function.