RTC

Contenido

1 Descripción
2 Placas aplicables
3 Sintaxis
4 Parámetros
5 Clases
6 Métodos
7 Comentarios
8 Advertencias
9 Ejemplo 1
10 Ejemplo 2
11 Ejemplo 3
12 Ejemplo 4
13 Vea también
14 Referencias

Descripción

La librería RTClib.h de Adafruit que permite trabajar con un reloj por software (RTC_Millis) y algunos relojes físicos como RTC_DS1307, RTC_DS3231 y PCF8523.

Placas aplicables

Todas.

Sintaxis

//#include <Wire.h>  //Solo si usas reloj fisico
#include <RTClib.h>
RTC_Millis rtc;     //Reloj por software que usa millis()
RTC_Micros rtc;     //Reloj por software que usa micros()
//RTC_DS1307 rtc;   //Reloj con DS1307
//RTC_DS3231 rtc;   //Reloj con DS3231
//RTC_PCF8523 rtc;   //Reloj con PCF8523

Parámetros

variable: Nombre de la variable a crear.
año: 4 digitos del año.
mes: 2 digitos del mes entre 1~12.
dia: 2 digitos del dia entre 1~31.
hora: 2 digitos de la hora entre 0~23.
min: 2 digitos de los minutos entre 0~59.
seg: 2 digitos de los segundos entre 0~59.

Clases

Esta librería maneja dos clases:

DateTime - es un tipo de dato
TimeSpan() - para manejar intervalos de tiempo

Métodos

Métodos disponibles libreria RTClib.h
Método	Descripción
.now()	Toma de fecha y hora actual.
.adjust()	Ajustar fecha y hora
.isrunning()	Devuelve verdadero si esta ajustada la fecha hora.
.readSqwPinMode()	Leer el modo. OFF, ON, SquareWave1Hz, SquareWave4kHz, SquareWave8kHz o SquareWave32kHz.
.writeSqwPinMode(modo)	Escribir modo.

Modos de sqwPinMode()
Modo	Frecuencia
SquareWave1Hz	1 kHz
SquareWave4Hz	4.096 kHz
SquareWave8Hz	8.192 kHz
SquareWave32Hz	32.768 kHz

Métodos disponibles clase DateTime
Método	Descripción
.year()	Año
.month()	Mes (1~12)
.day()	Dia (1~31)
.hour()	Horas (0~23)
.minute()	Minutos (0~59)
.second()	Segundos (0~59)
.dayOfTheWeek()	Dia de la semana (0=domingo)
.secondstime()	Segundos desde 1-ENE-2000
.unixtime()	Segundos desde 1-ENE-1970
.timestamp()	Formato "2020-01-01T08:00:00

Métodos clase TimeSpan
Método	Descripción
.days()	Dias (1~31)
.hours()	Horas (0~23)
.minutes()	Minutos (0~59)
.seconds()	Segundos (0~59)
.totalsecons()	Segundos totales

Comentarios

Accionar una alarma a las 8 am de cada lunes.

DateTime t = now();
if (t.hour() == 8 && t.dayOfTheWeek() = 2){
  //Lo necesario
}

Accionar una alarma cada 45 min (2 700 seg).

DateTime t = now();
if (t.unixtime()%2700 == 0){
  //Lo necesario
}

Advertencias

Nada.

Ejemplo 1

Si usas la librería RTClib.h tendrás disponible el método .unixtime() que es excelente para hacer operaciones con fechas.

#include <RTClib.h>
DateTime t0 (2018,7,14,8,0,0);           //2018-7-14 8:00:00
//Calculos 1
DateTime t1 = t0 + TimeSpan(0,1,0,0);    //Añadir una hora
DateTime t2 = t0 + TimeSpan(1,0,0,0);    //Añadir un dia
DateTime t3 = t0 - TimeSpan(7,0,0,0);    //Restar una semana
//Calculos 2
DateTime unix = t0.unixtime();           //1531555200
DateTime t1 (t0.unixtime() + 3600);      //Añadir una hora
DateTime t2 (t0.unixtime() + 86400L);    //Añadir un dia
DateTime t3 (t0.unixtime() - 7*86400L);  //Restar una semana
//Mostrar
Serial.print(t0.unixtime());             //1531555200
Serial.print(t0.year());                 //2018
Serial.print(t0.month());                //7
Serial.print(t0.day());                  //14
Serial.print(t0.hour());                 //8
Serial.print(t0.minute());               //0
Serial.print(t0.second());               //0

Ejemplo 2

Muestra por el monitor serie: año, mes, dia, dia de la semana, hora, minutos y segundos, luego el tiempo Unix y finalmente calcula una fecha futura dentro de: 7 dias, 12 horas, 30 minutos y 6 segundos.

//#include <Wire.h>   //Solo si usas reloj fisico
#include <RTClib.h>

RTC_Millis rtc;     //Reloj por software
//RTC_DS1307 rtc;   //Reloj con DS1307
//RTC_DS3231 rtc;   //Reloj con DS3231

char diaSemana[7][12] = {"Domingo", "Lunes", "Martes", "Miercoles", "Jueves", "Viernes", "Sabado"};

void setup () {
   Serial.begin(57600);
   //Para setear RTC con fecha y hora cuando se compila
   rtc.begin(DateTime(F(__DATE__), F(__TIME__)));
   //Para setear RTC a 21-MAR-2019 8:00:00
   //rtc.adjust(DateTime(2019, 3, 21, 8, 0, 0));
}

void loop () {
    DateTime hoy = rtc.now();
    
    Serial.print(hoy.year());
    Serial.print('-');
    Serial.print(hoy.month());
    Serial.print('-');
    Serial.print(hoy.day());
    Serial.print(" (");
    Serial.print(diaSemana[hoy.dayOfTheWeek()]);
    Serial.print(") ");
    Serial.print(hoy.hour());
    Serial.print(':');
    Serial.print(hoy.minute());
    Serial.print(':');
    Serial.println(hoy.second());
    
    Serial.print("Desde 1-ENE-1970 = ");

    Serial.print("Segundos = ");
    Serial.println(hoy.unixtime());

    Serial.print("Dias = ");
    Serial.println(hoy.unixtime() / 86400L);
    
    //calcula fecha dentro de 7 dias, 12 horas, 30 minutos y 6 segundos
    DateTime futuro (hoy + TimeSpan(7,12,30,6));
    
    Serial.print("Fecha futura: ");
    Serial.print(futuro.year());
    Serial.print('-');
    Serial.print(futuro.month());
    Serial.print('-');
    Serial.print(futuro.day());
    Serial.print(' ');
    Serial.print(futuro.hour());
    Serial.print(':');
    Serial.print(futuro.minute());
    Serial.print(':');
    Serial.print(futuro.second());
    Serial.println();
    
    Serial.println();
    delay(3000);
}

Ejemplo 3

Este es un reloj con 12 LED que prende un LED cada 5 segundos

#include <RTClib.h>
RTC_Millis rtc;
const byte led[12] = {13,2,3,4,5,6,7,8,9,10,11,12};

void setup() { 
   Serial.begin(9600);                           
   rtc.adjust(DateTime(__DATE__, __TIME__));
   for (byte i=0; i<12; i++){
      pinMode(led[i], OUTPUT);
   }
}

void loop() {
   DateTime hoy = rtc.now();
   if (hoy.unixtime()%5 == 0){
      for (byte i=0; i<12; i++){
         digitalWrite(led[i], LOW);
      }
      byte hora = hoy.second()/5;
      digitalWrite(led[hora], HIGH);
   }
}

Ejemplo 4

Este es un reloj con LCD y dos pulsadores para corregir la hora. Uno adelante y el otro retrocede.

#include <LiquidCrystal.h>
#include <RTClib.h>

RTC_Millis rtc;
DateTime t;
LiquidCrystal lcd(7, 8, 9, 10, 11, 12);

void setup() {
   lcd.begin(16, 2);
   rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
   pinMode(2, INPUT_PULLUP);  //Avanza
   pinMode(3, INPUT_PULLUP);  //Retrocede
   lcd.setCursor(2,0);
   lcd.print("Hora actual");
}

void loop() {     
   t = rtc.now();
   disp();
   //Ajusta hora
   if (digitalRead(2) == LOW){
      rtc.adjust(t.unixtime()+1);
      delay(100);
   }
   if (digitalRead(3) == LOW){
      rtc.adjust(t.unixtime()-1);
      delay(100);
   }
}

void disp(){
   lcd.setCursor(4,1);
      
   if (t.hour() < 10) lcd.print("0");
   lcd.print(t.hour());
   lcd.print(":");
      
   if (t.minute()< 10) lcd.print("0");
   lcd.print(t.minute());
   lcd.print(":");

   if (t.second() < 10) lcd.print("0");
   lcd.print(t.second());
}