first commit for opensource

2019-09-16 13:19:50 +08:00
parent 08ab013b8e
commit edb2879617
6303 changed files with 5472815 additions and 23 deletions
--- a/kernel/core/include/tos_time.h
+++ b/kernel/core/include/tos_time.h
@@ -0,0 +1,93 @@
+#ifndef _TOS_TIME_H_
+#define  _TOS_TIME_H_
+
+// if you wanna pend for something forever, use TOS_TIME_FOREVER
+#define TOS_TIME_FOREVER            (k_tick_t)(-1)
+// if you don't wanna wait when you pend nothing, use TOS_TIME_NOWAIT
+#define TOS_TIME_NOWAIT             (k_tick_t)0u
+
+// those two are not for you, for kernel only.
+#define K_TIME_MILLISEC_PER_SEC     1000u
+#define K_TIME_MAX                      (k_tick_t)(TOS_TIME_FOREVER - 1)
+
+/**
+ * @brief Get system tick.
+ * Get the number of ticks since boot.
+ *
+ * @attention None
+ *
+ * @param   None
+ *
+ * @return  tick count since boot
+ */
+__API__ k_tick_t    tos_systick_get(void);
+
+/**
+ * @brief Set system tick.
+ * Set the number of ticks.
+ *
+ * @attention None
+ *
+ * @param   tick        systick count to set
+ *
+ * @return  tick count since boot
+ */
+__API__ void        tos_systick_set(k_tick_t tick);
+
+/**
+ * @brief Convert ticks to milliseconds.
+ * Convert tick to millisecond.
+ *
+ * @attention None
+ *
+ * @param[in]   tick        tick to convert.
+ *
+ * @return  milliseconds equals to the ticks.
+ */
+__API__ k_time_t    tos_tick2millisec(k_tick_t tick);
+
+/**
+ * @brief Convert milliseconds to ticks.
+ * Convert milliseconds to ticks.
+ *
+ * @attention None
+ *
+ * @param[in]   millisec    millisecond to convert.
+ *
+ * @return  ticks equals to the millisecond.
+ */
+__API__ k_tick_t    tos_millisec2tick(k_time_t millisec);
+
+/**
+ * @brief Sleep current task.
+ * Sleep for a specified amount of milliseconds.
+ *
+ * @attention None
+ *
+ * @param[in]   millisec    amount of milliseconds to delay.
+ *
+ * @return  errcode
+ * @retval  #K_ERR_DELAY_ZERO   millisec is zero.
+ * @retval  #K_ERR_NONE         return successfully.
+ */
+__API__ k_err_t     tos_sleep_ms(k_time_t millisec);
+
+/**
+ * @brief Sleep current task.
+ * Sleep for a specified amount of time.
+ *
+ * @attention None
+ *
+ * @param[in]   hour        amount of hours.
+ * @param[in]   minute      amount of minutes.
+ * @param[in]   second      amount of seconds.
+ * @param[in]   millisec    amount of milliseconds.
+ *
+ * @return  errcode
+ * @retval  #K_ERR_DELAY_ZERO     time is zero.
+ * @retval  #K_ERR_NONE           return successfully.
+ */
+__API__ k_err_t     tos_sleep_hmsm(k_time_t hour, k_time_t minute, k_time_t second, k_time_t millisec);
+
+#endif /* _TOS_TIME_H_ */
+