From 50adb3cecdf21c351cf7b9559733c00a1facdf38 Mon Sep 17 00:00:00 2001 From: Stewart Smith Date: Thu, 11 Jun 2015 09:20:25 +1000 Subject: Update OPAL_RTC_READ and OPAL_RTC_WRITE documentation to include BCD format Signed-off-by: Stewart Smith --- doc/opal-api/opal-rtc-read-3.txt | 13 +++++++++++-- doc/opal-api/opal-rtc-write-4.txt | 2 ++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/opal-rtc-read-3.txt b/doc/opal-api/opal-rtc-read-3.txt index da6813a..70f9520 100644 --- a/doc/opal-api/opal-rtc-read-3.txt +++ b/doc/opal-api/opal-rtc-read-3.txt @@ -4,8 +4,17 @@ OPAL_RTC_READ Read the Real Time Clock. Parameters: - uint32_t* year_month_day - uint64_t* hour_minute_second_millisecond + uint32_t* year_month_day: the year, month and day formatted as follows: + - bits 0-15 is bcd formatted year (0100-9999) + - bits 16-23 is bcd formatted month (01-12) + - bits 24-31 is bcd formatted day (01-31) + uint64_t* hour_minute_second_millisecond: the hour, minute, second + and millisecond formatted as follows: + - bits 0-16 is reserved + - bits 17-24 is bcd formatted hour (00-23) + - bits 25-31 is bcd formatted minute (00-59) + - bits 32-39 is bcd formatted second (00-60) + - bits 40-63 is bcd formatted milliseconds (000000-999999) Calling: diff --git a/doc/opal-api/opal-rtc-write-4.txt b/doc/opal-api/opal-rtc-write-4.txt index d90c54a..37ca915 100644 --- a/doc/opal-api/opal-rtc-write-4.txt +++ b/doc/opal-api/opal-rtc-write-4.txt @@ -5,3 +5,5 @@ OPAL_RTC_WRITE is much like OPAL_RTC_READ in that it can be asynchronous. If multiple WRITES are issued before the first one completes, subsequent writes are ignored. There can only be one write in flight at any one time. + +Format of the time is the same as for OPAL_RTC_READ. -- cgit v1.1