Fork: 0
LuminaSensum / mbed-os
Download ZIP 10000+commits
Transfer to URL with SHA
mbed-os / features / cryptocell / FEATURE_CRYPTOCELL310 /
latest commit e0571c0bf2
@Ron Eldor Ron Eldor authored on 1 Jan 2019
..
TARGET_MCU_NRF52840 Update the CC310 GCC_ARM libraries 5 years ago
binaries Update the CC310 GCC_ARM libraries 5 years ago
include Change Cryptocell target to a feature 6 years ago
Readme.md Update the CC310 readme file 5 years ago
cc_internal.c Merge pull request #8797 from RonEld/cryptocell_ecc_errors_alt_fixes 5 years ago
cc_internal.h Modify HW accelerator drivers to new error code 5 years ago
ccm_alt.c Add the platform generic errors 5 years ago
ccm_alt.h Style fixes 5 years ago
ecdh_alt.c Change to mbedtls_platform_zeroize() 5 years ago
ecdsa_alt.c Change to mbedtls_platform_zeroize() 5 years ago
ecdsa_alt.c.mod Change Cryptocell target to a feature 6 years ago
mbedtls_device.h Change Cryptocell target to a feature 6 years ago
objects_cryptocell.h Change Cryptocell target to a feature 6 years ago
sha1_alt.c Return not supported for internal process function 5 years ago
sha1_alt.h Style fixes 5 years ago
sha256_alt.c Return not supported for internal process function 5 years ago
sha256_alt.h Style fixes 5 years ago
trng.c Don't use define checks on DEVICE_FOO macros (mbed code) 5 years ago
Readme.md

Guidelines for porting Cryptocell to Mbed OS

Cryptocell (CC) 310 is a hardware accelerator that can be ported to several boards, assuming these boards have CC 310 embedded in their hardware.

The CC 310 driver consists of three libraries:

  • A common core library(libcc_core.a).
  • A platform-specific TRNG library, containing TRNG-related information, for sampling sufficient entropy on the specific platform(libcc_trng.a).
  • A platform-specific library containing extra information, such as the CC register's base addresses on the specific board. (libcc_ext.a)

Library version information:

  • The CC 310 libraries were built from version arm_sw-cc310-1.1.0.1285
  • The IAR libraries were built using IAR ANSI C/C++ Compiler V7.80.1.11864/W32 for ARM with --cpu Cortex-M4f.
  • The ARM libraries were built using ARM Compiler 5.06 update 4 (build 422) with --cpu cortex-m4.
  • The GCC_ARM libraries were built using arm-none-eabi-gcc 6.3.1 20170620 (release) with -mcpu=cortex-m4.

To port your CC 310 driver to Mbed OS on your specific target, do the following:

  1. In targets.json add the following to your target:
    • MBEDTLS_CONFIG_HW_SUPPORT to macros_add key. This instructs Mbed TLS to look for an alternative cryptographic implementation.
    • CRYPTOCELL310 to feature. Use this in your common code that you need to remove from compilation in case CC exists in your board. Use #if !defined(FEATURE_CRYPTOCELL310) and #if defined(FEATURE_CRYPTOCELL310).
  2. In objects.h, include objects_cryptocell.h. You can use the FEATURE_CRYPTOCELL310 precompilation check as defined above.
  3. In features/cryptocell/FEATURE_CRYPTOCELL310/TARGET_<target name>, add your platform-specific libraries for all toolchains in TOOLCHAIN_ARM, TOOLCHAIN_GCC_ARM and TOOLCHAIN_IAR respectively.
  4. Add your CC setup code:
    • Implement crypto_platform_setup() and crypto_platform_terminate() to enable CC on your platform, in case you have board-specific setup functionality, required for CC setup. You MUST call 'SaSi_LibInit()` and 'SaSi_LibFini()' respectively in these functions.
    • Define crypto_platform_ctx in crypto_platform.h in a way that suits your implementation.