Skip to content
This repository has been archived by the owner on Jan 29, 2023. It is now read-only.
/ RP2040_RTC Public archive

This library enables you to use RTC from RP2040-based boards such as Nano_RP2040_Connect, RASPBERRY_PI_PICO. This RP2040-based RTC, using Interrupt, has no battery backup. Time will be lost when powered down. To need NTP-client to update RTC every start-up.

License

Notifications You must be signed in to change notification settings

khoih-prog/RP2040_RTC

Repository files navigation

RP2040_RTC Library

arduino-library-badge GitHub release GitHub contributions welcome GitHub issues

Donate to my libraries using BuyMeACoffee



Table of Contents



Why do we need this RP2040_RTC library

Features

This is an Arduino library for RP2040-based RTC

The RTC keeps track of time in human readable format and generates events when the time is equal to a preset value.
Think of a digital clock, not epoch time used by most computers. There are seven fields, one each for year (12 bit),
month (4 bit), day (5 bit), day of the week (3 bit), hour (5 bit) minute (6 bit) and second (6 bit), storing the data in binary
format.

The examples will demonstrate how to get the UTC time from NTP server, then update the RTC to make sure the time is perfectly correct.

Why using ISR-based Alarm is better

Imagine you have a system with a mission-critical function, measuring water level and control the sump pump or doing something much more important. You normally use a software timer to poll, or even place the function in loop(). But what if another function is blocking the loop() or setup().

So your function might not be executed, and the result would be disastrous.

You'd prefer to have your function called, no matter what happening with other functions (busy loop, bug, etc.).

The correct choice is to use an ISR-based Alarm with Interrupt to call your function.

These ISR-based Alarm, using interrupt, still work even if other functions are blocking. Moreover, they are much more precise (certainly depending on clock frequency accuracy) than other software timers using millis() or micros(). That's necessary if you need to measure some data requiring better accuracy.

Functions using normal software timers, relying on loop() and calling millis(), won't work if the loop() or setup() is blocked by certain operation. For example, certain function is blocking while it's connecting to WiFi or some services.

The catch is your function is now part of an ISR (Interrupt Service Routine), and must be lean / mean, and follow certain rules. More to read on:

HOWTO Attach Interrupt


Currently supported Boards

  1. RP2040-based boards, such as NANO_RP2040_CONNECT, RASPBERRY_PI_PICO, RASPBERRY_PI_PICO_W, ADAFRUIT_FEATHER_RP2040 and GENERIC_RP2040, using Arduino-mbed RP2040 core or Earle Philhower's arduino-pico core

Currently supported Ethernet shields/modules

  1. W5x00 using Ethernet_Generic library
  2. W5100S shield /module, using Ethernet_Generic library, such as WIZnet Ethernet HAT and W5100S-EVB-Pico

Currently supported WiFi shields/modules

  1. WiFiNINA using WiFiNINA_Generic library
  2. CYW43439 WiFi with RASPBERRY_PI_PICO_W using arduino-pico core


Prerequisites

  1. Arduino IDE 1.8.19 for Arduino. GitHub release

  2. Arduino mbed_rp2040 core 3.3.0 for Arduino RP2040-based boards, such as Arduino Nano RP2040 Connect, RASPBERRY_PI_PICO, etc.. GitHub release

  3. Earle Philhower's arduino-pico core v2.5.4 for RP2040-based boards such as RASPBERRY_PI_PICO, ADAFRUIT_FEATHER_RP2040 and GENERIC_RP2040, etc. GitHub release

  4. Timezone_Generic library v1.10.0 to use examples using Timezone. GitHub release

  5. WiFiNINA_Generic library v1.8.14-6 to use WiFiNINA modules/shields. GitHub release

  6. Depending on which Ethernet card/module/shield you're using:



Installation

Use Arduino Library Manager

The best and easiest way is to use Arduino Library Manager. Search for RP2040_RTC, then select / install the latest version. You can also use this link arduino-library-badge for more detailed instructions.

Manual Install

Another way to install is to:

  1. Navigate to RP2040_RTC page.
  2. Download the latest release RP2040_RTC-main.zip.
  3. Extract the zip file to RP2040_RTC-main directory
  4. Copy whole RP2040_RTC-main folder to Arduino libraries' directory such as ~/Arduino/libraries/.

VS Code & PlatformIO

  1. Install VS Code
  2. Install PlatformIO
  3. Install RP2040_RTC library by using Library Manager. Search for RP2040_RTC in Platform.io Author's Libraries
  4. Please visit documentation for the other options and examples at Project Configuration File


Libraries' Patches

1. For application requiring 2K HTML page

If your application requires 2K HTML page, the current Ethernet library must be modified if you are using W5200/W5500 Ethernet shields. W5100 is not supported for 2K buffer. If you use boards requiring different CS/SS pin for W5x00 Ethernet shield, for example ESP32, ESP8266, nRF52, etc., you also have to modify the following libraries to be able to specify the CS/SS pin correctly.

2. For Ethernet library

To fix Ethernet library, just copy these following files into the Ethernet library directory to overwrite the old files:

3. For EthernetLarge library

To fix EthernetLarge library, just copy these following files into the EthernetLarge library directory to overwrite the old files:

4. For Ethernet2 library

To fix Ethernet2 library, just copy these following files into the Ethernet2 library directory to overwrite the old files:

To add UDP Multicast support, necessary for the UPnP_Generic library:

5. For Ethernet3 library

  1. To fix Ethernet3 library, just copy these following files into the Ethernet3 library directory to overwrite the old files:

6. For UIPEthernet library

To be able to compile and run on nRF52 boards with ENC28J60 using UIPEthernet library, you have to copy these following files into the UIPEthernet utility directory to overwrite the old files:



Usage

1. Raspberry Pi Pico C/C SDK

From Raspberry Pi Pico C/C SDK

1.1. Typedef

typedef void(* rtc_callback_t )(void);

typedef struct 
{
  int16_t year;     ///< 0..4095
  int8_t  month;    ///< 1..12, 1 is January
  int8_t  day;      ///< 1..28,29,30,31 depending on month
  int8_t  dotw;     ///< 0..6, 0 is Sunday
  int8_t  hour;     ///< 0..23
  int8_t  min;      ///< 0..59
  int8_t  sec;      ///< 0..59
} datetime_t;

1.2. SDK Function List

void rtc_init (void);
bool rtc_set_datetime (datetime_t *t);
bool rtc_get_datetime (datetime_t *t);
bool rtc_running (void);
void rtc_set_alarm (datetime_t *t, rtc_callback_t user_callback);
void rtc_enable_alarm (void);
void rtc_disable_alarm (void);

// Not very good to use
void datetime_to_str (char *buf, uint buf_size, const datetime_t *t);

1.3. SDK Function Documentation

Use one of these functions with interval in unsigned long microseconds

rtc_disable_alarm

void rtc_disable_alarm (void)

Disable the RTC alarm (if active)

rtc_enable_alarm

void rtc_enable_alarm (void)

Enable the RTC alarm (if inactive)

rtc_get_datetime

bool rtc_get_datetime (datetime_t *t)

Get the current time from the RTC.

Parameters

t : Pointer to a datetime_t structure to receive the current RTC time

Returns

true if datetime is valid, false if the RTC is not running.

rtc_init

void rtc_init (void)

Initialise the RTC system.

rtc_running

bool rtc_running (void)

Is the RTC running?

rtc_set_alarm

void rtc_set_alarm (datetime_t *t, rtc_callback_t user_callback)

Set a time in the future for the RTC to call a user provided callback.

Parameters

t : Pointer to a datetime_t structure containing a time in the future to fire the alarm. Any values set to -1 will not be matched on. • user_callback : pointer to a rtc_callback_t to call when the alarm fires

rtc_set_datetime

bool rtc_set_datetime (datetime_t *t)

Set the RTC to the specified time.

Parameters

t : Pointer to a datetime_t structure contains time to set

Returns

true if set, false if the passed in datetime was invalid.

datetime_to_str

void datetime_to_str (char *buf, uint buf_size, const datetime_t *t)

Convert a datetime_t structure to a string.

Parameters

buf : character buffer to accept generated string • buf_size : The size of the passed in buffer • t : The datetime to be converted


2. Library Functions

2.1. Typedef

class TimeSpan;

class DateTime;

/** ISO 8601 Timestamp function */
enum timestampOpt 
{
  TIMESTAMP_FULL, // YYYY-MM-DDTHH:MM:SS
  TIMESTAMP_TIME, // HH:MM:SS
  TIMESTAMP_DATE  // YYYY-MM-DD
};

2.2. Library Function List

class DateTime
{
  DateTime (uint32_t t = SECONDS_FROM_1970_TO_2000);
  DateTime (const uint16_t year, const uint8_t month, const uint8_t day, const uint8_t hour = 0, const uint8_t min = 0, const uint8_t sec = 0);
  DateTime (const DateTime& copy);
  DateTime (const tmElements_t& tm);

  // To use with RP2040 datetime_t struct
  DateTime (const datetime_t &tm);

  tmElements_t get_tmElements_t();
  void setFrom_tmElements_t(const tmElements_t& tm);
  time_t get_time_t();
  void setFrom_time_t(const time_t& timeInput);

  uint16_t year() const;
  uint8_t month() const;
  uint8_t day() const;
  uint8_t hour() const;
  uint8_t minute() const;
  uint8_t second() const;
  uint16_t yearOffset() const;
  uint8_t dayOfTheWeek() const;

  /** 32-bit times as seconds since 1/1/2000 */
  long secondstime() const;

  /** 32-bit times as seconds since 1/1/1970 */
  uint32_t unixtime() const;

  /** ISO 8601 Timestamp function */
  String timestamp(timestampOpt opt = TIMESTAMP_FULL)
}


Examples

  1. RP2040_RTC_Alarm
  2. RP2040_RTC_Alarm_Ethernet
  3. RP2040_RTC_Alarm_WiFiNINA
  4. RP2040_RTC_Alarm_RP2040W New
  5. RP2040_RTC_Time
  6. RP2040_RTC_Time_Ethernet
  7. RP2040_RTC_Time_WiFiNINA
  8. RP2040_RTC_Time_RP2040W New


// Important notes: Currently, RP2040-based boards RTC has no battery backup. So the time will be lost when power down
// Therefore, NTP client is necessary to get NTP time and update RTC.
#include "defines.h"
// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
#include <Timezone_Generic.h> // https://github.com/khoih-prog/Timezone_Generic
//////////////////////////////////////////
// US Eastern Time Zone (New York, Detroit)
TimeChangeRule myDST = {"EDT", Second, Sun, Mar, 2, -240}; //Daylight time = UTC - 4 hours
TimeChangeRule mySTD = {"EST", First, Sun, Nov, 2, -300}; //Standard time = UTC - 5 hours
Timezone *myTZ;
TimeChangeRule *tcr; //pointer to the time change rule, use to get TZ abbrev
//////////////////////////////////////////
int status = WL_IDLE_STATUS; // the Wifi radio's status
char timeServer[] = "time.nist.gov"; // NTP server
unsigned int localPort = 2390; // local port to listen for UDP packets
const int NTP_PACKET_SIZE = 48; // NTP timestamp is in the first 48 bytes of the message
const int UDP_TIMEOUT = 2000; // timeout in miliseconds to wait for an UDP packet to arrive
byte packetBuffer[NTP_PACKET_SIZE]; // buffer to hold incoming and outgoing packets
// A UDP instance to let us send and receive packets over UDP
WiFiUDP Udp;
datetime_t currTime;
char datetime_buf[256];
// send an NTP request to the time server at the given address
void sendNTPpacket(char *ntpSrv)
{
// set all bytes in the buffer to 0
memset(packetBuffer, 0, NTP_PACKET_SIZE);
// Initialize values needed to form NTP request
// (see URL above for details on the packets)
packetBuffer[0] = 0b11100011; // LI, Version, Mode
packetBuffer[1] = 0; // Stratum, or type of clock
packetBuffer[2] = 6; // Polling Interval
packetBuffer[3] = 0xEC; // Peer Clock Precision
// 8 bytes of zero for Root Delay & Root Dispersion
packetBuffer[12] = 49;
packetBuffer[13] = 0x4E;
packetBuffer[14] = 49;
packetBuffer[15] = 52;
// all NTP fields have been given values, now
// you can send a packet requesting a timestamp:
Udp.beginPacket(ntpSrv, 123); //NTP requests are to port 123
Udp.write(packetBuffer, NTP_PACKET_SIZE);
Udp.endPacket();
}
void getNTPTime()
{
static bool gotCurrentTime = false;
// Just get the correct ime once
if (!gotCurrentTime)
{
sendNTPpacket(timeServer); // send an NTP packet to a time server
// wait to see if a reply is available
delay(1000);
if (Udp.parsePacket())
{
Serial.println(F("Packet received"));
// We've received a packet, read the data from it
Udp.read(packetBuffer, NTP_PACKET_SIZE); // read the packet into the buffer
//the timestamp starts at byte 40 of the received packet and is four bytes,
// or two words, long. First, esxtract the two words:
unsigned long highWord = word(packetBuffer[40], packetBuffer[41]);
unsigned long lowWord = word(packetBuffer[42], packetBuffer[43]);
// combine the four bytes (two words) into a long integer
// this is NTP time (seconds since Jan 1 1900):
unsigned long secsSince1900 = highWord << 16 | lowWord;
Serial.print(F("Seconds since Jan 1 1900 = "));
Serial.println(secsSince1900);
// now convert NTP time into everyday time:
Serial.print(F("Unix time = "));
// Unix time starts on Jan 1 1970. In seconds, that's 2208988800:
const unsigned long seventyYears = 2208988800UL;
// subtract seventy years:
unsigned long epoch = secsSince1900 - seventyYears;
// print Unix time:
Serial.println(epoch);
// Get the time_t from epoch
time_t epoch_t = epoch;
// set the system time to UTC
// warning: assumes that compileTime() returns US EDT
// adjust the following line accordingly if you're in another time zone
setTime(epoch_t);
// Update RTC
// Can use either one of these functions
// 1) DateTime(tmElements_t). Must create tmElements_t if not present
//tmElements_t tm;
//breakTime(epoch_t, tm);
//rtc_set_datetime( DateTime(tm) );
// 2) DateTime(year, month, day, hour, min, sec)
//rtc_set_datetime( DateTime(year(epoch_t), month(epoch_t), day(epoch_t), hour(epoch_t), minute(epoch_t), second(epoch_t) ) );
// 3) DateTime (time_t)
//rtc_set_datetime( DateTime(epoch_t) );
// 4) DateTime(unsigned long epoch). The best and easiest way
//rtc_set_datetime( DateTime((uint32_t) epoch) );
// New function in DateTime_Generic.h
// To be called before while loop to work. Why ???
rtc_set_datetime(DateTime((uint32_t) epoch));
uint8_t loopCount = 0;
while( (loopCount < 10 ) && ( ! rtc_set_datetime(DateTime((uint32_t) epoch)) ) )
{
Serial.println(F("rtc_set_datetime failed"));
sleep_ms(500);
}
// print the hour, minute and second:
Serial.print(F("The UTC time is ")); // UTC is the time at Greenwich Meridian (GMT)
Serial.print((epoch % 86400L) / 3600); // print the hour (86400 equals secs per day)
Serial.print(':');
if (((epoch % 3600) / 60) < 10)
{
// In the first 10 minutes of each hour, we'll want a leading '0'
Serial.print('0');
}
Serial.print((epoch % 3600) / 60); // print the minute (3600 equals secs per minute)
Serial.print(':');
if ((epoch % 60) < 10)
{
// In the first 10 seconds of each minute, we'll want a leading '0'
Serial.print('0');
}
Serial.println(epoch % 60); // print the second
gotCurrentTime = true;
}
else
{
// wait ten seconds before asking for the time again
delay(10000);
}
}
}
//////////////////////////////////////////
// format and print a time_t value, with a time zone appended.
void printDateTime(time_t t, const char *tz)
{
char buf[32];
char m[4]; // temporary storage for month string (DateStrings.cpp uses shared buffer)
strcpy(m, monthShortStr(month(t)));
sprintf(buf, "%.2d:%.2d:%.2d %s %.2d %s %d %s",
hour(t), minute(t), second(t), dayShortStr(weekday(t)), day(t), m, year(t), tz);
Serial.println(buf);
}
void setup()
{
Serial.begin(115200);
while (!Serial && millis() < 5000);
delay(200);
Serial.print(F("\nStart RP2040_RTC_Time_WiFiNINA on ")); Serial.print(BOARD_NAME);
Serial.print(F(" with ")); Serial.println(SHIELD_TYPE);
Serial.println(RP2040_RTC_VERSION);
Serial.println(TIMEZONE_GENERIC_VERSION);
// check for the presence of the shield
if (WiFi.status() == WL_NO_MODULE)
{
Serial.println(F("WiFi shield not present"));
// don't continue
while (true);
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION)
{
Serial.println(F("Please upgrade the firmware"));
}
// attempt to connect to WiFi network
while ( status != WL_CONNECTED)
{
Serial.print(F("Connecting to WPA SSID: "));
Serial.println(ssid);
// Connect to WPA/WPA2 network
status = WiFi.begin(ssid, pass);
}
// you're connected now, so print out the data
Serial.print(F("You're connected to the network, IP = "));
Serial.println(WiFi.localIP());
myTZ = new Timezone(myDST, mySTD);
// Start the RTC
rtc_init();
Udp.begin(localPort);
}
void displayTime()
{
rtc_get_datetime(&currTime);
// Display time from RTC
DateTime now = DateTime(currTime);
time_t utc = now.get_time_t();
time_t local = myTZ->toLocal(utc, &tcr);
printDateTime(utc, "UTC");
printDateTime(local, tcr -> abbrev);
}
void displayRTCTime()
{
static unsigned long displayRTCTime_timeout = 0;
#define DISPLAY_RTC_INTERVAL 60000L
// Send status report every STATUS_REPORT_INTERVAL (60) seconds: we don't need to display frequently.
if ((millis() > displayRTCTime_timeout) || (displayRTCTime_timeout == 0))
{
Serial.println("============================");
displayTime();
displayRTCTime_timeout = millis() DISPLAY_RTC_INTERVAL;
}
}
void loop()
{
// Get time from NTP once, then update RTC
// You certainly can make NTP check every hour/day to update RTC to have better accuracy
getNTPTime();
displayRTCTime();
}

2. File defines.h

#ifndef defines_h
#define defines_h
#define DEBUG_WIFI_WEBSERVER_PORT Serial
// Debug Level from 0 to 4
#define _WIFI_LOGLEVEL_ 1
#define _WIFININA_LOGLEVEL_ 1
#define USE_WIFI_NINA true
//#define USE_WIFI_NINA false
#define RTC_DEBUG false
#if USE_WIFI_NINA
#warning Using WiFiNINA using WiFiNINA_Generic Library
#define SHIELD_TYPE "WiFiNINA using WiFiNINA_Generic Library"
#endif
#if ( defined(ARDUINO_ARCH_RP2040) || defined(ARDUINO_RASPBERRY_PI_PICO) || defined(ARDUINO_ADAFRUIT_FEATHER_RP2040) || defined(ARDUINO_GENERIC_RP2040) )
#if defined(WIFININA_USE_RP2040)
#undef WIFININA_USE_RP2040
#endif
#define WIFININA_USE_RP2040 true
#if defined(ARDUINO_ARCH_MBED)
#if defined(BOARD_NAME)
#undef BOARD_NAME
#endif
#if defined(ARDUINO_NANO_RP2040_CONNECT)
#define BOARD_NAME "MBED NANO_RP2040_CONNECT"
#elif defined(ARDUINO_RASPBERRY_PI_PICO)
#define BOARD_NAME "MBED RASPBERRY_PI_PICO"
#elif defined(ARDUINO_ADAFRUIT_FEATHER_RP2040)
#define BOARD_NAME "MBED DAFRUIT_FEATHER_RP2040"
#elif defined(ARDUINO_GENERIC_RP2040)
#define BOARD_NAME "MBED GENERIC_RP2040"
#else
#define BOARD_NAME "MBED Unknown RP2040"
#endif
#endif
#else
#error This code is designed to run on RP2040 platform! Please check your Tools->Board setting.
#endif
#ifndef BOARD_NAME
#if defined(ARDUINO_BOARD)
#define BOARD_NAME ARDUINO_BOARD
#else
#define BOARD_NAME BOARD_TYPE
#endif
#endif
#include <RP2040_RTC.h>
#include <WiFiNINA_Generic.h>
char ssid[] = "ssid"; // your network SSID (name)
char pass[] = "12345678"; // your network password
#endif //defines_h



Debug Terminal Output Samples

1. RP2040_RTC_Time_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Time_Ethernet on RASPBERRY_PI_PICO with W5100S using Ethernet_Generic Library

Start RP2040_RTC_Time_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] RPIPICO setCsPin: 17
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 10
You're connected to the network, IP = 192.168.2.95
Packet received
Seconds since Jan 1 1900 = 3859851978
Unix time = 1650863178
The UTC time is 5:06:18
============================
05:06:19 Mon 25 Apr 2022 UTC
01:06:19 Mon 25 Apr 2022 EDT

2. RP2040_RTC_Time_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Time_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

Start RP2040_RTC_Time_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] RPIPICO setCsPin: 17
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 1
You're connected to the network, IP = 192.168.2.102
Packet received
Seconds since Jan 1 1900 = 3859851547
Unix time = 1650862747
The UTC time is 4:59:07
============================
04:59:08 Mon 25 Apr 2022 UTC
00:59:08 Mon 25 Apr 2022 EDT
============================
05:00:08 Mon 25 Apr 2022 UTC
01:00:08 Mon 25 Apr 2022 EDT
============================
05:01:08 Mon 25 Apr 2022 UTC
01:01:08 Mon 25 Apr 2022 EDT

3. RP2040_RTC_Time_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Time_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library

Start RP2040_RTC_Time_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
Connecting to WPA SSID: HueNet1
You're connected to the network, IP = 192.168.2.153
Packet received
Seconds since Jan 1 1900 = 3859851547
Unix time = 1650862747
The UTC time is 4:59:07
============================
04:59:08 Mon 25 Apr 2022 UTC
00:59:08 Mon 25 Apr 2022 EDT

4. RP2040_RTC_Alarm_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Alarm_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

4.1. Repeatitive Alarm

Start RP2040_RTC_Alarm_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] RPIPICO setCsPin: 17
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 12
You're connected to the network, IP = 192.168.2.99
Packet received
Seconds since Jan 1 1900 = 3859852325
Unix time = 1650863525
The UTC time is 5:12:05
============================
05:12:06 Mon 25 Apr 2022 UTC
01:12:06 Mon 25 Apr 2022 EDT
Set Repeatitive Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:13:05 Mon 25 Apr 2022 UTC
01:13:05 Mon 25 Apr 2022 EDT
============================
05:13:06 Mon 25 Apr 2022 UTC
01:13:06 Mon 25 Apr 2022 EDT

4.2. One-shot Alarm

Start RP2040_RTC_Alarm_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] Board : RASPBERRY_PI_PICO , setCsPin: 17
_pinCS = 0
W5100 init, using SS_PIN_DEFAULT = 10, new ss_pin = 10, W5100Class::ss_pin = 17
W5100::init: W5500, SSIZE =8192
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 17
You're connected to the network, IP = 192.168.2.101
Packet received
Seconds since Jan 1 1900 = 3859852325
Unix time = 1650863525
The UTC time is 5:12:05
============================
05:12:06 Mon 25 Apr 2022 UTC
01:12:06 Mon 25 Apr 2022 EDT
Set One-time Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:13:05 Mon 25 Apr 2022 UTC
01:13:05 Mon 25 Apr 2022 EDT

5. RP2040_RTC_Alarm_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Alarm_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library

5.1. Repeatitive Alarm

Start RP2040_RTC_Alarm_Ethernet on MBED RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] RPIPICO setCsPin: 17
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 19
You're connected to the network, IP = 192.168.2.104
Packet received
Seconds since Jan 1 1900 = 3859852627
Unix time = 1650863827
The UTC time is 5:17:07
============================
05:17:08 Mon 25 Apr 2022 UTC
01:17:08 Mon 25 Apr 2022 EDT
Set Repeatitive Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:18:05 Mon 25 Apr 2022 UTC
01:18:05 Mon 25 Apr 2022 EDT
============================
05:18:08 Mon 25 Apr 2022 UTC
01:18:08 Mon 25 Apr 2022 EDT

5.2. One-shot Alarm

Start RP2040_RTC_Alarm_Ethernet on RASPBERRY_PI_PICO with W5x00 using Ethernet_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
[EWS] =========== USE_ETHERNET_GENERIC ===========
[EWS] Default SPI pinout:
[EWS] MOSI: 19
[EWS] MISO: 16
[EWS] SCK: 18
[EWS] SS: 17
[EWS] =========================
[EWS] Board : RASPBERRY_PI_PICO , setCsPin: 17
_pinCS = 0
W5100 init, using SS_PIN_DEFAULT = 10, new ss_pin = 10, W5100Class::ss_pin = 17
W5100::init: W5500, SSIZE =8192
=========================
Currently Used SPI pinout:
MOSI:19
MISO:16
SCK:18
SS:17
=========================
Using mac index = 17
You're connected to the network, IP = 192.168.2.101
Packet received
Seconds since Jan 1 1900 = 3859852627
Unix time = 1650863827
The UTC time is 5:17:07
============================
05:17:08 Mon 25 Apr 2022 UTC
01:17:08 Mon 25 Apr 2022 EDT
Set One-time Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:18:05 Mon 25 Apr 2022 UTC
01:18:05 Mon 25 Apr 2022 EDT

6. RP2040_RTC_Alarm_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library

The following is the sample terminal output when running example RP2040_RTC_Alarm_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library

6.1. Repeatitive Alarm

Start RP2040_RTC_Alarm_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
Connecting to WPA SSID: HueNet1
You're connected to the network, IP = 192.168.2.125
Packet received
Seconds since Jan 1 1900 = 3859852627
Unix time = 1650863827
The UTC time is 5:17:07
============================
05:17:08 Mon 25 Apr 2022 UTC
01:17:08 Mon 25 Apr 2022 EDT
Set Repeatitive Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:18:05 Mon 25 Apr 2022 UTC
01:18:05 Mon 25 Apr 2022 EDT
============================
05:18:08 Mon 25 Apr 2022 UTC
01:18:08 Mon 25 Apr 2022 EDT

6.2. One-shot Alarm

Start RP2040_RTC_Alarm_WiFiNINA on MBED NANO_RP2040_CONNECT with WiFiNINA using WiFiNINA_Generic Library
RP2040_RTC v1.1.1
Timezone_Generic v1.10.0
Connecting to WPA SSID: HueNet1
You're connected to the network, IP = 192.168.2.125
Packet received
Seconds since Jan 1 1900 = 3859852627
Unix time = 1650863827
The UTC time is 5:17:07
============================
05:17:08 Mon 25 Apr 2022 UTC
01:17:08 Mon 25 Apr 2022 EDT
Set One-time Alarm @ alarmSeconds = 5
============================
Alarm @ 
05:18:05 Mon 25 Apr 2022 UTC
01:18:05 Mon 25 Apr 2022 EDT


Troubleshooting

If you get compilation errors, more often than not, you may need to install a newer version of the core for Arduino boards.

Sometimes, the library will only work if you update the board core to the latest version because I am using newly added functions.



Issues

Submit issues to: RP2040_RTC issues


TO DO

  1. Search for bug and improvement.

DONE

  1. Basic RTC-wrapper library for RP2040-based boards, such as NANO_RP2040_CONNECT, RASPBERRY_PI_PICO, ADAFRUIT_FEATHER_RP2040 and GENERIC_RP2040, using Arduino-mbed RP2040 core or Earle Philhower's arduino-pico core.
  2. Add Version String
  3. Add Table of Contents
  4. Add simple examples with manual time input
  5. Use new Ethernet_Generic library as default for W5x00.
  6. Add support to SPI1 for RP2040 using Earle Philhower's arduino-pico core
  7. Add support to WIZNet W5100S, such as WIZnet Ethernet HAT and W5100S-EVB-Pico
  8. Add support to RP2040W using CYW43439 WiFi with Earle Philhower's arduino-pico core


Contributions and Thanks

Many thanks for everyone for bug reporting, new feature suggesting, testing and contributing to the development of this library.

  1. Thanks to kenb2054 to report bugs in Libraries updated to support new RP2040-based boards (RASPBERRY_PI_PICO, etc.) #43 leading to v1.0.4
  2. Thanks to josephchrzempiec to report bugs leading to v1.0.5
  3. Thanks to Maximilian Gerhardt
kenb2054
kenb2054

josephchrzempiec
josephchrzempiec

maxgerhardt
⭐️ Maximilian Gerhardt


Contributing

If you want to contribute to this project:

  • Report bugs and errors
  • Ask for enhancements
  • Create issues and pull requests
  • Tell other people about this library

License

  • The library is licensed under MIT

Copyright

Copyright 2021- Khoi Hoang