Add the Labs projects provided in the V10.2.1_191129 zip file.

[freertos] / FreeRTOS-Labs / Source / FreeRTOS-Plus-FAT / include / ff_time.h

diff --git a/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/include/ff_time.h b/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/include/ff_time.h
new file mode 100644 (file)
index 0000000..06f26bd
--- /dev/null
+++ b/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/include/ff_time.h
@@ -0,0 +1,86 @@
+/*\r
+ * FreeRTOS+FAT build 191128 - Note:  FreeRTOS+FAT is still in the lab!\r
+ * Copyright (C) 2018 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
+ * Authors include James Walmsley, Hein Tibosch and Richard Barry\r
+ *\r
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
+ * this software and associated documentation files (the "Software"), to deal in\r
+ * the Software without restriction, including without limitation the rights to\r
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
+ * the Software, and to permit persons to whom the Software is furnished to do so,\r
+ * subject to the following conditions:\r
+ *\r
+ * The above copyright notice and this permission notice shall be included in all\r
+ * copies or substantial portions of the Software.\r
+ *\r
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
+ *\r
+ * https://www.FreeRTOS.org\r
+ *\r
+ */\r
+\r
+/**\r
+ *     @file           ff_time.h\r
+ *     @ingroup        TIME\r
+ *\r
+ *     Provides a means for receiving the time on any platform.\r
+ **/\r
+\r
+#ifndef _FF_TIME_H_\r
+#define _FF_TIME_H_\r
+\r
+#include <time.h>\r
+\r
+#include "FreeRTOSFATConfig.h"\r
+\r
+/* _HT_\r
+The following declarations and functions may be moved to a common directory?\r
+ */\r
+typedef struct xTIME_STRUCT\r
+{\r
+       int tm_sec;   /* Seconds */\r
+       int tm_min;   /* Minutes */\r
+       int tm_hour;  /* Hour (0--23) */\r
+       int tm_mday;  /* Day of month (1--31) */\r
+       int tm_mon;   /* Month (0--11) */\r
+       int tm_year;  /* Year (calendar year minus 1900) */\r
+       int tm_wday;  /* Weekday (0--6; Sunday = 0) */\r
+       int tm_yday;  /* Day of year (0--365) */\r
+       int tm_isdst; /* 0 if daylight savings time is not in effect) */\r
+} FF_TimeStruct_t;\r
+\r
+/* Equivalent of time() : returns the number of seconds after 1-1-1970. */\r
+time_t FreeRTOS_time( time_t *pxTime );\r
+\r
+/* Equivalent of mktime() : calculates the number of seconds after 1-1-1970. */\r
+time_t FreeRTOS_mktime( const FF_TimeStruct_t *pxTimeBuf );\r
+\r
+/* Equivalent of gmtime_r() : Fills a 'struct tm'. */\r
+FF_TimeStruct_t *FreeRTOS_gmtime_r( const time_t *pxTime, FF_TimeStruct_t *pxTimeBuf );\r
+\r
+/**\r
+ *     @public\r
+ *     @brief  A TIME and DATE object for FreeRTOS+FAT. A FreeRTOS+FAT time driver must populate these values.\r
+ *\r
+ **/\r
+typedef struct\r
+{\r
+       uint16_t Year;          /* Year (e.g. 2009). */\r
+       uint16_t Month;         /* Month        (e.g. 1 = Jan, 12 = Dec). */\r
+       uint16_t Day;           /* Day  (1 - 31). */\r
+       uint16_t Hour;          /* Hour (0 - 23). */\r
+       uint16_t Minute;        /* Min  (0 - 59). */\r
+       uint16_t Second;        /* Second       (0 - 59). */\r
+} FF_SystemTime_t;\r
+\r
+/*---------- PROTOTYPES */\r
+\r
+int32_t        FF_GetSystemTime(FF_SystemTime_t *pxTime);\r
+\r
+#endif\r
+\r