From 632e67f8d6b2919d0c881f3a0c922cccf1de1aae Mon Sep 17 00:00:00 2001 From: Brian Gix Date: Fri, 31 May 2019 08:56:43 -0700 Subject: [PATCH] mesh: ELL encrypt dependancy README section added Due to known AEAD encryption deficiencies in old versions of the kernel, we have added a section on identifying and back-porting mesh to otherwise non-supporting platforms. --- mesh/README | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/mesh/README b/mesh/README index 82fd5a017..f36b97c2b 100644 --- a/mesh/README +++ b/mesh/README @@ -71,6 +71,20 @@ Each subdirectory contains the following files: The node.json and node.json.bak are in JSON format. All other files are stored in little endian binary format. +Known Issues +============ + +Bluetooth Mesh makes heavy usage of AEAD-AES_CCM encryption, which is +implemented in the Linux kernel on most platforms. Some platforms, including +those with kernel versions including and prior to v4.8, did *not* correctly +implement the AEAD encryption routines. If Mesh is to be ported to such a +system, it will be the responsibility of the vendor to provide support for +AEAD-AES_CCM encryption by some other method. + +Support for the required AEAD routines can be determined by running the unit +tests provided with the ELL libraries used by Mesh. Specifically, the tests +found in .../ell/unit/test-cipher.c + Information ===========