cc310_backend_rng.c 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257
  1. /**
  2. * Copyright (c) 2018 - 2020, Nordic Semiconductor ASA
  3. *
  4. * All rights reserved.
  5. *
  6. * Redistribution and use in source and binary forms, with or without modification,
  7. * are permitted provided that the following conditions are met:
  8. *
  9. * 1. Redistributions of source code must retain the above copyright notice, this
  10. * list of conditions and the following disclaimer.
  11. *
  12. * 2. Redistributions in binary form, except as embedded into a Nordic
  13. * Semiconductor ASA integrated circuit in a product or a software update for
  14. * such product, must reproduce the above copyright notice, this list of
  15. * conditions and the following disclaimer in the documentation and/or other
  16. * materials provided with the distribution.
  17. *
  18. * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
  19. * contributors may be used to endorse or promote products derived from this
  20. * software without specific prior written permission.
  21. *
  22. * 4. This software, with or without modification, must only be used with a
  23. * Nordic Semiconductor ASA integrated circuit.
  24. *
  25. * 5. Any software provided in binary form under this license must not be reverse
  26. * engineered, decompiled, modified and/or disassembled.
  27. *
  28. * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
  29. * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  30. * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
  31. * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
  32. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  33. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
  34. * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  35. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  36. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  37. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38. *
  39. */
  40. #include "sdk_common.h"
  41. #if NRF_MODULE_ENABLED(NRF_CRYPTO)
  42. #if NRF_MODULE_ENABLED(NRF_CRYPTO_BACKEND_CC310)
  43. #if NRF_MODULE_ENABLED(NRF_CRYPTO_BACKEND_CC310_RNG)
  44. #include "nrf_crypto_error.h"
  45. #include "nrf_log.h"
  46. #include "cc310_backend_mutex.h"
  47. #include "cc310_backend_rng.h"
  48. #include "crys_rnd.h"
  49. #include "crys_rnd_error.h"
  50. #include "cc310_backend_shared.h"
  51. static ret_code_t result_get(CRYSError_t err_code)
  52. {
  53. ret_code_t ret_val;
  54. switch (err_code)
  55. {
  56. case CRYS_OK:
  57. ret_val = NRF_SUCCESS;
  58. break;
  59. case CRYS_RND_ILLEGAL_PARAMETER_ERROR:
  60. ret_val = NRF_ERROR_CRYPTO_INVALID_PARAM;
  61. break;
  62. case CRYS_RND_INIT_FAILED:
  63. case CRYS_RND_STARTUP_FAILED:
  64. case CRYS_RND_INSTANTIATION_ERROR:
  65. ret_val = NRF_ERROR_CRYPTO_RNG_INIT_FAILED;
  66. break;
  67. case CRYS_RND_IS_NOT_SUPPORTED:
  68. case CRYS_RND_CAN_NOT_GENERATE_RAND_IN_RANGE:
  69. case CRYS_RND_TRNG_KAT_NOT_SUPPORTED_ERROR:
  70. case CRYS_RND_SRAM_NOT_SUPPORTED_ERROR:
  71. case CRYS_RND_OPERATION_IS_NOT_SUPPORTED_ERROR:
  72. ret_val = NRF_ERROR_CRYPTO_FEATURE_UNAVAILABLE;
  73. break;
  74. case CRYS_RND_DATA_OUT_POINTER_INVALID_ERROR:
  75. case CRYS_RND_VECTOR_OUT_PTR_ERROR:
  76. ret_val = NRF_ERROR_CRYPTO_OUTPUT_NULL;
  77. break;
  78. case CRYS_RND_ADDITIONAL_INPUT_BUFFER_NULL:
  79. case CRYS_RND_WORK_BUFFER_PTR_INVALID_ERROR:
  80. case CRYS_RND_ILLEGAL_DATA_PTR_ERROR:
  81. ret_val = NRF_ERROR_CRYPTO_INPUT_NULL;
  82. break;
  83. case CRYS_RND_DATA_SIZE_OVERFLOW_ERROR:
  84. case CRYS_RND_ADDITIONAL_INPUT_SIZE_ERROR:
  85. case CRYS_RND_ILLEGAL_DATA_SIZE_ERROR:
  86. case CRYS_RND_MAX_VECTOR_IS_TOO_SMALL_ERROR:
  87. ret_val = NRF_ERROR_CRYPTO_INPUT_LENGTH;
  88. break;
  89. case CRYS_RND_ILLEGAL_AES_KEY_SIZE_ERROR:
  90. case CRYS_RND_VECTOR_OUT_SIZE_ERROR:
  91. case CRYS_RND_VECTOR_SIZE_ERROR:
  92. ret_val = NRF_ERROR_CRYPTO_OUTPUT_LENGTH;
  93. break;
  94. case CRYS_RND_CONTEXT_PTR_INVALID_ERROR:
  95. case CRYS_RND_STATE_PTR_INVALID_ERROR:
  96. ret_val = NRF_ERROR_CRYPTO_CONTEXT_NULL;
  97. break;
  98. case CRYS_RND_INSTANTIATION_NOT_DONE_ERROR:
  99. ret_val = NRF_ERROR_CRYPTO_CONTEXT_NOT_INITIALIZED;
  100. break;
  101. case CRYS_RND_RESEED_COUNTER_OVERFLOW_ERROR:
  102. ret_val = NRF_ERROR_CRYPTO_RNG_RESEED_REQUIRED;
  103. break;
  104. case CRYS_RND_CPRNG_TEST_FAIL_ERROR:
  105. case CRYS_RND_TRNG_LOSS_SAMPLES_ERROR:
  106. case CRYS_RND_TRNG_TIME_EXCEED_ERROR:
  107. case CRYS_RND_TRNG_LOSS_SAMPLES_AND_TIME_EXCEED_ERROR:
  108. case CRYS_RND_IS_KAT_MODE_ERROR:
  109. case CRYS_RND_STATE_VALIDATION_TAG_ERROR:
  110. case CRYS_RND_GEN_VECTOR_FUNC_ERROR:
  111. case CRYS_RND_TRNG_ERRORS_ERROR:
  112. case CRYS_RND_KAT_DATA_PARAMS_ERROR:
  113. case CRYS_RND_AES_ERROR:
  114. default:
  115. ret_val = NRF_ERROR_CRYPTO_INTERNAL;
  116. break;
  117. }
  118. return ret_val;
  119. }
  120. ret_code_t nrf_crypto_rng_backend_init(void * const p_context,
  121. void * const p_temp_buffer)
  122. {
  123. bool mutex_locked;
  124. CRYSError_t err_code;
  125. ret_code_t ret_val;
  126. CRYS_RND_WorkBuff_t * p_work_buffer = (CRYS_RND_WorkBuff_t *)p_temp_buffer;
  127. nrf_crypto_backend_rng_context_t * p_ctx = (nrf_crypto_backend_rng_context_t *)p_context;
  128. // Save time by not reinitializing an already valid CC310 RNG context.
  129. // (Useful for example in case the context was stored in retained memory during system OFF.)
  130. if (p_ctx->header.init_value == NRF_CRYPTO_RNG_CONTEXT_INIT_MAGIC_VALUE)
  131. {
  132. return NRF_SUCCESS;
  133. }
  134. mutex_locked = cc310_backend_mutex_trylock();
  135. VERIFY_TRUE(mutex_locked, NRF_ERROR_CRYPTO_BUSY);
  136. err_code = CRYS_RndInit(&p_ctx->crys_rnd_state, p_work_buffer);
  137. ret_val = result_get(err_code);
  138. cc310_backend_mutex_unlock();
  139. return ret_val;
  140. }
  141. ret_code_t nrf_crypto_rng_backend_uninit(void * const p_context)
  142. {
  143. bool mutex_locked;
  144. CRYSError_t err_code;
  145. ret_code_t ret_val;
  146. CRYS_RND_State_t * p_crys_rnd_state =
  147. &((nrf_crypto_backend_rng_context_t *)p_context)->crys_rnd_state;
  148. mutex_locked = cc310_backend_mutex_trylock();
  149. VERIFY_TRUE(mutex_locked, NRF_ERROR_CRYPTO_BUSY);
  150. err_code = CRYS_RND_UnInstantiation(p_crys_rnd_state);
  151. ret_val = result_get(err_code);
  152. cc310_backend_mutex_unlock();
  153. return ret_val;
  154. }
  155. ret_code_t nrf_crypto_rng_backend_vector_generate(void * const p_context,
  156. uint8_t * const p_target,
  157. size_t size,
  158. bool use_mutex)
  159. {
  160. bool mutex_locked;
  161. CRYSError_t err_code;
  162. ret_code_t ret_val;
  163. CRYS_RND_State_t * p_crys_rnd_state =
  164. &((nrf_crypto_backend_rng_context_t *)p_context)->crys_rnd_state;
  165. if (use_mutex)
  166. {
  167. mutex_locked = cc310_backend_mutex_trylock();
  168. VERIFY_TRUE(mutex_locked, NRF_ERROR_CRYPTO_BUSY);
  169. }
  170. err_code = CRYS_RND_GenerateVector(p_crys_rnd_state, size, p_target);
  171. ret_val = result_get(err_code);
  172. if (use_mutex)
  173. {
  174. cc310_backend_mutex_unlock();
  175. }
  176. return ret_val;
  177. }
  178. ret_code_t nrf_crypto_rng_backend_reseed(void * const p_context,
  179. void * p_temp_buffer,
  180. uint8_t * p_input_data,
  181. size_t size)
  182. {
  183. bool mutex_locked;
  184. CRYSError_t err_code;
  185. ret_code_t ret_val = NRF_SUCCESS;
  186. CRYS_RND_WorkBuff_t * p_work_buffer = (CRYS_RND_WorkBuff_t *)p_temp_buffer;
  187. CRYS_RND_State_t * p_crys_rnd_state =
  188. &((nrf_crypto_backend_rng_context_t *)p_context)->crys_rnd_state;
  189. VERIFY_TRUE(size <= CRYS_RND_ADDITINAL_INPUT_MAX_SIZE_WORDS, NRF_ERROR_CRYPTO_INPUT_LENGTH);
  190. VERIFY_TRUE((size & 0x3) == 0, NRF_ERROR_CRYPTO_INTERNAL);
  191. mutex_locked = cc310_backend_mutex_trylock();
  192. VERIFY_TRUE(mutex_locked, NRF_ERROR_CRYPTO_BUSY);
  193. if (size > 0)
  194. {
  195. err_code = CRYS_RND_AddAdditionalInput(p_crys_rnd_state, p_input_data, size);
  196. ret_val = result_get(err_code);
  197. if (ret_val != NRF_SUCCESS)
  198. {
  199. goto exit;
  200. }
  201. }
  202. err_code = CRYS_RND_Reseeding(p_crys_rnd_state, p_work_buffer);
  203. ret_val = result_get(err_code);
  204. exit:
  205. cc310_backend_mutex_unlock();
  206. return ret_val;
  207. }
  208. #endif // NRF_MODULE_ENABLED(NRF_CRYPTO_BACKEND_CC310_RNG)
  209. #endif // NRF_MODULE_ENABLED(NRF_CRYPTO_BACKEND_CC310)
  210. #endif // NRF_MODULE_ENABLED(NRF_CRYPTO)