rtc: Add functions and tests for time conversion

To implement rtc driver for some ec chips, we
need to convert between calandar date and seconds
(since epoch time, 01-01-1970 00:00:00).

Sicne these functions are HW-independent, let's add
common/rtc.c, include/rtc.h, and unit test for this.

BUG=b:63908519
BRANCH=none
TEST=make buildall test -j

Change-Id: Icb1e768d2b3674d5225b83e09475e984eb104d06
Signed-off-by: Philip Chen <philipchen@google.com>
Reviewed-on: https://chromium-review.googlesource.com/666985
Commit-Ready: Philip Chen <philipchen@chromium.org>
Tested-by: Philip Chen <philipchen@chromium.org>
Reviewed-by: Shawn N <shawnn@chromium.org>
Reviewed-by: Brian Norris <briannorris@chromium.org>

4 files changed, 127 insertions, 0 deletions

diff --git a/test/build.mk b/test/build.mk
index ba4a2c6966..20a55fb3fc 100644
--- a/test/build.mk
+++ b/test/build.mk
@@ -66,6 +66,7 @@ test-list-host += queue
 test-list-host += rma_auth
 test-list-host += rsa
 test-list-host += rsa3
+test-list-host += rtc
 test-list-host += sbs_charging_v2
 test-list-host += sha256
 test-list-host += sha256_unrolled
@@ -116,6 +117,7 @@ queue-y=queue.o
 rma_auth-y=rma_auth.o
 rsa-y=rsa.o
 rsa3-y=rsa.o
+rtc-y=rtc.o
 sbs_charging-y=sbs_charging.o
 sbs_charging_v2-y=sbs_charging_v2.o
 sha256-y=sha256.o
diff --git a/test/rtc.c b/test/rtc.c
new file mode 100644
index 0000000000..5d16d3008c
--- /dev/null
+++ b/test/rtc.c
@@ -0,0 +1,104 @@
+/* Copyright 2017 The Chromium OS Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ *
+ * Tests for rtc time conversions
+ */
+
+#include "console.h"
+#include "common.h"
+#include "rtc.h"
+#include "test_util.h"
+#include "util.h"
+
+/* Known conversion pairs of date and epoch time. */
+static struct {
+	struct calendar_date time;
+	uint32_t sec;
+} test_case[] = {
+	{{8, 3, 1}, 1204329600},
+	{{17, 10, 1}, 1506816000},
+};
+
+static int calendar_time_comp(struct calendar_date time_1,
+			   struct calendar_date time_2)
+{
+	return (time_1.year == time_2.year &&
+		time_1.month == time_2.month &&
+		time_1.day == time_2.day);
+}
+
+static int test_time_conversion(void)
+{
+	struct calendar_date time_1;
+	struct calendar_date time_2;
+	uint32_t sec;
+	int i;
+
+	/* The seconds elapsed from 01-01-1970 to 01-01-2000 */
+	sec = SECS_TILL_YEAR_2K;
+	time_1.year = 0;
+	time_1.month = 1;
+	time_1.day = 1;
+
+	/* Test from year 2000 to 2050 */
+	for (i = 0; i <= 50; i++) {
+		/* Test Jan. 1 */
+		time_1.year = i;
+		time_1.month = 1;
+		time_1.day = 1;
+
+		TEST_ASSERT(date_to_sec(time_1) == sec);
+		time_2 = sec_to_date(sec);
+		TEST_ASSERT(calendar_time_comp(time_1, time_2));
+
+		/* Test the day boundary between Jan. 1 and Jan. 2 */
+		time_2 = sec_to_date(sec + SECS_PER_DAY - 1);
+		TEST_ASSERT(calendar_time_comp(time_1, time_2));
+
+		time_1.day = 2;
+
+		TEST_ASSERT(date_to_sec(time_1) == sec + SECS_PER_DAY);
+		time_2 = sec_to_date(sec + SECS_PER_DAY);
+		TEST_ASSERT(calendar_time_comp(time_1, time_2));
+
+		/*
+		 * Test the month boundary and leap year:
+		 * Is the 60th day of a year Mar. 1 or Feb. 29?
+		 */
+		time_2 = sec_to_date(sec + 59 * SECS_PER_DAY);
+		if (IS_LEAP_YEAR(i))
+			TEST_ASSERT(time_2.month == 2 && time_2.day == 29);
+		else
+			TEST_ASSERT(time_2.month == 3 && time_2.day == 1);
+
+		/* Test the year boundary on Dec. 31 */
+		sec += SECS_PER_YEAR - (IS_LEAP_YEAR(i) ? 0 : SECS_PER_DAY);
+		time_1.month = 12;
+		time_1.day = 31;
+
+		TEST_ASSERT(date_to_sec(time_1) == sec);
+		time_2 = sec_to_date(sec);
+		TEST_ASSERT(calendar_time_comp(time_1, time_2));
+
+		sec += SECS_PER_DAY;
+		time_2 = sec_to_date(sec - 1);
+		TEST_ASSERT(calendar_time_comp(time_1, time_2));
+	}
+
+	/* Verify known test cases */
+	for (i = 0; i < ARRAY_SIZE(test_case); i++) {
+		TEST_ASSERT(date_to_sec(test_case[i].time) == test_case[i].sec);
+		time_1 = sec_to_date(test_case[i].sec);
+		TEST_ASSERT(calendar_time_comp(time_1, test_case[i].time));
+	}
+
+	return EC_SUCCESS;
+}
+
+void run_test(void)
+{
+	RUN_TEST(test_time_conversion);
+
+	test_print_result();
+}
diff --git a/test/rtc.tasklist b/test/rtc.tasklist
new file mode 100644
index 0000000000..e76178ba0a
--- /dev/null
+++ b/test/rtc.tasklist
@@ -0,0 +1,17 @@
+/* Copyright 2017 The Chromium OS Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+/**
+ * List of enabled tasks in the priority order
+ *
+ * The first one has the lowest priority.
+ *
+ * For each task, use the macro TASK_TEST(n, r, d, s) where :
+ * 'n' in the name of the task
+ * 'r' in the main routine of the task
+ * 'd' in an opaque parameter passed to the routine at startup
+ * 's' is the stack size in bytes; must be a multiple of 8
+ */
+#define CONFIG_TEST_TASK_LIST
diff --git a/test/test_config.h b/test/test_config.h
index 31d5679d05..23d836ffd9 100644
--- a/test/test_config.h
+++ b/test/test_config.h
@@ -230,6 +230,10 @@ enum nvmem_vars {
 #define CONFIG_FLASH_NVMEM_VARS_USER_SIZE 600
 #endif	/* TEST_NVMEM_VARS */
 
+#ifdef TEST_RTC
+#define CONFIG_HOSTCMD_RTC
+#endif
+
 #ifdef TEST_VBOOT
 #define CONFIG_RWSIG
 #define CONFIG_SHA256