README 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. CyaSSL MPLAB X Project Files
  2. This directory contains project files for the Microchip MPLAB X IDE. These
  3. projects have been set up to use the Microchip PIC32 Ethernet Starter Kit
  4. and the Microchip XC32 compiler, and have been created specifically to test
  5. the Microchip-specific CTaoCrypt API with compression support. For MPLAB X
  6. projects that don't use compression and are generic to the CTaoCrypt API,
  7. please see the <cyassl_root>/mplabx directory.
  8. In order to generate the necessary auto-generated MPLAB X files, make sure
  9. to import the cyassl.X and zlib.X projects into your MPLAB X workspace before
  10. trying to build either the CTaoCrypt test or benchmark applications. This will
  11. correctly set up the respective project's Makefiles.
  12. Included Project Files
  13. -----------------------
  14. 1. CyaSSL library (cyassl.X)
  15. This project builds a static CyaSSL library. Prior to building this
  16. project, uncomment the MICROCHIP_PIC32 define located in:
  17. <cyassl_root>/cyassl/ctaocrypt/settings.h
  18. After this project has been built, the compiled library will be located
  19. at:
  20. <cyassl_root>/mplabx/cyassl.X/dist/default/production/cyassl.X.a
  21. Note that this project includes the zlib header location in the project's
  22. include paths. This is because this project has been set up to be compiled
  23. with zlib support to enable compression and decompression features.
  24. 2. CTaoCrypt Test App (ctaocrypt_test.X)
  25. This project tests the CTaoCrypt cryptography modules. It is generally
  26. a good idea to run this first on an embedded system after compiling
  27. CyaSSL in order to verify all underlying crypto is working correctly.
  28. 3. CTaoCrypt Benchmark App (ctaocrypt_benchmark.X)
  29. This project builds the CTaoCrypt benchmark application. If the CyaSSL
  30. project (cyassl.X) has been compiled with libz support and is being
  31. used to build this project, the zlib.X project will need to added to
  32. the "Libraries" folder under the ctaocrypt_benchmark.X project before
  33. it will compile successfully.
  34. 4. CTaoCrypt MCAPI Test App (ctaocrypt_mcapi.X)
  35. This project tests the Microchip crytpo API layer. The Microchip crypto
  36. layer is located under the <cyassl_root>/mcapi directory.
  37. 5. zlib library (zlib.X)
  38. This project builds the zlib library for use in the ctaocrypt_test.X
  39. and ctaocrypt_mcapi.X projects. This project expects the zlib sources
  40. to be located under the CyaSSL root directory. Currently it is set up
  41. to work with zlib 1.2.7, and looks for sources under:
  42. <cyassl_root>/zlib-1.2.7
  43. MIPS16 and MIPS32 Support
  44. -------------------------
  45. These projects support both MIPS16 and MIPS32 instruction sets. Switching
  46. between these two instruction sets can be done in each project's properties
  47. settings by checking the "Generate 16-bit code" checkbox.
  48. Support
  49. -------
  50. Please send questions or comments to support@wolfssl.com