/****************************************************************************** rv3028.cpp Based on 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. ******************************************************************************/ #include "rv3028.hpp" //****************************************************************************// // // Settings and configuration // //****************************************************************************// // Parse the __DATE__ predefined macro to generate date defaults: // __Date__ Format: MMM DD YYYY (First D may be a space if <10) // #define BUILD_MONTH_JAN ((__DATE__[0] == 'J') && (__DATE__[1] == 'a')) ? 1 : 0 #define BUILD_MONTH_FEB (__DATE__[0] == 'F') ? 2 : 0 #define BUILD_MONTH_MAR ((__DATE__[0] == 'M') && (__DATE__[1] == 'a') && (__DATE__[2] == 'r')) ? 3 : 0 #define BUILD_MONTH_APR ((__DATE__[0] == 'A') && (__DATE__[1] == 'p')) ? 4 : 0 #define BUILD_MONTH_MAY ((__DATE__[0] == 'M') && (__DATE__[1] == 'a') && (__DATE__[2] == 'y')) ? 5 : 0 #define BUILD_MONTH_JUN ((__DATE__[0] == 'J') && (__DATE__[1] == 'u') && (__DATE__[2] == 'n')) ? 6 : 0 #define BUILD_MONTH_JUL ((__DATE__[0] == 'J') && (__DATE__[1] == 'u') && (__DATE__[2] == 'l')) ? 7 : 0 #define BUILD_MONTH_AUG ((__DATE__[0] == 'A') && (__DATE__[1] == 'u')) ? 8 : 0 #define BUILD_MONTH_SEP (__DATE__[0] == 'S') ? 9 : 0 #define BUILD_MONTH_OCT (__DATE__[0] == 'O') ? 10 : 0 #define BUILD_MONTH_NOV (__DATE__[0] == 'N') ? 11 : 0 #define BUILD_MONTH_DEC (__DATE__[0] == 'D') ? 12 : 0 #define BUILD_MONTH BUILD_MONTH_JAN | BUILD_MONTH_FEB | BUILD_MONTH_MAR | \ BUILD_MONTH_APR | BUILD_MONTH_MAY | BUILD_MONTH_JUN | \ BUILD_MONTH_JUL | BUILD_MONTH_AUG | BUILD_MONTH_SEP | \ BUILD_MONTH_OCT | BUILD_MONTH_NOV | BUILD_MONTH_DEC // #define BUILD_DATE_0 ((__DATE__[4] == ' ') ? 0 : (__DATE__[4] - 0x30)) #define BUILD_DATE_1 (__DATE__[5] - 0x30) #define BUILD_DATE ((BUILD_DATE_0 * 10) + BUILD_DATE_1) // #define BUILD_YEAR (((__DATE__[7] - 0x30) * 1000) + ((__DATE__[8] - 0x30) * 100) + \ ((__DATE__[9] - 0x30) * 10) + ((__DATE__[10] - 0x30) * 1)) // Parse the __TIME__ predefined macro to generate time defaults: // __TIME__ Format: HH:MM:SS (First number of each is padded by 0 if <10) // #define BUILD_HOUR_0 ((__TIME__[0] == ' ') ? 0 : (__TIME__[0] - 0x30)) #define BUILD_HOUR_1 (__TIME__[1] - 0x30) #define BUILD_HOUR ((BUILD_HOUR_0 * 10) + BUILD_HOUR_1) // #define BUILD_MINUTE_0 ((__TIME__[3] == ' ') ? 0 : (__TIME__[3] - 0x30)) #define BUILD_MINUTE_1 (__TIME__[4] - 0x30) #define BUILD_MINUTE ((BUILD_MINUTE_0 * 10) + BUILD_MINUTE_1) // #define BUILD_SECOND_0 ((__TIME__[6] == ' ') ? 0 : (__TIME__[6] - 0x30)) #define BUILD_SECOND_1 (__TIME__[7] - 0x30) #define BUILD_SECOND ((BUILD_SECOND_0 * 10) + BUILD_SECOND_1) namespace pimoroni { void RV3028::init() { i2c_init(i2c, 400000); gpio_set_function(sda, GPIO_FUNC_I2C); gpio_pull_up(sda); gpio_set_function(scl, GPIO_FUNC_I2C); gpio_pull_up(scl); } bool RV3028::setup(bool set_24Hour, bool disable_TrickleCharge, bool set_LevelSwitchingMode) { sleep_ms(1000); if (set_24Hour) { set24Hour(); sleep_ms(1000); } if (disable_TrickleCharge) { disableTrickleCharge(); sleep_ms(1000); } return((set_LevelSwitchingMode ? setBackupSwitchoverMode(3) : true) && writeRegister(RV3028_STATUS, 0x00)); } bool RV3028::setTime(uint8_t sec, uint8_t min, uint8_t hour, uint8_t weekday, uint8_t date, uint8_t month, uint16_t year) { _time[TIME_SECONDS] = DECtoBCD(sec); _time[TIME_MINUTES] = DECtoBCD(min); _time[TIME_HOURS] = DECtoBCD(hour); _time[TIME_WEEKDAY] = DECtoBCD(weekday); _time[TIME_DATE] = DECtoBCD(date); _time[TIME_MONTH] = DECtoBCD(month); _time[TIME_YEAR] = DECtoBCD(year - 2000); bool status = false; if (is12Hour()) { set24Hour(); status = setTime(_time, TIME_ARRAY_LENGTH); set12Hour(); } else { status = setTime(_time, TIME_ARRAY_LENGTH); } return status; } // setTime -- Set time and date/day registers of RV3028 (using data array) bool RV3028::setTime(uint8_t * time, uint8_t len) { if (len != TIME_ARRAY_LENGTH) return false; return writeMultipleRegisters(RV3028_SECONDS, time, len); } bool RV3028::setSeconds(uint8_t value) { _time[TIME_SECONDS] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setMinutes(uint8_t value) { _time[TIME_MINUTES] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setHours(uint8_t value) { _time[TIME_HOURS] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setWeekday(uint8_t value) { _time[TIME_WEEKDAY] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setDate(uint8_t value) { _time[TIME_DATE] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setMonth(uint8_t value) { _time[TIME_MONTH] = DECtoBCD(value); return setTime(_time, TIME_ARRAY_LENGTH); } bool RV3028::setYear(uint16_t value) { _time[TIME_YEAR] = DECtoBCD(value - 2000); return setTime(_time, TIME_ARRAY_LENGTH); } //Takes the time from the last build and uses it as the current time //Works very well as an arduino sketch bool RV3028::setToCompilerTime() { _time[TIME_SECONDS] = DECtoBCD(BUILD_SECOND); _time[TIME_MINUTES] = DECtoBCD(BUILD_MINUTE); _time[TIME_HOURS] = DECtoBCD(BUILD_HOUR); //Build_Hour is 0-23, convert to 1-12 if needed if (is12Hour()) { uint8_t hour = BUILD_HOUR; bool pm = false; if (hour == 0) hour += 12; else if (hour == 12) pm = true; else if (hour > 12) { hour -= 12; pm = true; } _time[TIME_HOURS] = DECtoBCD(hour); //Load the modified hours if (pm == true) _time[TIME_HOURS] |= (1 << HOURS_AM_PM); //Set AM/PM bit if needed } // Calculate weekday (from here: http://stackoverflow.com/a/21235587) // 0 = Sunday, 6 = Saturday uint16_t d = BUILD_DATE; uint16_t m = BUILD_MONTH; uint16_t y = BUILD_YEAR; uint16_t weekday = (d += m < 3 ? y-- : y - 2, 23 * m / 9 + d + 4 + y / 4 - y / 100 + y / 400) % 7 + 1; _time[TIME_WEEKDAY] = DECtoBCD(weekday); _time[TIME_DATE] = DECtoBCD(BUILD_DATE); _time[TIME_MONTH] = DECtoBCD(BUILD_MONTH); _time[TIME_YEAR] = DECtoBCD(BUILD_YEAR - 2000); //! Not Y2K (or Y2.1K)-proof :( return setTime(_time, TIME_ARRAY_LENGTH); } //Move the hours, mins, sec, etc registers from RV-3028-C7 into the _time array //Needs to be called before printing time or date //We do not protect the GPx registers. They will be overwritten. The user has plenty of RAM if they need it. bool RV3028::updateTime() { if (readMultipleRegisters(RV3028_SECONDS, _time, TIME_ARRAY_LENGTH) == false) return(false); //Something went wrong if (is12Hour()) _time[TIME_HOURS] &= ~(1 << HOURS_AM_PM); //Remove this bit from value return true; } //Returns a pointer to array of chars that are the date in mm/dd/yyyy format because they're weird char* RV3028::stringDateUSA() { static char date[11]; //Max of mm/dd/yyyy with \0 terminator sprintf(date, "%02hhu/%02hhu/20%02hhu", BCDtoDEC(_time[TIME_MONTH]), BCDtoDEC(_time[TIME_DATE]), BCDtoDEC(_time[TIME_YEAR])); return(date); } //Returns a pointer to array of chars that are the date in dd/mm/yyyy format char* RV3028::stringDate() { static char date[11]; //Max of dd/mm/yyyy with \0 terminator sprintf(date, "%02hhu/%02hhu/20%02hhu", BCDtoDEC(_time[TIME_DATE]), BCDtoDEC(_time[TIME_MONTH]), BCDtoDEC(_time[TIME_YEAR])); return(date); } //Returns a pointer to array of chars that represents the time in hh:mm:ss format //Adds AM/PM if in 12 hour mode char* RV3028::stringTime() { static char time[11]; //Max of hh:mm:ssXM with \0 terminator if (is12Hour() == true) { char half = 'A'; if (isPM()) half = 'P'; sprintf(time, "%02hhu:%02hhu:%02hhu%cM", BCDtoDEC(_time[TIME_HOURS]), BCDtoDEC(_time[TIME_MINUTES]), BCDtoDEC(_time[TIME_SECONDS]), half); } else sprintf(time, "%02hhu:%02hhu:%02hhu", BCDtoDEC(_time[TIME_HOURS]), BCDtoDEC(_time[TIME_MINUTES]), BCDtoDEC(_time[TIME_SECONDS])); return(time); } char* RV3028::stringTimeStamp() { static char timeStamp[25]; //Max of yyyy-mm-ddThh:mm:ss.ss with \0 terminator if (is12Hour() == true) { char half = 'A'; if (isPM()) half = 'P'; sprintf(timeStamp, "20%02hhu-%02hhu-%02hhu %02hhu:%02hhu:%02hhu%cM", BCDtoDEC(_time[TIME_YEAR]), BCDtoDEC(_time[TIME_MONTH]), BCDtoDEC(_time[TIME_DATE]), BCDtoDEC(_time[TIME_HOURS]), BCDtoDEC(_time[TIME_MINUTES]), BCDtoDEC(_time[TIME_SECONDS]), half); } else sprintf(timeStamp, "20%02hhu-%02hhu-%02hhu %02hhu:%02hhu:%02hhu", BCDtoDEC(_time[TIME_YEAR]), BCDtoDEC(_time[TIME_MONTH]), BCDtoDEC(_time[TIME_DATE]), BCDtoDEC(_time[TIME_HOURS]), BCDtoDEC(_time[TIME_MINUTES]), BCDtoDEC(_time[TIME_SECONDS])); return(timeStamp); } uint8_t RV3028::getSeconds() { return BCDtoDEC(_time[TIME_SECONDS]); } uint8_t RV3028::getMinutes() { return BCDtoDEC(_time[TIME_MINUTES]); } uint8_t RV3028::getHours() { return BCDtoDEC(_time[TIME_HOURS]); } uint8_t RV3028::getWeekday() { return BCDtoDEC(_time[TIME_WEEKDAY]); } uint8_t RV3028::getDate() { return BCDtoDEC(_time[TIME_DATE]); } uint8_t RV3028::getMonth() { return BCDtoDEC(_time[TIME_MONTH]); } uint16_t RV3028::getYear() { return BCDtoDEC(_time[TIME_YEAR]) + 2000; } //Returns true if RTC has been configured for 12 hour mode bool RV3028::is12Hour() { uint8_t controlRegister2 = readRegister(RV3028_CTRL2); return(controlRegister2 & (1 << CTRL2_12_24)); } //Returns true if RTC has PM bit set and 12Hour bit set bool RV3028::isPM() { uint8_t hourRegister = readRegister(RV3028_HOURS); if (is12Hour() && (hourRegister & (1 << HOURS_AM_PM))) return(true); return(false); } //Configure RTC to output 1-12 hours //Converts any current hour setting to 12 hour void RV3028::set12Hour() { //Do we need to change anything? if (is12Hour() == false) { uint8_t hour = BCDtoDEC(readRegister(RV3028_HOURS)); //Get the current hour in the RTC //Set the 12/24 hour bit uint8_t setting = readRegister(RV3028_CTRL2); setting |= (1 << CTRL2_12_24); writeRegister(RV3028_CTRL2, setting); //Take the current hours and convert to 12, complete with AM/PM bit bool pm = false; if (hour == 0) hour += 12; else if (hour == 12) pm = true; else if (hour > 12) { hour -= 12; pm = true; } hour = DECtoBCD(hour); //Convert to BCD if (pm == true) hour |= (1 << HOURS_AM_PM); //Set AM/PM bit if needed writeRegister(RV3028_HOURS, hour); //Record this to hours register } } //Configure RTC to output 0-23 hours //Converts any current hour setting to 24 hour void RV3028::set24Hour() { //Do we need to change anything? if (is12Hour() == true) { //Not sure what changing the CTRL2 register will do to hour register so let's get a copy uint8_t hour = readRegister(RV3028_HOURS); //Get the current 12 hour formatted time in BCD bool pm = false; if (hour & (1 << HOURS_AM_PM)) //Is the AM/PM bit set? { pm = true; hour &= ~(1 << HOURS_AM_PM); //Clear the bit } //Change to 24 hour mode uint8_t setting = readRegister(RV3028_CTRL2); setting &= ~(1 << CTRL2_12_24); //Clear the 12/24 hr bit writeRegister(RV3028_CTRL2, setting); //Given a BCD hour in the 1-12 range, make it 24 hour = BCDtoDEC(hour); //Convert core of register to DEC if (pm == true) hour += 12; //2PM becomes 14 if (hour == 12) hour = 0; //12AM stays 12, but should really be 0 if (hour == 24) hour = 12; //12PM becomes 24, but should really be 12 hour = DECtoBCD(hour); //Convert to BCD writeRegister(RV3028_HOURS, hour); //Record this to hours register } } //ATTENTION: Real Time and UNIX Time are INDEPENDENT! bool RV3028::setUNIX(uint32_t value) { uint8_t unix_reg[4]; unix_reg[0] = value; unix_reg[1] = value >> 8; unix_reg[2] = value >> 16; unix_reg[3] = value >> 24; return writeMultipleRegisters(RV3028_UNIX_TIME0, unix_reg, 4); } //ATTENTION: Real Time and UNIX Time are INDEPENDENT! uint32_t RV3028::getUNIX() { uint8_t unix_reg[4]; readMultipleRegisters(RV3028_UNIX_TIME0, unix_reg, 4); return ((uint32_t)unix_reg[3] << 24) | ((uint32_t)unix_reg[2] << 16) | ((uint32_t)unix_reg[1] << 8) | unix_reg[0]; } /********************************* Set the alarm mode in the following way: 0: When minutes, hours and weekday/date match (once per weekday/date) 1: When hours and weekday/date match (once per weekday/date) 2: When minutes and weekday/date match (once per hour per weekday/date) 3: When weekday/date match (once per weekday/date) 4: When hours and minutes match (once per day) 5: When hours match (once per day) 6: When minutes match (once per hour) 7: All disabled � Default value If you want to set a weekday alarm (setWeekdayAlarm_not_Date = true), set 'date_or_weekday' from 0 (Sunday) to 6 (Saturday) ********************************/ void RV3028::enableAlarmInterrupt(uint8_t min, uint8_t hour, uint8_t date_or_weekday, bool setWeekdayAlarm_not_Date, uint8_t mode, bool enable_clock_output) { //disable Alarm Interrupt to prevent accidental interrupts during configuration disableAlarmInterrupt(); clearAlarmInterruptFlag(); //ENHANCEMENT: Add Alarm in 12 hour mode set24Hour(); //Set WADA bit (Weekday/Date Alarm) if (setWeekdayAlarm_not_Date) clearBit(RV3028_CTRL1, CTRL1_WADA); else setBit(RV3028_CTRL1, CTRL1_WADA); //Write alarm settings in registers 0x07 to 0x09 uint8_t alarmTime[3]; alarmTime[0] = DECtoBCD(min); //minutes alarmTime[1] = DECtoBCD(hour); //hours alarmTime[2] = DECtoBCD(date_or_weekday); //date or weekday //shift alarm enable bits if (mode > 0b111) mode = 0b111; //0 to 7 is valid if (mode & 0b001) alarmTime[0] |= 1 << MINUTESALM_AE_M; if (mode & 0b010) alarmTime[1] |= 1 << HOURSALM_AE_H; if (mode & 0b100) alarmTime[2] |= 1 << DATE_AE_WD; //Write registers writeMultipleRegisters(RV3028_MINUTES_ALM, alarmTime, 3); //enable Alarm Interrupt enableAlarmInterrupt(); //Clock output? if (enable_clock_output) setBit(RV3028_INT_MASK, IMT_MASK_CAIE); else clearBit(RV3028_INT_MASK, IMT_MASK_CAIE); } void RV3028::enableAlarmInterrupt() { setBit(RV3028_CTRL2, CTRL2_AIE); } //Only disables the interrupt (not the alarm flag) void RV3028::disableAlarmInterrupt() { clearBit(RV3028_CTRL2, CTRL2_AIE); } bool RV3028::readAlarmInterruptFlag() { return readBit(RV3028_STATUS, STATUS_AF); } void RV3028::clearAlarmInterruptFlag() { clearBit(RV3028_STATUS, STATUS_AF); } /********************************* Countdown Timer Interrupt ********************************/ void RV3028::setTimer(bool timer_repeat, uint16_t timer_frequency, uint16_t timer_value, bool set_interrupt, bool start_timer, bool enable_clock_output) { disableTimer(); disableTimerInterrupt(); clearTimerInterruptFlag(); writeRegister(RV3028_TIMERVAL_0, timer_value & 0xff); writeRegister(RV3028_TIMERVAL_1, timer_value >> 8); uint8_t ctrl1_val = readRegister(RV3028_CTRL1); if (timer_repeat) { ctrl1_val |= 1 << CTRL1_TRPT; } else { ctrl1_val &= ~(1 << CTRL1_TRPT); } switch (timer_frequency) { case 4096: // 4096Hz (default) // up to 122us error on first time ctrl1_val &= ~3; // Clear both the bits break; case 64: // 64Hz // up to 7.813ms error on first time ctrl1_val &= ~3; // Clear both the bits ctrl1_val |= 1; break; case 1: // 1Hz // up to 7.813ms error on first time ctrl1_val &= ~3; // Clear both the bits ctrl1_val |= 2; break; case 60000: // 1/60Hz // up to 7.813ms error on first time ctrl1_val |= 3; // Set both bits break; } if (set_interrupt) { enableTimerInterrupt(); } if (start_timer) { ctrl1_val |= (1 << CTRL1_TE); } writeRegister(RV3028_CTRL1, ctrl1_val); //Clock output? if (enable_clock_output) setBit(RV3028_INT_MASK, IMT_MASK_CTIE); else clearBit(RV3028_INT_MASK, IMT_MASK_CTIE); } uint16_t RV3028::getTimerCount(void) { // Reads the number of remaining timer ticks uint8_t r0 =readRegister(RV3028_TIMERSTAT_0); return(r0 + (readRegister(RV3028_TIMERSTAT_1) << 8)); } void RV3028::enableTimerInterrupt() { setBit(RV3028_CTRL2, CTRL2_TIE); } void RV3028::disableTimerInterrupt() { clearBit(RV3028_CTRL2, CTRL2_TIE); } bool RV3028::readTimerInterruptFlag() { return readBit(RV3028_STATUS, STATUS_TF); } void RV3028::clearTimerInterruptFlag() { clearBit(RV3028_STATUS, STATUS_TF); } void RV3028::enableTimer() { setBit(RV3028_CTRL1, CTRL1_TE); } void RV3028::disableTimer() { clearBit(RV3028_CTRL1, CTRL1_TE); } /********************************* Periodic Time Update Interrupt ********************************/ void RV3028::enablePeriodicUpdateInterrupt(bool every_second, bool enable_clock_output) { disablePeriodicUpdateInterrupt(); clearPeriodicUpdateInterruptFlag(); if (every_second) { clearBit(RV3028_CTRL1, CTRL1_USEL); } else { // every minute setBit(RV3028_CTRL1, CTRL1_USEL); } setBit(RV3028_CTRL2, CTRL2_UIE); //Clock output? if (enable_clock_output) setBit(RV3028_INT_MASK, IMT_MASK_CUIE); else clearBit(RV3028_INT_MASK, IMT_MASK_CUIE); } void RV3028::disablePeriodicUpdateInterrupt() { clearBit(RV3028_CTRL2, CTRL2_UIE); } bool RV3028::readPeriodicUpdateInterruptFlag() { return readBit(RV3028_STATUS, STATUS_UF); } void RV3028::clearPeriodicUpdateInterruptFlag() { clearBit(RV3028_STATUS, STATUS_UF); } /********************************* Enable the Trickle Charger and set the Trickle Charge series resistor (default is 15k) TCR_3K = 3kOhm TCR_5K = 5kOhm TCR_9K = 9kOhm TCR_15K = 15kOhm *********************************/ void RV3028::enableTrickleCharge(uint8_t tcr) { if (tcr > 3) return; //Read EEPROM Backup Register (0x37) uint8_t EEPROMBackup = readConfigEEPROM_RAMmirror(EEPROM_Backup_Register); //Set TCR Bits (Trickle Charge Resistor) EEPROMBackup &= EEPROMBackup_TCR_CLEAR; //Clear TCR Bits EEPROMBackup |= tcr << EEPROMBackup_TCR_SHIFT; //Shift values into EEPROM Backup Register //Write 1 to TCE Bit EEPROMBackup |= 1 << EEPROMBackup_TCE_BIT; //Write EEPROM Backup Register writeConfigEEPROM_RAMmirror(EEPROM_Backup_Register, EEPROMBackup); } void RV3028::disableTrickleCharge() { //Read EEPROM Backup Register (0x37) uint8_t EEPROMBackup = readConfigEEPROM_RAMmirror(EEPROM_Backup_Register); //Write 0 to TCE Bit EEPROMBackup &= ~(1 << EEPROMBackup_TCE_BIT); //Write EEPROM Backup Register writeConfigEEPROM_RAMmirror(EEPROM_Backup_Register, EEPROMBackup); } /********************************* 0 = Switchover disabled 1 = Direct Switching Mode 2 = Standby Mode 3 = Level Switching Mode *********************************/ bool RV3028::setBackupSwitchoverMode(uint8_t val) { if (val > 3)return false; bool success = true; //Read EEPROM Backup Register (0x37) uint8_t EEPROMBackup = readConfigEEPROM_RAMmirror(EEPROM_Backup_Register); if (EEPROMBackup == 0xFF) success = false; //Ensure FEDE Bit is set to 1 EEPROMBackup |= 1 << EEPROMBackup_FEDE_BIT; //Set BSM Bits (Backup Switchover Mode) EEPROMBackup &= EEPROMBackup_BSM_CLEAR; //Clear BSM Bits of EEPROM Backup Register EEPROMBackup |= val << EEPROMBackup_BSM_SHIFT; //Shift values into EEPROM Backup Register //Write EEPROM Backup Register if (!writeConfigEEPROM_RAMmirror(EEPROM_Backup_Register, EEPROMBackup)) success = false; return success; } /********************************* Clock Out functions ********************************/ void RV3028::enableClockOut(uint8_t freq) { if (freq > 7) return; // check out of bounds //Read EEPROM CLKOUT Register (0x35) uint8_t EEPROMClkout = readConfigEEPROM_RAMmirror(EEPROM_Clkout_Register); //Ensure CLKOE Bit is set to 1 EEPROMClkout |= 1 << EEPROMClkout_CLKOE_BIT; //Shift values into EEPROM Backup Register EEPROMClkout |= freq << EEPROMClkout_FREQ_SHIFT; //Write EEPROM Backup Register writeConfigEEPROM_RAMmirror(EEPROM_Clkout_Register, EEPROMClkout); } void RV3028::enableInterruptControlledClockout(uint8_t freq) { if (freq > 7) return; // check out of bounds //Read EEPROM CLKOUT Register (0x35) uint8_t EEPROMClkout = readConfigEEPROM_RAMmirror(EEPROM_Clkout_Register); //Shift values into EEPROM Backup Register EEPROMClkout |= freq << EEPROMClkout_FREQ_SHIFT; //Write EEPROM Backup Register writeConfigEEPROM_RAMmirror(EEPROM_Clkout_Register, EEPROMClkout); //Set CLKIE Bit setBit(RV3028_CTRL2, CTRL2_CLKIE); } void RV3028::disableClockOut() { //Read EEPROM CLKOUT Register (0x35) uint8_t EEPROMClkout = readConfigEEPROM_RAMmirror(EEPROM_Clkout_Register); //Clear CLKOE Bit EEPROMClkout &= ~(1 << EEPROMClkout_CLKOE_BIT); //Write EEPROM CLKOUT Register writeConfigEEPROM_RAMmirror(EEPROM_Clkout_Register, EEPROMClkout); //Clear CLKIE Bit clearBit(RV3028_CTRL2, CTRL2_CLKIE); } bool RV3028::readClockOutputInterruptFlag() { return readBit(RV3028_STATUS, STATUS_CLKF); } void RV3028::clearClockOutputInterruptFlag() { clearBit(RV3028_STATUS, STATUS_CLKF); } //Returns the status byte uint8_t RV3028::status(void) { return(readRegister(RV3028_STATUS)); } void RV3028::clearInterrupts() //Read the status register to clear the current interrupt flags { writeRegister(RV3028_STATUS, 0); } // i2c functions int RV3028::write_bytes(uint8_t reg, uint8_t *buf, int len) { uint8_t buffer[len + 1]; buffer[0] = reg; for(int x = 0; x < len; x++) { buffer[x + 1] = buf[x]; } return i2c_write_blocking(i2c, address, buffer, len + 1, false); }; int RV3028::read_bytes(uint8_t reg, uint8_t *buf, int len) { i2c_write_blocking(i2c, address, ®, 1, true); i2c_read_blocking(i2c, address, buf, len, false); return len; }; uint8_t RV3028::get_bits(uint8_t reg, uint8_t shift, uint8_t mask) { uint8_t value; this->read_bytes(reg, &value, 1); return value & (mask << shift); } void RV3028::set_bits(uint8_t reg, uint8_t shift, uint8_t mask) { uint8_t value; this->read_bytes(reg, &value, 1); value |= mask << shift; this->write_bytes(reg, &value, 1); } void RV3028::clear_bits(uint8_t reg, uint8_t shift, uint8_t mask) { uint8_t value; this->read_bytes(reg, &value, 1); value &= ~(mask << shift); this->write_bytes(reg, &value, 1); } /********************************* FOR INTERNAL USE ********************************/ uint8_t RV3028::BCDtoDEC(uint8_t val) { return ((val / 0x10) * 10) + (val % 0x10); } // BCDtoDEC -- convert decimal to binary-coded decimal (BCD) uint8_t RV3028::DECtoBCD(uint8_t val) { return ((val / 10) * 0x10) + (val % 10); } uint8_t RV3028::readRegister(uint8_t addr) { uint8_t b1[2]; if ( 1 == RV3028::read_bytes(addr, b1, 1)) { return b1[0]; } else { return (0xFF); //Error } } bool RV3028::writeRegister(uint8_t addr, uint8_t val) { uint8_t b1[2]; b1[0] = val; b1[1] = 0; return(RV3028::write_bytes(addr, b1, 1)); } bool RV3028::readMultipleRegisters(uint8_t addr, uint8_t * dest, uint8_t len) { return(RV3028::read_bytes(addr, dest, len)); } bool RV3028::writeMultipleRegisters(uint8_t addr, uint8_t * values, uint8_t len) { return(RV3028::write_bytes(addr, values, len)); } bool RV3028::writeConfigEEPROM_RAMmirror(uint8_t eepromaddr, uint8_t val) { bool success = waitforEEPROM(); //Disable auto refresh by writing 1 to EERD control bit in CTRL1 register uint8_t ctrl1 = readRegister(RV3028_CTRL1); ctrl1 |= 1 << CTRL1_EERD; if (!writeRegister(RV3028_CTRL1, ctrl1)) success = false; //Write Configuration RAM Register writeRegister(eepromaddr, val); //Update EEPROM (All Configuration RAM -> EEPROM) writeRegister(RV3028_EEPROM_CMD, EEPROMCMD_First); writeRegister(RV3028_EEPROM_CMD, EEPROMCMD_Update); if (!waitforEEPROM()) success = false; //Reenable auto refresh by writing 0 to EERD control bit in CTRL1 register ctrl1 = readRegister(RV3028_CTRL1); if (ctrl1 == 0x00)success = false; ctrl1 &= ~(1 << CTRL1_EERD); writeRegister(RV3028_CTRL1, ctrl1); if (!waitforEEPROM()) success = false; return success; } uint8_t RV3028::readConfigEEPROM_RAMmirror(uint8_t eepromaddr) { bool success = waitforEEPROM(); //Disable auto refresh by writing 1 to EERD control bit in CTRL1 register uint8_t ctrl1 = readRegister(RV3028_CTRL1); ctrl1 |= 1 << CTRL1_EERD; if (!writeRegister(RV3028_CTRL1, ctrl1)) success = false; //Read EEPROM Register writeRegister(RV3028_EEPROM_ADDR, eepromaddr); writeRegister(RV3028_EEPROM_CMD, EEPROMCMD_First); writeRegister(RV3028_EEPROM_CMD, EEPROMCMD_ReadSingle); if (!waitforEEPROM()) success = false; uint8_t eepromdata = readRegister(RV3028_EEPROM_DATA); if (!waitforEEPROM()) success = false; //Reenable auto refresh by writing 0 to EERD control bit in CTRL1 register ctrl1 = readRegister(RV3028_CTRL1); if (ctrl1 == 0x00)success = false; ctrl1 &= ~(1 << CTRL1_EERD); writeRegister(RV3028_CTRL1, ctrl1); if (!success) return 0xFF; return eepromdata; } //True if success, false if timeout occured bool RV3028::waitforEEPROM() { // Timeout is number of loops round while - don't have access to millisecond counter unsigned long timeout = 500; while ((readRegister(RV3028_STATUS) & 1 << STATUS_EEBUSY) && --timeout > 0); return timeout > 0; } void RV3028::reset() { setBit(RV3028_CTRL2, CTRL2_RESET); } void RV3028::setBit(uint8_t reg_addr, uint8_t bit_num) { RV3028::set_bits(reg_addr, bit_num, 0x01); } void RV3028::clearBit(uint8_t reg_addr, uint8_t bit_num) { RV3028::clear_bits(reg_addr, bit_num, 0x01); } bool RV3028::readBit(uint8_t reg_addr, uint8_t bit_num) { uint8_t value = RV3028::get_bits(reg_addr, bit_num, 0x01); return value; } }