aboutsummaryrefslogtreecommitdiffstats
path: root/os/hal/src/hal_rng.c
diff options
context:
space:
mode:
authorbarthess <barthess@yandex.ru>2016-04-07 16:39:12 +0300
committerbarthess <barthess@yandex.ru>2016-04-07 16:39:12 +0300
commit9d74dd2661b80a5ae8598591f0251b197cc51756 (patch)
tree0c833cbd2f4cf5845358ee0f37fbb3f95b7a447b /os/hal/src/hal_rng.c
parentb86af2c09feea9b50cb241c147a3881e55763a55 (diff)
downloadChibiOS-Contrib-9d74dd2661b80a5ae8598591f0251b197cc51756.tar.gz
ChibiOS-Contrib-9d74dd2661b80a5ae8598591f0251b197cc51756.tar.bz2
ChibiOS-Contrib-9d74dd2661b80a5ae8598591f0251b197cc51756.zip
STM32 mass update to current naming convention in ChibiOS
Diffstat (limited to 'os/hal/src/hal_rng.c')
-rw-r--r--os/hal/src/hal_rng.c182
1 files changed, 182 insertions, 0 deletions
diff --git a/os/hal/src/hal_rng.c b/os/hal/src/hal_rng.c
new file mode 100644
index 0000000..5ff6d2d
--- /dev/null
+++ b/os/hal/src/hal_rng.c
@@ -0,0 +1,182 @@
+/*
+ RNG for ChibiOS - Copyright (C) 2016 Stephane D'Alu
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+*/
+
+/*
+ * Hardware Abstraction Layer for RNG Unit
+ */
+#include "hal.h"
+
+#if (HAL_USE_RNG == TRUE) || defined(__DOXYGEN__)
+
+/*===========================================================================*/
+/* Driver local definitions. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver exported variables. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver local variables and types. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver local functions. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver exported functions. */
+/*===========================================================================*/
+
+/**
+ * @brief RNG Driver initialization.
+ *
+ * @init
+ */
+void rngInit(void) {
+ rng_lld_init();
+}
+
+/**
+ * @brief Initializes the standard part of a @p RNGDriver structure.
+ *
+ * @param[out] rngp Pointer to the @p RNGDriver object
+ *
+ * @init
+ */
+void rngObjectInit(RNGDriver *rngp) {
+ rngp->state = RNG_STOP;
+ rngp->config = NULL;
+#if RNG_USE_MUTUAL_EXCLUSION == TRUE
+ osalMutexObjectInit(&rngp->mutex);
+#endif
+#if defined(RNG_DRIVER_EXT_INIT_HOOK)
+ RNG_DRIVER_EXT_INIT_HOOK(rngp);
+#endif
+}
+
+/**
+ * @brief Configures and activates the RNG peripheral.
+ *
+ * @param[in] rngp Pointer to the @p RNGDriver object
+ * @param[in] config Pointer to the @p RNGConfig object
+ * @p NULL if the low level driver implementation
+ * supports a default configuration
+ *
+ * @api
+ */
+void rngStart(RNGDriver *rngp, const RNGConfig *config) {
+ osalDbgCheck(rngp != NULL);
+
+ osalSysLock();
+ osalDbgAssert((rngp->state == RNG_STOP) || (rngp->state == RNG_READY),
+ "invalid state");
+ rngp->config = config;
+ rng_lld_start(rngp);
+ rngp->state = RNG_READY;
+ osalSysUnlock();
+}
+
+/**
+ * @brief Deactivates the RNG peripheral.
+ *
+ * @param[in] rngp Pointer to the @p RNGDriver object
+ *
+ * @api
+ */
+void rngStop(RNGDriver *rngp) {
+ osalDbgCheck(rngp != NULL);
+
+ osalSysLock();
+ osalDbgAssert((rngp->state == RNG_STOP) || (rngp->state == RNG_READY),
+ "invalid state");
+ rng_lld_stop(rngp);
+ rngp->state = RNG_STOP;
+ osalSysUnlock();
+}
+
+/**
+ * @brief Write random bytes
+ * @details Write the request number of bytes..
+ *
+ * @param[in] rngp pointer to the @p RNGDriver object
+ * @param[in] buf the pointer to the buffer
+ * @param[in] n number of bytes to send
+ * @param[in] timeout timeout value
+ *
+ * @api
+ */
+msg_t rngWrite(RNGDriver *rngp, uint8_t *buf, size_t n, systime_t timeout) {
+ msg_t msg;
+ osalSysLock();
+ msg = rngWriteI(rngp, buf, n, timeout);
+ osalSysUnlock();
+ return msg;
+}
+
+/**
+ * @brief Write random bytes
+ * @details Write the request number of bytes..
+ *
+ * @param[in] rngp pointer to the @p RNGDriver object
+ * @param[in] buf the pointer to the buffer
+ * @param[in] n number of bytes to send
+ * @param[in] timeout timeout value
+ *
+ * @iclass
+ */
+msg_t rngWriteI(RNGDriver *rngp, uint8_t *buf, size_t n, systime_t timeout) {
+ osalDbgCheck((rngp != NULL) && (n > 0U) && (buf != NULL));
+ osalDbgAssert(rngp->state == RNG_READY, "not ready");
+ return rng_lld_write(rngp, buf, n, timeout);
+}
+
+
+#if (RNG_USE_MUTUAL_EXCLUSION == TRUE) || defined(__DOXYGEN__)
+/**
+ * @brief Gains exclusive access to the RNG unit.
+ * @details This function tries to gain ownership to the RNG, if the RNG is
+ * already being used then the invoking thread is queued.
+ * @pre In order to use this function the option @p RNG_USE_MUTUAL_EXCLUSION
+ * must be enabled.
+ *
+ * @param[in] rngp pointer to the @p RNGDriver object
+ *
+ * @api
+ */
+void rngAcquireUnit(RNGDriver *rngp) {
+ osalDbgCheck(rngp != NULL);
+
+ osalMutexLock(&rngp->mutex);
+}
+
+/**
+ * @brief Releases exclusive access to the RNG unit.
+ * @pre In order to use this function the option @p RNG_USE_MUTUAL_EXCLUSION
+ * must be enabled.
+ *
+ * @param[in] rngp pointer to the @p RNGDriver object
+ *
+ * @api
+ */
+void rngReleaseUnit(RNGDriver *rngp) {
+ osalDbgCheck(rngp != NULL);
+
+ osalMutexUnlock(&rngp->mutex);
+}
+#endif /* RNG_USE_MUTUAL_EXCLUSION == TRUE */
+
+#endif /* HAL_USE_RNG */