• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1#!/usr/bin/env python3
2"""
3# SPDX-License-Identifier: GPL-2.0+
4#
5# A script to generate FIT image source for rockchip boards
6# with ARM Trusted Firmware
7# and multiple device trees (given on the command line)
8#
9# usage: $0 <dt_name> [<dt_name> [<dt_name] ...]
10"""
11
12import os
13import sys
14import getopt
15import logging
16import struct
17
18DT_HEADER = """
19/*
20 * This is a generated file.
21 */
22/dts-v1/;
23
24/ {
25	description = "FIT image for U-Boot with bl31 (TF-A)";
26	#address-cells = <1>;
27
28	images {
29"""
30
31DT_UBOOT = """
32		uboot {
33			description = "U-Boot (64-bit)";
34			data = /incbin/("u-boot-nodtb.bin");
35			type = "standalone";
36			os = "U-Boot";
37			arch = "arm64";
38			compression = "none";
39			load = <0x%08x>;
40		};
41
42"""
43
44DT_IMAGES_NODE_END = """	};
45
46"""
47
48DT_END = "};"
49
50def append_bl31_node(file, atf_index, phy_addr, elf_entry):
51    # Append BL31 DT node to input FIT dts file.
52    data = 'bl31_0x%08x.bin' % phy_addr
53    file.write('\t\tatf_%d {\n' % atf_index)
54    file.write('\t\t\tdescription = \"ARM Trusted Firmware\";\n')
55    file.write('\t\t\tdata = /incbin/("%s");\n' % data)
56    file.write('\t\t\ttype = "firmware";\n')
57    file.write('\t\t\tarch = "arm64";\n')
58    file.write('\t\t\tos = "arm-trusted-firmware";\n')
59    file.write('\t\t\tcompression = "none";\n')
60    file.write('\t\t\tload = <0x%08x>;\n' % phy_addr)
61    if atf_index == 1:
62        file.write('\t\t\tentry = <0x%08x>;\n' % elf_entry)
63    file.write('\t\t};\n')
64    file.write('\n')
65
66def append_tee_node(file, atf_index, phy_addr, elf_entry):
67    # Append TEE DT node to input FIT dts file.
68    data = 'tee_0x%08x.bin' % phy_addr
69    file.write('\t\tatf_%d {\n' % atf_index)
70    file.write('\t\t\tdescription = \"TEE\";\n')
71    file.write('\t\t\tdata = /incbin/("%s");\n' % data)
72    file.write('\t\t\ttype = "tee";\n')
73    file.write('\t\t\tarch = "arm64";\n')
74    file.write('\t\t\tos = "tee";\n')
75    file.write('\t\t\tcompression = "none";\n')
76    file.write('\t\t\tload = <0x%08x>;\n' % phy_addr)
77    file.write('\t\t\tentry = <0x%08x>;\n' % elf_entry)
78    file.write('\t\t};\n')
79    file.write('\n')
80
81def append_fdt_node(file, dtbs):
82    # Append FDT nodes.
83    cnt = 1
84    for dtb in dtbs:
85        dtname = os.path.basename(dtb)
86        file.write('\t\tfdt_%d {\n' % cnt)
87        file.write('\t\t\tdescription = "%s";\n' % dtname)
88        file.write('\t\t\tdata = /incbin/("%s");\n' % dtb)
89        file.write('\t\t\ttype = "flat_dt";\n')
90        file.write('\t\t\tcompression = "none";\n')
91        file.write('\t\t};\n')
92        file.write('\n')
93        cnt = cnt + 1
94
95def append_conf_section(file, cnt, dtname, segments):
96    file.write('\t\tconfig_%d {\n' % cnt)
97    file.write('\t\t\tdescription = "%s";\n' % dtname)
98    file.write('\t\t\tfirmware = "atf_1";\n')
99    file.write('\t\t\tloadables = "uboot"')
100    if segments > 1:
101        file.write(',')
102    for i in range(1, segments):
103        file.write('"atf_%d"' % (i + 1))
104        if i != (segments - 1):
105            file.write(',')
106        else:
107            file.write(';\n')
108    if segments <= 1:
109        file.write(';\n')
110    file.write('\t\t\tfdt = "fdt_1";\n')
111    file.write('\t\t};\n')
112    file.write('\n')
113
114def append_conf_node(file, dtbs, segments):
115    # Append configeration nodes.
116    cnt = 1
117    file.write('\tconfigurations {\n')
118    file.write('\t\tdefault = "config_1";\n')
119    for dtb in dtbs:
120        dtname = os.path.basename(dtb)
121        append_conf_section(file, cnt, dtname, segments)
122        cnt = cnt + 1
123    file.write('\t};\n')
124    file.write('\n')
125
126def generate_atf_fit_dts_uboot(fit_file, uboot_file_name):
127    segments = unpack_elf(uboot_file_name)
128    if len(segments) != 1:
129        raise ValueError("Invalid u-boot ELF image '%s'" % uboot_file_name)
130    index, entry, p_paddr, data = segments[0]
131    fit_file.write(DT_UBOOT % p_paddr)
132
133def generate_atf_fit_dts_bl31(fit_file, bl31_file_name, tee_file_name, dtbs_file_name):
134    segments = unpack_elf(bl31_file_name)
135    for index, entry, paddr, data in segments:
136        append_bl31_node(fit_file, index + 1, paddr, entry)
137    num_segments = len(segments)
138
139    if tee_file_name:
140        tee_segments = unpack_elf(tee_file_name)
141        for index, entry, paddr, data in tee_segments:
142            append_tee_node(fit_file, num_segments + index + 1, paddr, entry)
143        num_segments = num_segments + len(tee_segments)
144
145    append_fdt_node(fit_file, dtbs_file_name)
146    fit_file.write(DT_IMAGES_NODE_END)
147    append_conf_node(fit_file, dtbs_file_name, num_segments)
148
149def generate_atf_fit_dts(fit_file_name, bl31_file_name, tee_file_name, uboot_file_name, dtbs_file_name):
150    # Generate FIT script for ATF image.
151    if fit_file_name != sys.stdout:
152        fit_file = open(fit_file_name, "wb")
153    else:
154        fit_file = sys.stdout
155
156    fit_file.write(DT_HEADER)
157    generate_atf_fit_dts_uboot(fit_file, uboot_file_name)
158    generate_atf_fit_dts_bl31(fit_file, bl31_file_name, tee_file_name, dtbs_file_name)
159    fit_file.write(DT_END)
160
161    if fit_file_name != sys.stdout:
162        fit_file.close()
163
164def generate_atf_binary(bl31_file_name):
165    for index, entry, paddr, data in unpack_elf(bl31_file_name):
166        file_name = 'bl31_0x%08x.bin' % paddr
167        with open(file_name, "wb") as atf:
168            atf.write(data)
169
170def generate_tee_binary(tee_file_name):
171    if tee_file_name:
172        for index, entry, paddr, data in unpack_elf(tee_file_name):
173            file_name = 'tee_0x%08x.bin' % paddr
174            with open(file_name, "wb") as atf:
175                atf.write(data)
176
177def unpack_elf(filename):
178    with open(filename, 'rb') as file:
179        elf = file.read()
180    if elf[0:7] != b'\x7fELF\x02\x01\x01' or elf[18:20] != b'\xb7\x00':
181        raise ValueError("Invalid arm64 ELF file '%s'" % filename)
182
183    e_entry, e_phoff = struct.unpack_from('<2Q', elf, 0x18)
184    e_phentsize, e_phnum = struct.unpack_from('<2H', elf, 0x36)
185    segments = []
186
187    for index in range(e_phnum):
188        offset = e_phoff + e_phentsize * index
189        p_type, p_flags, p_offset = struct.unpack_from('<LLQ', elf, offset)
190        if p_type == 1: # PT_LOAD
191            p_paddr, p_filesz = struct.unpack_from('<2Q', elf, offset + 0x18)
192            p_data = elf[p_offset:p_offset + p_filesz]
193            segments.append((index, e_entry, p_paddr, p_data))
194    return segments
195
196def main():
197    uboot_elf = "./u-boot"
198    fit_its = sys.stdout
199    if "BL31" in os.environ:
200        bl31_elf=os.getenv("BL31");
201    elif os.path.isfile("./bl31.elf"):
202        bl31_elf = "./bl31.elf"
203    else:
204        os.system("echo 'int main(){}' > bl31.c")
205        os.system("${CROSS_COMPILE}gcc -c bl31.c -o bl31.elf")
206        bl31_elf = "./bl31.elf"
207        logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG)
208        logging.warning(' BL31 file bl31.elf NOT found, resulting binary is non-functional')
209        logging.warning(' Please read Building section in doc/README.rockchip')
210
211    if "TEE" in os.environ:
212        tee_elf = os.getenv("TEE")
213    elif os.path.isfile("./tee.elf"):
214        tee_elf = "./tee.elf"
215    else:
216        tee_elf = ""
217
218    opts, args = getopt.getopt(sys.argv[1:], "o:u:b:t:h")
219    for opt, val in opts:
220        if opt == "-o":
221            fit_its = val
222        elif opt == "-u":
223            uboot_elf = val
224        elif opt == "-b":
225            bl31_elf = val
226        elif opt == "-t":
227            tee_elf = val
228        elif opt == "-h":
229            print(__doc__)
230            sys.exit(2)
231
232    dtbs = args
233
234    generate_atf_fit_dts(fit_its, bl31_elf, tee_elf, uboot_elf, dtbs)
235    generate_atf_binary(bl31_elf)
236    generate_tee_binary(tee_elf)
237
238if __name__ == "__main__":
239    main()
240