Pull request #44: Feature/MCU16GITHUB-913 bootloader prebuilt hex file

Merge in MCU16CE/dspic33-dsc-bootloader-code-examples from feature/MCU16GITHUB-913-bootloader-prebuilt-hex-file to develop

* commit '4849ea15f11651d6085c8362a9c2bc2a53aae4aa':
  add documentation for MCU16GITHUB-942
  adding .hex files to address MCU16GITHUB-941 and MCU16GITHUB-897

Author: davidflowers

secure_boot_and_secure_firmware_upgrade_over_canfd/hex_files/README.md

@@ -0,0 +1,36 @@
+<picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./images/microchip_logo_white_red.png">
+	<source media="(prefers-color-scheme: light)" srcset="./images/microchip_logo_black_red.png">
+    <img alt="Microchip Logo." src="../images/microchip_logo_black_red.png">
+</picture>
+
+## Secure Boot and Secure Firmware Upgrade over CAN-FD for dsPIC33C DSCs Demo - Precompiled Hex Files
+
+## Introduction
+This folder contains precompiled .hex files for the demo bootloader and application project associated with this project.  This demo uses the TA100 and associated code library which require an NDA to get access to the complete source code.  Those interested in testing the demo before going through the NDA process can use these hex files to run through the demo without needing access to the source files.
+
+**NOTE** - Only the bootloader project has code that requires an NDA.  The application .hex file can be compiled as is and is provided out of convenience.
+
+## Programming the Bootloader from the Precompiled .hex File
+1. Connect the dsPIC33C Touch CAN LIN Curiosity Development Board to the PC via the USB micro-B port.
+2. Open the MPLAB X IPE program.
+3. Enter the dsPIC33CK1024MP710 in the "Device" selector.<br>
+![Select the correct device](./images/select_device.png)<br>
+4. Select the "Curiosity/Starter kits" option from the "Tools" dropdown.<br>
+![Select the curiosity board](./images/connect_tool.png)<br>
+5. From the menu, select "Settings -> Advanced Mode"<br>
+![Enable advanced mode](./images/advanced_mode.png)<br>
+6. Enter the IPE password.  The default password is "microchip" if a new password has not been selected yet. <br>
+![Password to enable advanced mode](./images/password.png)<br>
+7. From the menu, select "Settings -> Release from Reset".  This will allow the programmer to release the device from reset after a programming is complete and allow the device to run the new code.<br>
+![Release from reset](./images/release_reset.png)<br>
+8. From the menu, select "File -> Import -> Hex".  Select the following file: `/secure_boot_and_secure_firmware_upgrade_over_canfd/hex_files/boot.X.production.hex`.<br>
+![Import hex file](./images/import_hex.png)<br>
+9. Click the "Connect" button.<br>
+![Connect the tool](./images/connect_tool.png)<br>
+10. Once the connection is complete, press the "Program".<br>
+![Program flash](./images/program.png)<br>
+11. When programming is complete, the bootloader should now be operational.  You can continue to use the bootloader using the `README.md` documentation found in the boot.X folder that is one level higher in this directory structure.
+
+## Loading and Running the Application
+Use the `README.md` file in the top-level folder of the demo for the full instructions of the how to load the application using the bootloader.  When prompted to load a .hex file, you can choose to load the application file located here instead of compiling the application project and using the resulting .hex file.

secure_boot_and_secure_firmware_upgrade_over_canfd/hex_files/app.X.production.hex

@@ -0,0 +1,332 @@
+:10000000727D0400000000001C7A0000727900007C
+:10001000927900005C7A00003C7A0000867E000045
+:10002000B2790000867E0000867E0000867E000099
+:10003000867E0000867E0000867E0000867E0000B0
+:10004000867E0000867E0000867E0000867E0000A0
+:10005000867E0000867E0000867E0000867E000090
+:10006000867E0000867E0000867E0000867E000080
+:10007000867E0000867E0000867E0000867E000070
+:10008000867E0000867E0000867E0000867E000060
+:10009000867E0000867E0000867E0000867E000050
+:1000A000867E0000867E0000867E0000867E000040
+:1000B000867E0000867E0000867E0000867E000030
+:1000C000867E0000867E0000867E0000867E000020
+:1000D000867E0000867E0000867E0000EE7D0000A9
+:1000E000867E0000867E0000867E0000867E000000
+:1000F000867E0000867E0000867E0000867E0000F0
+:10010000867E0000867E0000867E0000867E0000DF
+:10011000867E0000867E0000867E0000867E0000CF
+:10012000867E0000867E0000867E0000867E0000BF
+:10013000867E0000867E0000867E0000867E0000AF
+:10014000867E0000867E0000867E0000867E00009F
+:10015000867E0000867E0000867E0000867E00008F
+:10016000867E0000867E0000867E0000867E00007F
+:10017000867E0000867E0000867E0000867E00006F
+:10018000867E0000867E0000867E0000867E00005F
+:10019000867E0000867E0000867E0000867E00004F
+:1001A000867E0000867E0000867E0000867E00003F
+:1001B000867E0000867E0000867E0000867E00002F
+:1001C000867E0000867E0000867E0000867E00001F
+:1001D000867E0000867E0000867E0000867E00000F
+:1001E000867E0000867E0000867E0000867E0000FF
+:1001F000867E0000867E0000867E0000867E0000EF
+:10020000867E0000867E0000867E0000867E0000DE
+:10021000867E0000867E0000867E0000867E0000CE
+:10022000867E0000867E0000867E0000867E0000BE
+:10023000867E0000867E0000867E0000867E0000AE
+:10024000867E0000867E0000867E0000867E00009E
+:10025000867E0000867E0000867E0000867E00008E
+:10026000867E0000867E0000867E0000867E00007E
+:10027000867E0000867E0000867E0000867E00006E
+:10028000867E0000867E0000867E0000867E00005E
+:10029000867E0000867E0000867E0000867E00004E
+:1002A000867E0000867E0000867E0000867E00003E
+:1002B000867E0000867E0000867E0000867E00002E
+:1002C000867E0000867E0000867E0000867E00001E
+:1002D000867E0000867E0000867E0000867E00000E
+:1002E000867E0000867E0000867E0000867E0000FE
+:1002F000867E0000867E0000867E0000867E0000EE
+:10030000867E0000867E0000867E0000867E0000DD
+:10031000867E0000867E0000867E0000867E0000CD
+:10032000867E0000867E0000867E0000867E0000BD
+:08033000867E0000867E0000BD
+:10E008001C7A000072790000927900005C7A0000A6
+:10E018003C7A0000867E0000B2790000867E00000F
+:10E02800867E0000867E0000867E0000867E0000D8
+:10E03800867E0000867E0000867E0000867E0000C8
+:10E04800867E0000867E0000867E0000867E0000B8
+:10E05800867E0000867E0000867E0000867E0000A8
+:10E06800867E0000867E0000867E0000867E000098
+:10E07800867E0000867E0000867E0000867E000088
+:10E08800867E0000867E0000867E0000867E000078
+:10E09800867E0000867E0000867E0000867E000068
+:10E0A800867E0000867E0000867E0000867E000058
+:10E0B800867E0000867E0000867E0000867E000048
+:10E0C800867E0000867E0000867E0000867E000038
+:10E0D800867E0000EE7D0000867E0000867E0000C1
+:10E0E800867E0000867E0000867E0000867E000018
+:10E0F800867E0000867E0000867E0000867E000008
+:10E10800867E0000867E0000867E0000867E0000F7
+:10E11800867E0000867E0000867E0000867E0000E7
+:10E12800867E0000867E0000867E0000867E0000D7
+:10E13800867E0000867E0000867E0000867E0000C7
+:10E14800867E0000867E0000867E0000867E0000B7
+:10E15800867E0000867E0000867E0000867E0000A7
+:10E16800867E0000867E0000867E0000867E000097
+:10E17800867E0000867E0000867E0000867E000087
+:10E18800867E0000867E0000867E0000867E000077
+:10E19800867E0000867E0000867E0000867E000067
+:10E1A800867E0000867E0000867E0000867E000057
+:10E1B800867E0000867E0000867E0000867E000047
+:10E1C800867E0000867E0000867E0000867E000037
+:10E1D800867E0000867E0000867E0000867E000027
+:10E1E800867E0000867E0000867E0000867E000017
+:10E1F800867E0000867E0000867E0000867E000007
+:10E20800867E0000867E0000867E0000867E0000F6
+:10E21800867E0000867E0000867E0000867E0000E6
+:10E22800867E0000867E0000867E0000867E0000D6
+:10E23800867E0000867E0000867E0000867E0000C6
+:10E24800867E0000867E0000867E0000867E0000B6
+:10E25800867E0000867E0000867E0000867E0000A6
+:10E26800867E0000867E0000867E0000867E000096
+:10E27800867E0000867E0000867E0000867E000086
+:10E28800867E0000867E0000867E0000867E000076
+:10E29800867E0000867E0000867E0000867E000066
+:10E2A800867E0000867E0000867E0000867E000056
+:10E2B800867E0000867E0000867E0000867E000046
+:10E2C800867E0000867E0000867E0000867E000036
+:10E2D800867E0000867E0000867E0000867E000026
+:10E2E800867E0000867E0000867E0000867E000016
+:10E2F800867E0000867E0000867E0000867E000006
+:10E30800867E0000867E0000867E0000867E0000F5
+:10E31800867E0000867E0000867E0000867E0000E5
+:10E32800867E0000867E0000867E0000867E0000D5
+:10F00000DA3F0000E4C20000F9860000F8DF0000EB
+:10F01000096E00003D410000ED86000091230000D4
+:10F02000B8D3000064C30000E45F0000BBCF000061
+:10F03000D6D6000058CB00004A360000769E00006D
+:10F04000D74B00000C230000D6950000AE670000EF
+:10F05000A99F0000D4BE000068F50000DE48000053
+:10F060003CDB0000C9BD000076BC00009FE700004B
+:10F07000AFD10000F41B0000EE56000074820000C7
+:10F080000070000000000000FEAF0000050000005E
+:10F09000727D04000000000000000000020000007B
+:10F0A0000000000002000000020000000400000058
+:10F0B0000000000000000000000000000400FA0052
+:10F0C000100798000040EB00004F78001E009000F1
+:10F0D0000000E00002003D0010C0B300004F7800C7
+:10F0E0001E4078000080FA00000006000400FA00CC
+:10F0F000100798000040EB00004F78009E00900041
+:10F1000000002400008060000000E00002003200E7
+:10F1100010C0B300004F78001E4078000080FA0055
+:10F12000000006000400FA00100798000040EB0001
+:10F13000004F78009E0090000020200000806000BA
+:10F140000000E0000200320010C0B300004F780061
+:10F150001E4078000080FA00000006000400FA005B
+:10F16000100798000040EB00004F78009E009000D0
+:10F1700000082000008060000000E0000200320073
+:10F1800010C0B300004F78001E4078000080FA00E5
+:10F19000000006000400FA00100798000040EB0091
+:10F1A000004F78009E009000000420000080600066
+:10F1B0000000E0000200320010C0B300004F7800F1
+:10F1C0001E4078000080FA00000006000400FA00EB
+:10F1D000100798000040EB00004F78001E009000E0
+:10F1E000700060000000E0000200320010C0B300B8
+:10F1F000004F78001E4078000080FA0000000600F2
+:10F200000200FA00000F78009E80EA00007C800077
+:10F2100000806000007C88000080FA00000006008A
+:10F220000000FA00007C80000080FA000000060068
+:10F230000200FA00FAFF0700000F78001E007800B5
+:10F240009EFF07000004E0000200320000002800DA
+:10F25000EBFF07001E007800A4FF07000004E00099
+:10F260000200320000002400E5FF07001E007800C5
+:10F27000ACFF07000004E000020032000020200084
+:10F28000DFFF07001E007800B4FF07000004E00065
+:10F290000200320000082000D9FF07001E0078009D
+:10F2A000BCFF07000004E000020032000004200060
+:10F2B000D3FF07001E007800C4FF07000004E00031
+:10F2C0000200320000012000CDFF07000080FA009C
+:10F2D000000006000000FA00802FEF000080FA0016
+:10F2E000000006003600F800809FBE00829FBE002E
+:10F2F000849FBE00869FBE000000FA00C068A9007F
+:10F3000020002000660207000080FA004F03BE00C4
+:10F310004F02BE004F01BE004F00BE003600F90094
+:10F32000004006003600F800809FBE00829FBE00AD
+:10F33000849FBE00869FBE000000FA00C608A90098
+:10F3400070002000560207000080FA004F03BE0044
+:10F350004F02BE004F01BE004F00BE003600F90054
+:10F36000004006003600F800809FBE00829FBE006D
+:10F37000849FBE00869FBE000000FA0020468000E9
+:10F38000700060000000E00003003200C488A900A3
+:10F39000A000200042020700214680000004200057
+:10F3A000008060000000E00003003200C4C8A90033
+:10F3B000E00020003A020700214680000002200001
+:10F3C000008060000000E00003003200C4A8A90033
+:10F3D000900020003202070021468000001020002B
+:10F3E000008060000000E00003003200C508A900B2
+:10F3F000C00020002A0207002146800000202000D3
+:10F40000008060000000E00003003200C528A90071
+:10F41000D00020002202070020468000610060002A
+:10F420000000E00003003200C408A900B000200082
+:10F430001B020700FFFF37003600F800809FBE0068
+:10F44000829FBE00849FBE00869FBE000000FA001F
+:10F45000C028A9000000EB00110207000080FA009C
+:10F460004F03BE004F02BE004F01BE004F00BE0062
+:10F470003600F900004006003600F800809FBE000C
+:10F48000829FBE00849FBE00869FBE000000FA00DF
+:10F49000C088A90030002000010207000080FA00A7
+:10F4A0004F03BE004F02BE004F01BE004F00BE0022
+:10F4B0003600F900004006003600F800809FBE00CC
+:10F4C000829FBE00849FBE00869FBE000000FA009F
+:10F4D000FA010700C048A90010002000F001070051
+:10F4E0000080FA004F03BE004F02BE004F01BE0075
+:10F4F0004F00BE003600F900004006000000FA0090
+:10F50000C3E8A80000000000000000000080FA002E
+:10F51000000006000000FA00C3E8A9000000000097
+:10F52000000000000080FA00000006000000FA0061
+:10F53000F8FF07009A010700F0FF070060B72700F7
+:10F540006100070025A8A8000080FA00000006005E
+:10F550000000FA0000002800E00288000080FA00A5
+:10F56000000006000000FA000000240000038800EC
+:10F5700010C0B30000F0B7000080FA0000000600E1
+:10F580000000FA000070EF0000000000400380005F
+:10F59000610060000000E000FCFF320080002000FD
+:10F5A000200388000080FA00000006000200FA0034
+:10F5B0000040EB00004F78004003800061006000D5
+:10F5C000004078000004E0000200320010C0B300E8
+:10F5D000004F78001E4078000080FA00000006000E
+:10F5E0000000FA0000D0BF000080FA000000060012
+:10F5F0000400FA006000B800008FBE00B003800075
+:10F600008000EB00C000DD0000002000008FBE0085
+:10F61000A00380008000EB003E017000AE8170000E
+:10F620000200BE000080FA00000006000400FA009C
+:10F630006000B800008FBE00D00380008000EB00A7
+:10F64000C000DD0000002000008FBE00C00380006D
+:10F650008000EB003E017000AE8170000200BE0031
+:10F660000080FA00000006000200FA000000EB0033
+:10F67000000F780041038000100E2000008F600012
+:10F680001E0078000080FA00000006000400FA0066
+:10F690006000B800008FBE00700380008000EB00A7
+:10F6A000C000DD0000002000008FBE00600380006D
+:10F6B0008000EB003E017000AE8170000200BE00D1
+:10F6C0000080FA00000006000200FA00000F780037
+:10F6D0001E0078000000E000020032009E0078006A
+:10F6E000318088000080FA00000006000000FA0067
+:10F6F0000080FA0000000600A10288008004780063
+:10F700000000EB001F003700E284440054A0B40066
+:10F710009905BA00E284440054A0B4009906BA00E6
+:10F72000E284440054A0B4000006EB00476FDE0002
+:10F73000FD07B200AE018800636CE10003003A00EF
+:10F740000AD801000000EB000E003700606CE100F9
+:10F7500008003A00004DEB000A05E80002003900FD
+:10F760003420EC000AF0A0008B05E900F9FF3E0010
+:10F77000040037006168E100010032000086EB0000
+:10F780000B00070019C7BA001905BA000E04E00003
+:10F7900003003A000A00E000DBFF3A000000060028
+:10F7A000FE07B200AE0288008A047800F5FF370039
+:10F7B0000CD0A300E20F4D001C003B008902780032
+:10F7C000354DBA000A05E800020039003420EC008B
+:10F7D0000AF0A0008B05E9000F003200254DBA00A9
+:10F7E0000A05E800020039003420EC000AF0A0000D
+:10F7F0008B05E900080032000C00E0000600320032
+:10F8000015CDBA000A05E800020039003420EC00EA
+:10F810000AF0A0008B05E9008984E80054A0B40038
+:10F820000B00E000E2FF3A00000006009902BA0077
+:10F83000055D78008B05E900F7FF3200C82ADE007D
+:10F84000055D78008B05E900F3FF32000C00E00055
+:10F85000F1FF320019DDBA00EEFF37000000FA00B8
+:10F8600010002300307C880020032000407C8800AA
+:10F870008C2FEF0010012000507C88001010200019
+:10F88000707C880060092000807C880010042000C3
+:10F89000907C880000502000D07C8800B82FEF00BA
+:10F8A000BA2FEF00BE2FEF00002DEF00A02FEF00CA
+:10F8B000A42FEF00A62FEF00A82FEF00AA2FEF0034
+:10F8C000AE2FEF00B02FEF00B22FEF00320020007C
+:10F8D00080072000A109200053F82000804978000B
+:10F8E00081497800824978001200200060042000DD
+:10F8F0007105200043F82000804978008149780094
+:10F900008249780000000000207C800061006000D7
+:10F910000000E000FCFF3A0000000000217C8000B5
+:10F9200000022000008060000000E000FBFF3200C9
+:10F930000080FA00000006000000FA00707C8000E1
+:10F94000EE800A00000000000080FB0000F0A7002D
+:10F950000000EA000000EA004F00DE0000407800EE
+:10F960000080FA00000006000000FA00062EEF00FA
+:10F97000222EEF003E2EEF005A2EEF00762EEF00E3
+:10F98000922EEF00F01F2000107088000080EB0026
+:10F99000F07088000080EB00D07188000080EB00E0
+:10F9A000B0728800F0DF2F00907388000080EB00B9
+:10F9B000707488000A2EEF00262EEF00422EEF0012
+:10F9C0005E2EEF007A2EEF00962EEF000C2EEF0049
+:10F9D000282EEF00442EEF00602EEF007C2EEF006B
+:10F9E000982EEF00082EEF00242EEF00402EEF009F
+:10F9F0005C2EEF00782EEF00942EEF00F001200037
+:10FA000000708800E0092000E0708800F00C200001
+:10FA1000C071880000C02200A0728800F0002000A1
+:10FA200080738800003C2000607488000080FA0029
+:10FA3000000006000400FA00889FBE006000B800C5
+:10FA4000008FBE008E00070001003700000000009C
+:10FA5000F0FF2F00710020001E01BE00020278009E
+:10FA600003017800800178008100780003006200C3
+:10FA70008100610081047800000478000800BE0065
+:10FA80000080700000F0A7000000EA000000E9001C
+:10FA90004F00DE000040780012002000030020002C
+:10FAA0001E0F41005E9749000004E000E7FF3200AE
+:10FAB000B073800099800A00000000000004A200DA
+:10FAC000614060000080FB00610060004900DD00D3
+:10FAD000B17380000190A10001007000B073880034
+:10FAE000DBFF3700AF0221000EFF2F000E01880060
+:10FAF00000000000000020000000E00002003200D2
+:10FB00000001200020028800140007008100070087
+:10FB10000000E00003003A00C0E6270001002000DA
+:10FB2000020037000000200001002000810F70005B
+:10FB300001003200F0FE0700000020000000E0009D
+:10FB40000200320000000200000000001A7D0200E6
+:10FB5000000000000040DA000000FE00200020004D
+:10FB60000000E00002003200100020009001880038
+:10FB7000000006000000FE00467B020000000000BE
+:10FB8000821F780012808000000011000200200017
+:10FB9000810019004F017800000006000000FE00FF
+:10FBA000801F7800811F7800821F7800600380002A
+:10FBB000801F7800467B0200000000004F017800A3
+:10FBC000020150000201E900128088004F01780014
+:10FBD000CF0078004F007800000006003600F800E3
+:10FBE000809FBE00829FBE00849FBE00869FBE0095
+:10FBF0000000FA00308080000000E00002003200C7
+:10FC0000308080000000010005A8A9000080FA00F3
+:10FC10004F03BE004F02BE004F01BE004F00BE00AA
+:10FC20003600F900004006000000FA00B1428000F2
+:10FC3000F0F82F00008060000040A000B042880073
+:10FC40000080FA00000006000000FA00B1428000C7
+:10FC5000F0F82F00008060000060A000B042880033
+:10FC60000080FA00000006000000FA00C3E8A800C7
+:10FC700000000000000000000080FA000000060004
+:10FC80000000FA00F5FE070037FF070027FE070017
+:10FC9000F5FF0700E4FF07000080FA0000000600FF
+:10FCA0000200FA00000F78009E0078004180880072
+:10FCB0000000FE000080FA00000006000000FA00CC
+:10FCC000A0002100800778002002210000018800A8
+:10FCD0000080FA000000060000100000080000008C
+:10FCE000800000000A1000002000000080000000DA
+:10FCF000081000000200000082000000FFFF00006A
+:10FD000000000000767B0400000000000040DA00E4
+:08FD10000000FE0000000500E8
+:020000040015E5
+:04FE0000F77FFF0089
+:04FE2000F0FFFF00F0
+:04FE300078FFFF0058
+:04FE380078FFFF0050
+:04FE4000F453FF0078
+:04FE4800FFFFFF00B9
+:04FE5000DFFFFF00D1
+:04FE58000000FF00A7
+:04FE60000000FF009F
+:04FE68000000FF0097
+:04FE70000000FF008F
+:04FE7800FFFFFF0089
+:04FE8000FFFCFF0084
+:04FE8800FFFFFF0079
+:04FFF800FFFFFF0008
+:020000040100F9
+:04300000FFFFFF00CF
+:00000001FF