WolfSSL
/
wolfssl-examples
mirror of https://github.com/wolfSSL/wolfssl-examples.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Fixed several typos in `btle/README.md`. Changed the `btle/Makefile` to default to non-debug / dynamic wolfSSL library.

pull/68/head
David Garske 2017-07-22 11:31:18 -07:00
parent a16f3b1066
commit af27d17576
2 changed files with 21 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
btle/Makefile
View File

@ -6,15 +6,17 @@ LIBS = -L$(LIB_PATH)/lib
# option variables # option variables
DYN_LIB = -lwolfssl DYN_LIB = -lwolfssl
STATIC_LIB = $(LIB_PATH)/lib/libwolfssl.a STATIC_LIB =
DEBUG_FLAGS = -g -DDEBUG DEBUG_FLAGS = -g -DDEBUG
OPTIMIZE = -Os OPTIMIZE = -Os
# Options # Options
CFLAGS+=$(DEBUG_FLAGS) #CFLAGS+=$(DEBUG_FLAGS)
#CFLAGS+=$(OPTIMIZE) #CFLAGS+=$(OPTIMIZE)
#LIBS+=$(DYN_LIB) -lm # Static or Dynamic Library
#STATIC_LIB+=$(LIB_PATH)/lib/libwolfssl.a
LIBS+=$(DYN_LIB) -lm
.PHONY: clean all .PHONY: clean all

22
btle/README.md
View File

@ -1,28 +1,38 @@
# BTLE Examples # BTLE Examples
Bluetooth Low Energy (BTLE or BLE) is a leightweight / low power wireless protocol. Its supported by Apple iPhone 4s and later and most Android phones. It operates in the 2.4GHz spectrum and has 3 advertising channels and 37 data channels. BTLE / Lightweight Secure Transport Example:
These examples demonstrate leightweight methods for exchanging data securley over anytype of publically visible link. Bluetooth Low Energy (BTLE) is a lightweight / low power wireless protocol. Its supported by Apple iPhone 4s and later and most Android phones. It operates in the 2.4GHz spectrum and has 3 advertising channels and 37 data channels.
This example demonstrates a lightweight method for exchanging data securely over any type of publicly visible link.
The first phase is key establishment, which is done through ECDH and HDKF. ECC was chosen for these examples because its lightweight and widely used. Then salt exchanged for each message to prevent reply attacks. The encryption is done with AES CBC. The data integrity is done using HMAC-SHA256.
The first phase is key establishment, which is done through ECDH and HDKF. ECC was choosen for these examples because its leightweight and widely used. Salt exchanged to provent data reply of messages. The enryption is done with AES CBC. The data integrity is done using HMAC-SHA256.
## ECC Encrypt/Decrypt Example ## ECC Encrypt/Decrypt Example
See `BTLESecureMessageExchange.pdf` for details. See `BTLESecureMessageExchange.pdf` for details.
### Building ### Building
The wolfSSL library must be built and installed using './configure --enable-ecc --enable-eccencrypt --enable-hkdf && make && sudo make install' or by defining `#define HAVE_ECC`, `#define HAVE_ECC_ENCRYPT` and `HAVE_HKDF`. The wolfSSL library must be built and installed using './configure --enable-ecc --enable-eccencrypt --enable-hkdf && make && sudo make install' or by defining `#define HAVE_ECC`, `#define HAVE_ECC_ENCRYPT` and `HAVE_HKDF`.
### Usage ### Usage
Use two consoles and STDIN to exchange data between the client and server. Use two consoles and STDIN to exchange data between the client and server. From the client enter a message and hit enter. This will be encrypted and sent to the server. The server will decrypt, print and re-encrypt the message and send it back to the client (echo).
``` ```
./ecc-server ./ecc-server
./ecc-client ./ecc-client
``` ```
### BTLE Simulator ### Debugging
The simulator uses IPC (pipes) to communicate between threads for simualted communication between two devices. To enable debugging or switch to using a static version of wolfSSL edit the `Makefile` and uncomment `CFLAGS+=$(DEBUG_FLAGS)` and `STATIC_LIB+=$(LIB_PATH)/lib/libwolfssl.a`. Then comment out `LIBS+=$(DYN_LIB) -lm`.
## BTLE Simulator
The simulator uses IPC (pipes) to communicate between threads for simulated communication between two devices.