Anders Blomdell / mbed-sdk-tools

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

patch.py@35:da9c89f8be7d, 2017-02-15 (annotated)

Committer:
The Other Jimmy
Date:
Wed Feb 15 13:53:18 2017 -0600
Revision:
35:da9c89f8be7d
Parent:
0:66f3b5499f7f 
Update tools to mbed-os 5.3.5

Who changed what in which revision?

UserRevisionLine numberNew contents of line
screamer 0:66f3b5499f7f 1 """
screamer 0:66f3b5499f7f 2 mbed SDK
screamer 0:66f3b5499f7f 3 Copyright (c) 2011-2013 ARM Limited
screamer 0:66f3b5499f7f 4
screamer 0:66f3b5499f7f 5 Licensed under the Apache License, Version 2.0 (the "License");
screamer 0:66f3b5499f7f 6 you may not use this file except in compliance with the License.
screamer 0:66f3b5499f7f 7 You may obtain a copy of the License at
screamer 0:66f3b5499f7f 8
screamer 0:66f3b5499f7f 9 http://www.apache.org/licenses/LICENSE-2.0
screamer 0:66f3b5499f7f 10
screamer 0:66f3b5499f7f 11 Unless required by applicable law or agreed to in writing, software
screamer 0:66f3b5499f7f 12 distributed under the License is distributed on an "AS IS" BASIS,
screamer 0:66f3b5499f7f 13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
screamer 0:66f3b5499f7f 14 See the License for the specific language governing permissions and
screamer 0:66f3b5499f7f 15 limitations under the License.
screamer 0:66f3b5499f7f 16
screamer 0:66f3b5499f7f 17
screamer 0:66f3b5499f7f 18 http://www.nxp.com/documents/user_manual/UM10360.pdf
screamer 0:66f3b5499f7f 19
screamer 0:66f3b5499f7f 20 32.3.1.1 Criterion for Valid User Code
screamer 0:66f3b5499f7f 21 The reserved Cortex-M3 exception vector location 7 (offset 0x1C in the vector table)
screamer 0:66f3b5499f7f 22 should contain the 2's complement of the check-sum of table entries 0 through 6. This
screamer 0:66f3b5499f7f 23 causes the checksum of the first 8 table entries to be 0. The boot loader code checksums
screamer 0:66f3b5499f7f 24 the first 8 locations in sector 0 of the flash. If the result is 0, then execution control is
screamer 0:66f3b5499f7f 25 transferred to the user code.
screamer 0:66f3b5499f7f 26 """
screamer 0:66f3b5499f7f 27 from struct import unpack, pack
screamer 0:66f3b5499f7f 28
screamer 0:66f3b5499f7f 29
screamer 0:66f3b5499f7f 30 def patch(bin_path):
screamer 0:66f3b5499f7f 31 with open(bin_path, 'r+b') as bin:
screamer 0:66f3b5499f7f 32 # Read entries 0 through 6 (Little Endian 32bits words)
screamer 0:66f3b5499f7f 33 vector = [unpack('<I', bin.read(4))[0] for _ in range(7)]
screamer 0:66f3b5499f7f 34
screamer 0:66f3b5499f7f 35 # location 7 (offset 0x1C in the vector table) should contain the 2's
screamer 0:66f3b5499f7f 36 # complement of the check-sum of table entries 0 through 6
screamer 0:66f3b5499f7f 37 bin.seek(0x1C)
screamer 0:66f3b5499f7f 38 bin.write(pack('<I', (~sum(vector) + 1) & 0xFFFFFFFF))
screamer 0:66f3b5499f7f 39
screamer 0:66f3b5499f7f 40
screamer 0:66f3b5499f7f 41 def is_patched(bin_path):
screamer 0:66f3b5499f7f 42 with open(bin_path, 'rb') as bin:
screamer 0:66f3b5499f7f 43 # The checksum of the first 8 table entries should be 0
screamer 0:66f3b5499f7f 44 return (sum([unpack('<I', bin.read(4))[0] for _ in range(8)]) & 0xFFFFFFFF) == 0
screamer 0:66f3b5499f7f 45
screamer 0:66f3b5499f7f 46
screamer 0:66f3b5499f7f 47 if __name__ == '__main__':
screamer 0:66f3b5499f7f 48 bin_path = "C:/Users/emimon01/releases/emilmont/build/test/LPC1768/ARM/MBED_A1/basic.bin"
screamer 0:66f3b5499f7f 49 patch(bin_path)
screamer 0:66f3b5499f7f 50 assert is_patched(bin_path), "The file is not patched"