Use custom datetime

[dbgen1]

Description

This change makes it easier for developers to interact with the RV3028 driver in a number of ways by overhauling date/time setting. This PR does the following:

Adds custom basic classes for handling date and time, namely date, time, and datetime. The eventual goal is to add support for iso8601-formatted string parsing into these classes, to make it simple for users to set the time and date of the satellite. With the current changes, instead of having to create and pass arbitrary looking tuples for the date and time, users can create a date or time object.

In addition, the driver has been modified to no longer keep track of weekdays. Realistically, there is no case for our purposes where a weekday is needed, so removing the calculation and storing of weekdays removes some overhead.

Previously:

rtc.set_time(1, 12, 14) # hour, day, second
rtc.set_date(25, 2, 22, 4) # year, month, day, weekday

Now, this same functionality can be achieved with:

rtc.time = dt.time(hour=4, minute=12, second=14)
rtc.date = dt.date(year=2025, month=2, day=22)

And planned for the future:

rtc.date, rtc.time = dt.datetime.fromsioformat("2025-02-22T09:52:07.000Z")

This system is more easily readable and understandable, and has better flexibility than before. It also performs error checking, accounts for year offsets and manages weekdays for the user automatically.

Testing

• This code has been tested using a slew of new unit tests, at 98% code coverage.
• This code has been tested on hardware.

Future plans

• Implement support for iso8601 formatted strings
• Update the alarm system to use this format
• Add operator overloading for time, date, and datetime.

Note

The initial goal of this PR was to use the adafruit_datetime library, but it turned out that was too heavy on memory usage for the RP2040 in conjunction with the satellite code. The custom datetime library is intended to strip away unneeded information like time zone info, timedeltas, and more.

[dbgen1]

@Mikefly123 If you have time, I would love to get your feedback on this change as well!

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
98.5% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud