2021-02-03 14:20:31 +00:00
|
|
|
/******************************************************************************
|
|
|
|
RV-3028-C7.hpp
|
|
|
|
bBased on the RV-3028-C7 Arduino Library by Constantin Koch, July 25, 2019
|
|
|
|
https://github.com/constiko/RV-3028_C7-Arduino_Library
|
|
|
|
|
|
|
|
This code is released under the [MIT License](http://opensource.org/licenses/MIT).
|
|
|
|
Please review the LICENSE file included with this example.
|
|
|
|
Distributed as-is; no warranty is given.
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include "hardware/i2c.h"
|
|
|
|
#include "hardware/gpio.h"
|
2021-05-14 17:12:37 +00:00
|
|
|
#include "common/pimoroni_common.hpp"
|
|
|
|
#include "common/pimoroni_i2c.hpp"
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <math.h>
|
|
|
|
#include "pico/stdlib.h"
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// The 7-bit I2C ADDRESS of the RV3028
|
|
|
|
#define RV3028_ADDR 0x52
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// REGISTERS
|
|
|
|
// Clock registers
|
2021-02-03 14:20:31 +00:00
|
|
|
#define RV3028_SECONDS 0x00
|
|
|
|
#define RV3028_MINUTES 0x01
|
|
|
|
#define RV3028_HOURS 0x02
|
2021-05-10 14:57:56 +00:00
|
|
|
// Calendar registers
|
|
|
|
#define RV3028_WEEKDAY 0x03
|
2021-02-03 14:20:31 +00:00
|
|
|
#define RV3028_DATE 0x04
|
|
|
|
#define RV3028_MONTHS 0x05
|
|
|
|
#define RV3028_YEARS 0x06
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Alarm registers
|
2021-02-03 14:20:31 +00:00
|
|
|
#define RV3028_MINUTES_ALM 0x07
|
|
|
|
#define RV3028_HOURS_ALM 0x08
|
|
|
|
#define RV3028_DATE_ALM 0x09
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Periodic Countdown Timer registers
|
|
|
|
#define RV3028_TIMERVAL_0 0x0A
|
|
|
|
#define RV3028_TIMERVAL_1 0x0B
|
|
|
|
#define RV3028_TIMERSTAT_0 0x0C
|
|
|
|
#define RV3028_TIMERSTAT_1 0x0D
|
2021-02-03 14:20:31 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Configuration registers
|
|
|
|
#define RV3028_STATUS 0x0E
|
2021-02-03 14:20:31 +00:00
|
|
|
#define RV3028_CTRL1 0x0F
|
|
|
|
#define RV3028_CTRL2 0x10
|
2021-05-10 14:57:56 +00:00
|
|
|
#define RV3028_GPBITS 0x11
|
|
|
|
#define RV3028_INT_MASK 0x12
|
|
|
|
|
|
|
|
// Eventcontrol/Timestamp registers
|
|
|
|
#define RV3028_EVENTCTRL 0x13
|
|
|
|
#define RV3028_COUNT_TS 0x14
|
|
|
|
#define RV3028_SECONDS_TS 0x15
|
|
|
|
#define RV3028_MINUTES_TS 0x16
|
|
|
|
#define RV3028_HOURS_TS 0x17
|
|
|
|
#define RV3028_DATE_TS 0x18
|
|
|
|
#define RV3028_MONTH_TS 0x19
|
|
|
|
#define RV3028_YEAR_TS 0x1A
|
|
|
|
|
|
|
|
// Unix Time registers
|
|
|
|
#define RV3028_UNIX_TIME0 0x1B
|
|
|
|
#define RV3028_UNIX_TIME1 0x1C
|
|
|
|
#define RV3028_UNIX_TIME2 0x1D
|
|
|
|
#define RV3028_UNIX_TIME3 0x1E
|
|
|
|
|
|
|
|
// RAM registers
|
|
|
|
#define RV3028_USER_RAM1 0x1F
|
|
|
|
#define RV3028_USER_RAM2 0x20
|
|
|
|
|
|
|
|
// Password registers
|
|
|
|
#define RV3028_PASSWORD0 0x21
|
|
|
|
#define RV3028_PASSWORD1 0x22
|
|
|
|
#define RV3028_PASSWORD2 0x23
|
|
|
|
#define RV3028_PASSWORD3 0x24
|
|
|
|
|
|
|
|
// EEPROM Memory Control registers
|
|
|
|
#define RV3028_EEPROM_ADDR 0x25
|
|
|
|
#define RV3028_EEPROM_DATA 0x26
|
|
|
|
#define RV3028_EEPROM_CMD 0x27
|
|
|
|
|
|
|
|
// ID register
|
|
|
|
#define RV3028_ID 0x28
|
|
|
|
#define RV3028_CHIP_ID 0x30
|
|
|
|
#define RV3028_VERSION 0x03
|
|
|
|
|
|
|
|
// EEPROM Registers
|
|
|
|
#define EEPROM_Clkout_Register 0x35
|
|
|
|
#define RV3028_EEOffset_8_1 0x36 // bits 8 to 1 of EEOffset. Bit 0 is bit 7 of register 0x37
|
|
|
|
#define EEPROM_Backup_Register 0x37
|
|
|
|
|
|
|
|
|
|
|
|
// BITS IN IMPORTANT REGISTERS
|
|
|
|
|
|
|
|
// Bits in Status Register
|
|
|
|
#define STATUS_EEBUSY 7
|
|
|
|
#define STATUS_CLKF 6
|
2021-02-03 14:20:31 +00:00
|
|
|
#define STATUS_BSF 5
|
2021-05-10 14:57:56 +00:00
|
|
|
#define STATUS_UF 4
|
|
|
|
#define STATUS_TF 3
|
|
|
|
#define STATUS_AF 2
|
2021-02-03 14:20:31 +00:00
|
|
|
#define STATUS_EVF 1
|
2021-05-10 14:57:56 +00:00
|
|
|
#define STATUS_PORF 0
|
2021-02-03 14:20:31 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Bits in Control1 Register
|
2021-02-03 14:20:31 +00:00
|
|
|
#define CTRL1_TRPT 7
|
2021-05-10 14:57:56 +00:00
|
|
|
#define CTRL1_WADA 5 // Bit 6 not implemented
|
2021-02-03 14:20:31 +00:00
|
|
|
#define CTRL1_USEL 4
|
|
|
|
#define CTRL1_EERD 3
|
2021-05-10 14:57:56 +00:00
|
|
|
#define CTRL1_TE 2
|
|
|
|
#define CTRL1_TD1 1
|
|
|
|
#define CTRL1_TD0 0
|
|
|
|
|
|
|
|
// Bits in Control2 Register
|
|
|
|
#define CTRL2_TSE 7
|
|
|
|
#define CTRL2_CLKIE 6
|
|
|
|
#define CTRL2_UIE 5
|
|
|
|
#define CTRL2_TIE 4
|
|
|
|
#define CTRL2_AIE 3
|
|
|
|
#define CTRL2_EIE 2
|
|
|
|
#define CTRL2_12_24 1
|
|
|
|
#define CTRL2_RESET 0
|
|
|
|
|
|
|
|
// Bits in Hours register
|
|
|
|
#define HOURS_AM_PM 5
|
|
|
|
|
|
|
|
// Bits in Alarm registers
|
|
|
|
#define MINUTESALM_AE_M 7
|
|
|
|
#define HOURSALM_AE_H 7
|
2021-02-03 14:20:31 +00:00
|
|
|
#define DATE_AE_WD 7
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Commands for EEPROM Command Register (0x27)
|
|
|
|
#define EEPROMCMD_First 0x00
|
|
|
|
#define EEPROMCMD_Update 0x11
|
2021-02-03 14:20:31 +00:00
|
|
|
#define EEPROMCMD_Refresh 0x12
|
2021-05-10 14:57:56 +00:00
|
|
|
#define EEPROMCMD_WriteSingle 0x21
|
|
|
|
#define EEPROMCMD_ReadSingle 0x22
|
2021-02-03 14:20:31 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// Bits in EEPROM Backup Register
|
|
|
|
#define EEPROMBackup_TCE_BIT 5 // Trickle Charge Enable Bit
|
|
|
|
#define EEPROMBackup_FEDE_BIT 4 // Fast Edge Detection Enable Bit (for Backup Switchover Mode)
|
|
|
|
#define EEPROMBackup_BSM_SHIFT 2 // Backup Switchover Mode shift
|
|
|
|
#define EEPROMBackup_TCR_SHIFT 0 // Trickle Charge Resistor shift
|
2021-02-03 14:20:31 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
#define EEPROMBackup_BSM_CLEAR 0b11110011 // Backup Switchover Mode clear
|
|
|
|
#define EEPROMBackup_TCR_CLEAR 0b11111100 // Trickle Charge Resistor clear
|
|
|
|
#define TCR_3K 0b00 // Trickle Charge Resistor 3kOhm
|
|
|
|
#define TCR_5K 0b01 // Trickle Charge Resistor 5kOhm
|
|
|
|
#define TCR_9K 0b10 // Trickle Charge Resistor 9kOhm
|
|
|
|
#define TCR_15K 0b11 // Trickle Charge Resistor 15kOhm
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
// Clock output register (0x35)
|
2021-05-10 14:57:56 +00:00
|
|
|
#define EEPROMClkout_CLKOE_BIT 7 // 1 = CLKOUT pin is enabled. – Default value on delivery
|
|
|
|
#define EEPROMClkout_CLKSY_BIT 6
|
2021-02-03 14:20:31 +00:00
|
|
|
// Bits 5 and 4 not implemented
|
2021-05-10 14:57:56 +00:00
|
|
|
#define EEPROMClkout_PORIE 3 // 0 = No interrupt, or canceled, signal on INT pin at POR. – Default value on delivery
|
|
|
|
// 1 = An interrupt signal on INT pin at POR. Retained until the PORF flag is cleared to 0 (no automatic cancellation).
|
|
|
|
#define EEPROMClkout_FREQ_SHIFT 0 // frequency shift
|
|
|
|
#define FD_CLKOUT_32k 0b000 // 32.768 kHz – Default value on delivery
|
|
|
|
#define FD_CLKOUT_8192 0b001 // 8192 Hz
|
|
|
|
#define FD_CLKOUT_1024 0b010 // 1024 Hz
|
|
|
|
#define FD_CLKOUT_64 0b011 // 64 Hz
|
|
|
|
#define FD_CLKOUT_32 0b100 // 32 Hz
|
|
|
|
#define FD_CLKOUT_1 0b101 // 1 Hz
|
|
|
|
#define FD_CLKOUT_TIMER 0b110 // Predefined periodic countdown timer interrupt
|
|
|
|
#define FD_CLKOUT_LOW 0b111 // CLKOUT = LOW
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
#define IMT_MASK_CEIE 3 // Clock output when Event Interrupt bit.
|
|
|
|
#define IMT_MASK_CAIE 2 // Clock output when Alarm Interrupt bit.
|
|
|
|
#define IMT_MASK_CTIE 1 // Clock output when Periodic Countdown Timer Interrupt bit.
|
|
|
|
#define IMT_MASK_CUIE 0 // Clock output when Periodic Time Update Interrupt bit.
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
#define TIME_ARRAY_LENGTH 7 // Total number of writable values in device
|
|
|
|
|
|
|
|
namespace pimoroni {
|
|
|
|
|
|
|
|
enum time_order {
|
2021-05-10 05:23:34 +00:00
|
|
|
TIME_SECONDS, // 0
|
|
|
|
TIME_MINUTES, // 1
|
|
|
|
TIME_HOURS, // 2
|
|
|
|
TIME_WEEKDAY, // 3
|
|
|
|
TIME_DATE, // 4
|
|
|
|
TIME_MONTH, // 5
|
|
|
|
TIME_YEAR, // 6
|
2021-02-03 14:20:31 +00:00
|
|
|
};
|
|
|
|
|
2021-05-10 05:23:34 +00:00
|
|
|
class RV3028 {
|
|
|
|
//--------------------------------------------------
|
|
|
|
// Constants
|
|
|
|
//--------------------------------------------------
|
|
|
|
public:
|
|
|
|
static const uint8_t DEFAULT_I2C_ADDRESS = RV3028_ADDR;
|
|
|
|
static const uint8_t DEFAULT_INT_PIN = 22;
|
|
|
|
static const uint8_t PIN_UNUSED = UINT8_MAX;
|
|
|
|
|
|
|
|
|
|
|
|
//--------------------------------------------------
|
|
|
|
// Variables
|
|
|
|
//--------------------------------------------------
|
|
|
|
private:
|
2021-05-14 17:12:37 +00:00
|
|
|
I2C *i2c;
|
2021-05-10 05:23:34 +00:00
|
|
|
|
2021-02-03 14:20:31 +00:00
|
|
|
// interface pins with our standard defaults where appropriate
|
2021-05-17 13:50:49 +00:00
|
|
|
const int8_t address = DEFAULT_I2C_ADDRESS;
|
2021-04-20 09:54:10 +00:00
|
|
|
uint interrupt = DEFAULT_INT_PIN;
|
2021-05-10 05:23:34 +00:00
|
|
|
|
|
|
|
uint8_t times[TIME_ARRAY_LENGTH];
|
|
|
|
|
|
|
|
|
|
|
|
//--------------------------------------------------
|
|
|
|
// Constructors/Destructor
|
|
|
|
//--------------------------------------------------
|
|
|
|
public:
|
2021-05-17 13:50:49 +00:00
|
|
|
RV3028() : RV3028(new I2C()) {}
|
2021-05-10 05:23:34 +00:00
|
|
|
|
2021-05-17 13:50:49 +00:00
|
|
|
RV3028(I2C *i2c, uint interrupt = DEFAULT_INT_PIN) :
|
|
|
|
i2c(i2c), interrupt(interrupt) {}
|
2021-05-14 17:12:37 +00:00
|
|
|
|
2021-05-10 05:23:34 +00:00
|
|
|
|
|
|
|
//--------------------------------------------------
|
|
|
|
// Methods
|
|
|
|
//--------------------------------------------------
|
|
|
|
public:
|
|
|
|
bool init();
|
2021-05-10 08:38:51 +00:00
|
|
|
void reset();
|
|
|
|
|
|
|
|
i2c_inst_t* get_i2c() const;
|
|
|
|
int get_sda() const;
|
|
|
|
int get_scl() const;
|
|
|
|
int get_int() const;
|
2021-05-10 05:23:34 +00:00
|
|
|
|
|
|
|
bool setup(bool set_24Hour = true, bool disable_TrickleCharge = true, bool set_LevelSwitchingMode = true);
|
|
|
|
bool set_time(uint8_t sec, uint8_t min, uint8_t hour, uint8_t weekday, uint8_t date, uint8_t month, uint16_t year);
|
|
|
|
bool set_time(uint8_t *time, uint8_t len);
|
|
|
|
bool set_seconds(uint8_t value);
|
|
|
|
bool set_minutes(uint8_t value);
|
|
|
|
bool set_hours(uint8_t value);
|
|
|
|
bool set_weekday(uint8_t value);
|
|
|
|
bool set_date(uint8_t value);
|
|
|
|
bool set_month(uint8_t value);
|
|
|
|
bool set_year(uint16_t value);
|
2021-05-10 14:57:56 +00:00
|
|
|
bool set_to_compiler_time(); // Uses the hours, mins, etc from compile time to set RTC
|
2021-05-10 05:23:34 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
bool update_time(); // Update the local array with the RTC registers
|
2021-05-10 05:23:34 +00:00
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
char* string_date_usa(); // Return date in mm-dd-yyyy
|
|
|
|
char* string_date(); // Return date in dd-mm-yyyy
|
|
|
|
char* string_time(); // Return time hh:mm:ss with AM/PM if in 12 hour mode
|
|
|
|
char* string_time_stamp(); // Return timeStamp in ISO 8601 format yyyy-mm-ddThh:mm:ss
|
2021-05-10 05:23:34 +00:00
|
|
|
|
|
|
|
uint8_t get_seconds();
|
|
|
|
uint8_t get_minutes();
|
|
|
|
uint8_t get_hours();
|
|
|
|
uint8_t get_weekday();
|
|
|
|
uint8_t get_date();
|
|
|
|
uint8_t get_month();
|
|
|
|
uint16_t get_year();
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
bool is_12_hour(); // Returns true if 12hour bit is set
|
|
|
|
bool is_pm(); // Returns true if is12Hour and PM bit is set
|
2021-05-10 05:23:34 +00:00
|
|
|
void set_12_hour();
|
|
|
|
void set_24_hour();
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
bool set_unix(uint32_t value); // Set the UNIX Time (Real Time and UNIX Time are INDEPENDENT!)
|
2021-05-10 05:23:34 +00:00
|
|
|
uint32_t get_unix();
|
|
|
|
|
2021-05-10 08:38:51 +00:00
|
|
|
void enable_alarm_interrupt(uint8_t min, uint8_t hour, uint8_t date_or_weekday, bool set_weekday_alarm_not_date, uint8_t mode, bool enable_clock_output = false);
|
2021-05-10 05:23:34 +00:00
|
|
|
void enable_alarm_interrupt();
|
|
|
|
void disable_alarm_interrupt();
|
|
|
|
bool read_alarm_interrupt_flag();
|
|
|
|
void clear_alarm_interrupt_flag();
|
|
|
|
|
2021-05-10 08:38:51 +00:00
|
|
|
void set_timer(bool timer_repeat, uint16_t timer_frequency, uint16_t timer_value, bool set_interrupt, bool start_timer, bool enable_clock_output = false);
|
|
|
|
uint16_t get_timer_count();
|
2021-05-10 05:23:34 +00:00
|
|
|
void enable_timer();
|
|
|
|
void disable_timer();
|
|
|
|
void enable_timer_interrupt();
|
|
|
|
void disable_timer_interrupt();
|
|
|
|
bool read_timer_interrupt_flag();
|
|
|
|
void clear_timer_interrupt_flag();
|
|
|
|
|
|
|
|
void enable_periodic_update_interrupt(bool every_second, bool enable_clock_output = false);
|
|
|
|
void disable_periodic_update_interrupt();
|
|
|
|
bool read_periodic_update_interrupt_flag();
|
|
|
|
void clear_periodic_update_interrupt_flag();
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
void enable_trickle_charge(uint8_t tcr = TCR_15K); // Trickle Charge Resistor default 15k
|
2021-05-10 05:23:34 +00:00
|
|
|
void disable_trickle_charge();
|
|
|
|
bool set_backup_switchover_mode(uint8_t val);
|
|
|
|
|
|
|
|
void enable_clock_out(uint8_t freq);
|
|
|
|
void enable_interrupt_controlled_clockout(uint8_t freq);
|
|
|
|
void disable_clock_out();
|
|
|
|
bool read_clock_output_interrupt_flag();
|
|
|
|
void clear_clock_output_interrupt_flag();
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
uint8_t status(); // Returns the status byte
|
2021-05-10 05:23:34 +00:00
|
|
|
void clear_interrupts();
|
|
|
|
|
2021-05-10 08:38:51 +00:00
|
|
|
private:
|
2021-05-10 14:57:56 +00:00
|
|
|
// Values in RTC are stored in Binary Coded Decimal. These functions convert to/from Decimal
|
2021-05-10 05:23:34 +00:00
|
|
|
uint8_t bcd_to_dec(uint8_t val);
|
|
|
|
uint8_t dec_to_bcd(uint8_t val);
|
|
|
|
|
|
|
|
uint8_t read_register(uint8_t addr);
|
|
|
|
bool write_register(uint8_t addr, uint8_t val);
|
|
|
|
bool read_multiple_registers(uint8_t addr, uint8_t *dest, uint8_t len);
|
|
|
|
bool write_multiple_registers(uint8_t addr, uint8_t *values, uint8_t len);
|
|
|
|
|
|
|
|
bool write_config_eeprom_ram_mirror(uint8_t eepromaddr, uint8_t val);
|
|
|
|
uint8_t read_config_eeprom_ram_mirror(uint8_t eepromaddr);
|
|
|
|
bool wait_for_eeprom();
|
|
|
|
|
|
|
|
void set_bit(uint8_t reg_addr, uint8_t bit_num);
|
|
|
|
void clear_bit(uint8_t reg_addr, uint8_t bit_num);
|
|
|
|
bool read_bit(uint8_t reg_addr, uint8_t bit_num);
|
2021-02-03 14:20:31 +00:00
|
|
|
};
|
|
|
|
|
2021-05-10 14:57:56 +00:00
|
|
|
// POSSIBLE ENHANCEMENTS :
|
|
|
|
// ENHANCEMENT: Battery Interrupt / check battery voltage
|
|
|
|
// ENHANCEMENT: External Event Interrupt
|
2021-02-03 14:20:31 +00:00
|
|
|
|
|
|
|
}
|