Pull request #84: Release secure boot demo for dsPIC33AK512MPS512

Merge in MCU16CE/dspic33-dsc-bootloader-code-examples from develop to master

* commit 'a7974f038a43b970eb2a0f7ccc4441b0156bcc52':
  Edit link path to shorter name
  Update readme
  remove folders for flash protection region projects
  reduce folder depth
  shorten path for top level demo
  Fix version number of inner project to match outer project main.json
  Remove python chache files
  Move flash protection example changes over to demo repo
  Move changes over to demo project from boot project
  Pull request #74: Add code to repo and update outer files

Author: davidflowers

.citd/Jenkinsfilek8s

@@ -86,6 +86,7 @@ pipeline {
             steps {
                 script {  
                     sh("find . -type f -name postBuild.sh -exec chmod +x {} \\;")
+                    sh("find . -type f -name preBuild.sh -exec chmod +x {} \\;")
                     mplabxProjectBuild(
                         sourceFilePath: "${env.MPLABX_PROJECT_SOURCE}"
                     )

.main-meta/main.json

@@ -4,17 +4,17 @@
    "content": {
       "metaDataVersion": "1.3.0",
       "name": "com.microchip.mplabx.project.dspic33-dsc-bootloader-code-examples",
-      "version": "1.1.0",
+      "version": "1.2.1",
       "displayName": "dsPIC33 DSC Bootloader Code Examples",
       "projectName": "dspic33-dsc-bootloader-code-examples",
       "shortDescription": "dsPIC33 DSC Bootloader Code Examples",
       "ide": {
          "name": "MPLABX",
-         "semverRange": ">=6.15.0"
+         "semverRange": ">=6.25.0"
       },
       "compiler": {
-         "name": "XC16",
-         "semverRange": "^2.10.0"
+         "name": "XCDSC",
+         "semverRange": "^3.21"
       },
       "dfp": {
          "name": "dsPIC33CK-MP_DFP",

README.md

@@ -25,15 +25,29 @@ See [secure_boot_and_secure_firmware_upgrade_over_canfd](secure_boot_and_secure_
 ## <u>dsPIC33a Bootloader and Firmware Upgrade Demo</u>
 
 ### Summary
-An example bootloader using the Microchip Device Firmware Update (MDFU) protocol and UART peripheral on the dsPIC33A Curiosity Platform Development Board with a dsPIC33AK128MC106 DIM demonstrating the following: 
+An example bootloader using the Microchip Device Firmware Update (MDFU) protocol and UART peripheral on the Curiosity Platform Development Board with a dsPIC33AK128MC106 DIM demonstrating the following: 
 * Secure firmware update via UART using Microchip Device Firmware Update (MDFU) protocol 
 * Application verification checking using a 32-bit CRC-32Q signature  
 
 ### Related Documentation
 * [dsPIC33AK128MC106 DIM (EV02G02A)](https://www.microchip.com/en-us/development-tool/ev02g02a)
-* [dsPIC33A Curiosity Platform Development Board (EV74H48A)](https://www.microchip.com/en-us/development-tool/ev74h48a)
+* [Curiosity Platform Development Board (EV74H48A)](https://www.microchip.com/en-us/development-tool/ev74h48a)
 * [MDFU Protocol](https://ww1.microchip.com/downloads/aemDocuments/documents/DEV/ProductDocuments/SupportingCollateral/Microchip-Device-Firmware-Update-MDFU-Protocol-DS50003743.pdf)
 
 ### Setup And Operation
 See [dspic33a_bootloader_and_firmware_upgrade_demo](dspic33a_bootloader_and_firmware_upgrade_demo/) and the associated [README.md](dspic33a_bootloader_and_firmware_upgrade_demo/README.md) files for details on the required hardware, software, setup, and how to run the demo.
 
+## <u>dsPIC33a Secure Boot and Firmware Upgrade Demo</u>
+
+### Summary
+An example secure bootloader using the Microchip Device Firmware Update (MDFU) protocol and UART peripheral on the Curiosity Platform Development Board with a dsPIC33AK512MPS512 DIM demonstrating the following: 
+* Secure firmware update via UART using Microchip Device Firmware Update (MDFU) protocol 
+* Application verification checking using Elliptic Curve Digital Signature Algorithm (ECDSA) with P-384
+
+### Related Documentation
+* [Curiosity Platform Development Board (EV74H48A)](https://www.microchip.com/en-us/development-tool/ev74h48a)
+* [MDFU Protocol](https://ww1.microchip.com/downloads/aemDocuments/documents/DEV/ProductDocuments/SupportingCollateral/Microchip-Device-Firmware-Update-MDFU-Protocol-DS50003743.pdf)
+
+### Setup And Operation
+See [dspic33a_secure_boot](dspic33a_secure_boot/) and the associated [README.md](dspic33a_secure_boot/README.md) files for details on the required hardware, software, setup, and how to run the demo.
+

changelog.md

@@ -1,17 +1,31 @@
-# dsPIC33a Bootloader and Firmware Upgrade Demo v1.1.0
+# dsPIC33 DSC Bootloader Code Examples v1.2.1
 ### Release Highlights
-* Initial Release of "dsPIC33A bootloader and firmware upgrade demo" - MDFU based bootloader for the dsPIC33A family devices with a single partition verified by a CRC integrity check. *
+* Corrected version number of "dspic33a Secure Boot and Secure Firmware Upgrade Demo".
 
 ### Features Added\Updated
-* Initial Release of "dsPIC33A bootloader and firmware upgrade demo" - MDFU based bootloader for the dsPIC33A family devices with a single partition verified by a CRC integrity check. *
+* Corrected version number of "dspic33a Secure Boot and Secure Firmware Upgrade Demo".
 
-\* **NOTE**: THIS DEMO IS AN ENGINEERING RELEASE TO DEMONSTRATE DSPIC33A BOOTLOADER FUNCTIONALITY AND SHOULD BE USED FOR REFERENCE ONLY. THIS CODE IS NOT INTENDED FOR USE IN PRODUCTION.
+# dsPIC33 DSC Bootloader Code Examples v1.2.0
+### Release Highlights
+* Initial Release of "dspic33a Secure Boot and Secure Firmware Upgrade Demo" - MDFU based secure bootloader for the dsPIC33A family of devices with a single partition verified by ECDSA with P-384.*
+
+### Features Added\Updated
+* Initial Release of "dspic33a Secure Boot and Secure Firmware Upgrade Demo" - MDFU based secure bootloader for the dsPIC33A family of devices with a single partition verified by ECDSA with P-384.*
 
-# dsPIC33 DSC Bootloader Code examples v1.0.0
+**NOTE**: THIS DEMO IS AN ENGINEERING RELEASE TO DEMONSTRATE DSPIC33A SECURE BOOTLOADER FUNCTIONALITY AND SHOULD BE USED FOR REFERENCE ONLY. THIS CODE IS NOT INTENDED FOR USE IN PRODUCTION.
+
+# dsPIC33 DSC Bootloader Code Examples v1.1.0
 ### Release Highlights
-* Initial Release of "Secure Boot and Secure Firmware Upgrade over CAN-FD for dsPIC33C DSCs Demo v1.0.0" - Refer to the README.md for a summary and execution procedure
+* Initial Release of "dsPIC33A Bootloader and Firmware Upgrade Demo" - MDFU based bootloader for the dsPIC33A family of devices with a single partition verified by a CRC integrity check. *
 
 ### Features Added\Updated
-* Initial Release of "Secure Boot and Secure Firmware Upgrade over CAN-FD for dsPIC33C DSCs Demo v1.0.0" - Refer to the README.md for a summary and execution procedure 
+* Initial Release of "dsPIC33A Bootloader and Firmware Upgrade Demo" - MDFU based bootloader for the dsPIC33A family of devices with a single partition verified by a CRC integrity check. *
 
+**NOTE**: THIS DEMO IS AN ENGINEERING RELEASE TO DEMONSTRATE DSPIC33A BOOTLOADER FUNCTIONALITY AND SHOULD BE USED FOR REFERENCE ONLY. THIS CODE IS NOT INTENDED FOR USE IN PRODUCTION.
 
+# dsPIC33 DSC Bootloader Code Examples v1.0.0
+### Release Highlights
+* Initial Release of "Secure Boot and Secure Firmware Upgrade over CAN-FD for dsPIC33C DSCs Demo v1.0.0" - Refer to the README.md for a summary and execution procedure
+
+### Features Added\Updated
+* Initial Release of "Secure Boot and Secure Firmware Upgrade over CAN-FD for dsPIC33C DSCs Demo v1.0.0" - Refer to the README.md for a summary and execution procedure 

dspic33a_secure_boot/.main-meta/main.json

@@ -0,0 +1,99 @@
+{
+   "metaDataVersion": "1.0.0",
+   "category": "com.microchip.ide.project",
+   "content": {
+      "metaDataVersion": "1.3.0",
+      "name": "com.microchip.mplabx.project.dspic33a-secure-boot-and-secure-firmware-upgrade-demo",
+      "version": "1.2.1",
+      "displayName": "dsPIC33a Secure Boot and Secure Firmware Upgrade Demo",
+      "projectName": "dspic33a-secure-boot-and-secure-firmware-upgrade-demo",
+      "shortDescription": "This MPLAB® X IDE example demonstrates how to perform secure boot authentication and secure firmware upgrade via UART with Microchip Device Firmware Update Protocol (M-DFU) and ECDSA with P-384 verification within MCC Melody.",
+      "ide": {
+         "name": "MPLABX",
+         "semverRange": ">=6.25.0"
+      },
+      "compiler": {
+         "name": "XCDSC",
+         "semverRange": "^3.21"
+      },
+      "dfp": {
+         "name": "dsPIC33AK-MP_DFP",
+         "semverRange": ">=1.0.81"
+      },
+      "configurator": {
+         "name": "MCC",
+         "semverRange": ">=5.7.1"
+      },
+      "device": {
+         "metaDataVersion": "1.0.0",
+         "category": "com.microchip.portal.contentRef",
+         "content": {
+            "metaDataVersion": "1.0.0",
+            "category": "com.microchip.device",
+            "name": " dsPIC33AK512MPS512",
+            "versionRange": "*"
+         }
+      },
+      "keywords": [
+         "Application Layer",
+         "Authentication",
+         "Automotive",
+         "Board",
+         "Bootloader",
+         "Bootloader Client", 
+         "CAN FD",
+         "Certificate",
+         "Code Protection",
+         "Communication",
+         "Communication Layer",
+         "Communication Module",
+         "Compiler",
+         "Configurator",
+         "Controller",
+         "CryptoAuthentication",
+         "Cryptographic Accelerator Module",
+         "Cryptographic Standard",
+         "Cryptography",
+         "Curiosity",
+         "Development Tool",
+         "Documentation",
+         "DSC",
+         "DSP",
+         "dsPIC",
+         "Firmware",
+         "Firmware Upgrade",
+         "Flash OTP",
+         "FTP",
+         "Getting Started",
+         "Immutable Boot",
+         "Key",
+         "MCC",
+         "MDFU",
+         "Memory",
+         "Memory Module",
+         "Memory Type",
+         "Module",
+         "MPLAB XC Compiler",
+         "OTP",
+         "Over-the-Air Upgrade",
+         "Private Key",
+         "Product",
+         "Public Key",
+         "Public-key Cryptography",
+         "Secure Bootloader",
+         "Secure Firmware Upgrade",
+         "Security",
+         "Security Device",
+         "Serial Communication",
+         "SHA",
+         "SHA-256",
+         "Software",
+         "UART",
+         "UART Protocol", 
+         "Virtual COM Port",
+         "Wired",
+         "XC16",
+         "XC-DSC"
+      ]
+   }
+}