Mainline:Broadcom Kona/BCM590xx/RTC

Downstream driver: drivers/rtc/rtc-bcmpmu59xxx.c

The BCM590XX PMUs provide a real-time clock.

Time data

The RTC stores the time in the following format:

Offset	Purpose	Value
0	Second	Current second, from 0 to 59.
1	Minute	Current minute of the hour, from 0 to 59.
2	Hour	Current hour of the day, from 0 to 23.
3	Day of month	Day of month, starting from 0.
4	Month	Number of the month. Sets itself to 0 on reset; 1 to 12 represent January-December. ...or does it? The downstream driver would suggest so, but it seems weird. Investigate.
5	Year	Amount of years since 2000 (0 = 2000, 1 = 2001, etc.)

This exact format is used for both the time and alarm registers.

TODO: What happens on year overflow? Is there a reason as to why the downstream driver limits the values it gets?

Getting the time

On the BCM59054 and BCM59056, time registers start at 0xE0 and follow the format outlined above.

There are interrupts for updates of each of the time values.

Alarm

On the BCM59054 and BCM59056, the alarm registers start at 0xE7.

There is an interrupt that is triggered when the alarm is triggered.

Calibration

Downstream driver: drivers/char/broadcom/rtc_cal/bcm_rtc_cal.c

There are three calibration registers: CALIB1, CALIB2 and CALIB3.

TODO	TODO: Figure out how the calibration process works, this is just my initial idea

Calibration appears to be triggered based on a CP (communications processor) event; it receives a message from the CP and uses a value from it as the "ratio". The ratio value is then compared against RTCCAL_Ratio (taken from rtccal_data.nom_ratio, 8666667); if ratio > RTCCAL_Ratio, then direction is 1, otherwise it's 0.

The clk_val value is then calculated based on the difference between the new and old ratio (diff = abs(ratio - RTCCAL_Ratio)): clk_val = RTCCAL_Ratio / diff.

TODO - what is the ratio value?

CALIB1 (0xF4)

Name	Bit	Description
clk_val (1)	7:0	Lower 8 bits of the calibration offset.

CALIB2 (0xF5)

Name	Bit	Description
clk_val (2)	7:0	Upper 8 bits of the calibration offset.

CALIB3 (0xF6)

Name	Bit	Description
???	7	Set to 1 during calibration.
direction	6
Unknown/reserved	5:0	Unknown/reserved.