wolfssl-examples/tirtos_ccs_examples
Kaleb Joseph Himes a692eb9d06 Update README 2014-08-13 12:15:18 -06:00
..
cyassl_tirtos_benchmark Push from github for windows 2014-08-13 11:19:10 -06:00
README Update README 2014-08-13 12:15:18 -06:00
tirtos.mak tirtos make file for building with cyassl 2014-08-12 15:31:15 -06:00

README

Disclaimer
---------------------------------------------------------
These have currently been tested in windows CCS only. Once testing on the linux distribution for CCS is complete
this README will be updated.

Setting up the file system
---------------------------------------------------------
ensure that cyassl is on the C:/ drive and remove any version numbers on the file. For example if your cyassl
directory is named "cyassl_3_1_0 or cyassl-3.1.0" rename it to "cyassl". You should now have C:/cyassl directory.

Clone this repository using "github for windows". The projects have been made portable so you can run them straight
from the github clone repo or you can copy and paste the "tirtos_ccs_examples" folder out of the repo to wherever and 
they should still debug just fine once imported into your workspace (see end of this README).
You should now have <cyassl_root>/tirtos/tirtos_ccs_examples.

Instructions for building CyaSSL application for TI-RTOS
---------------------------------------------------------

Installing the software
-----------------------
1. Install the NDK product ndk 2.24.00.05 in C:/ti
2. Open CCS. A prompt opens asking to install discovered product. Select the ndk product and click finish. 
   Restart if prompted.
3. In CCS, open View -> CCS App Center. Search "ti-rtos". Select "TI-RTOS for TivaC" from the results and click 
   Install Software. Follow the instructions.


Building CyaSSL libraries for TI-RTOS
-------------------------------------
1. Replace tirtos.mak in C:\ti\tirtos_tivac_2_00_02_36 with the tirtos.mak from <cyassl_root>/tirtos/tirtos_ccs_examples. 
   Ensure you have cyassl in the proper location (should be C:/cyassl).
2. Open a command prompt. CD into C:\ti\tirtos_tivac_2_00_02_36.
3. Run the make command to build CyaSSL libaries.
    
   ..\xdctools_3_30_01_25_core\gmake.exe -f tirtos.mak cyassl

Running CyaSSL CTaoCrypt benchmark and test application.
--------------------------------------------------------
1. After running the TCP Echo Server application, in the Debugger View, open Run -> Load Program. 
   Browse to the Benchmark application (C:\cyassl\tirtos\packages\ti\net\cyassl\tests\ctaocrypt\benchmark). 
   Select benchmark.xem4f and Click Open and Click OK to load the application.
2. Test by running the application.
3. Repeat the steps 1 and 2 for Test application (C:\cyassl\tirtos\packages\ti\net\cyassl\tests\ctaocrypt\test).
4. The example cyassl_tirtos_benchmark in this repository has all the correct optimization settings and will 
   re-build the relevant c files at compile time for optimal results and additional benchmarks for camellia, rabbit, 
   chacha, poly1305, sha512, and ECC.

Import a project into your workspace.
--------------------------------------------------------
In CCS go to the Project tab. Click "Import CCS Projects...". 
Click "Browse..." and navigate to tirtos_ccs_examples/ file and click "OK". In the "Discovered projects"
window you will see all CCS projects. Check the ones you would like to import into the workspace, and check
the box at the bottom labled "Copy projects into workspace", now click "Finish".
Build and debug the desired projects.