1 # SPDX-License-Identifier: GPL-2.0+
2 # Copyright (c) 2012 The Chromium OS Authors.
5 """Tests for the dtb_platdata module
7 This includes unit tests for some functions and functional tests for the dtoc
17 from dtb_platdata import conv_name_to_c
18 from dtb_platdata import get_compat_name
19 from dtb_platdata import get_value
20 from dtb_platdata import tab_to
25 our_path = os.path.dirname(os.path.realpath(__file__))
31 * This file was generated by dtoc from a .dtb (device tree binary) file.
35 #include <linux/libfdt.h>'''
40 * This file was generated by dtoc from a .dtb (device tree binary) file.
45 #include <dt-structs.h>
49 def get_dtb_file(dts_fname):
50 """Compile a .dts file to a .dtb
53 dts_fname: Filename of .dts file in the current directory
56 Filename of compiled file in output directory
58 return fdt_util.EnsureCompiled(os.path.join(our_path, dts_fname))
61 class TestDtoc(unittest.TestCase):
65 tools.PrepareOutputDir(None)
68 def tearDownClass(cls):
69 tools._RemoveOutputDir()
71 def _WritePythonString(self, fname, data):
72 """Write a string with tabs expanded as done in this Python file
75 fname: Filename to write to
76 data: Raw string to convert
78 data = data.replace('\t', '\\t')
79 with open(fname, 'w') as fd:
82 def _CheckStrings(self, expected, actual):
83 """Check that a string matches its expected value
85 If the strings do not match, they are written to the /tmp directory in
86 the same Python format as is used here in the test. This allows for
87 easy comparison and update of the tests.
90 expected: Expected string
93 if expected != actual:
94 self._WritePythonString('/tmp/binman.expected', expected)
95 self._WritePythonString('/tmp/binman.actual', actual)
96 print 'Failures written to /tmp/binman.{expected,actual}'
97 self.assertEquals(expected, actual)
100 """Test conversion of device tree names to C identifiers"""
101 self.assertEqual('serial_at_0x12', conv_name_to_c('serial@0x12'))
102 self.assertEqual('vendor_clock_frequency',
103 conv_name_to_c('vendor,clock-frequency'))
104 self.assertEqual('rockchip_rk3399_sdhci_5_1',
105 conv_name_to_c('rockchip,rk3399-sdhci-5.1'))
107 def test_tab_to(self):
108 """Test operation of tab_to() function"""
109 self.assertEqual('fred ', tab_to(0, 'fred'))
110 self.assertEqual('fred\t', tab_to(1, 'fred'))
111 self.assertEqual('fred was here ', tab_to(1, 'fred was here'))
112 self.assertEqual('fred was here\t\t', tab_to(3, 'fred was here'))
113 self.assertEqual('exactly8 ', tab_to(1, 'exactly8'))
114 self.assertEqual('exactly8\t', tab_to(2, 'exactly8'))
116 def test_get_value(self):
117 """Test operation of get_value() function"""
118 self.assertEqual('0x45',
119 get_value(fdt.TYPE_INT, struct.pack('>I', 0x45)))
120 self.assertEqual('0x45',
121 get_value(fdt.TYPE_BYTE, struct.pack('<I', 0x45)))
122 self.assertEqual('0x0',
123 get_value(fdt.TYPE_BYTE, struct.pack('>I', 0x45)))
124 self.assertEqual('"test"', get_value(fdt.TYPE_STRING, 'test'))
125 self.assertEqual('true', get_value(fdt.TYPE_BOOL, None))
127 def test_get_compat_name(self):
128 """Test operation of get_compat_name() function"""
129 Prop = collections.namedtuple('Prop', ['value'])
130 Node = collections.namedtuple('Node', ['props'])
132 prop = Prop(['rockchip,rk3399-sdhci-5.1', 'arasan,sdhci-5.1'])
133 node = Node({'compatible': prop})
134 self.assertEqual(('rockchip_rk3399_sdhci_5_1', ['arasan_sdhci_5_1']),
135 get_compat_name(node))
137 prop = Prop(['rockchip,rk3399-sdhci-5.1'])
138 node = Node({'compatible': prop})
139 self.assertEqual(('rockchip_rk3399_sdhci_5_1', []),
140 get_compat_name(node))
142 prop = Prop(['rockchip,rk3399-sdhci-5.1', 'arasan,sdhci-5.1', 'third'])
143 node = Node({'compatible': prop})
144 self.assertEqual(('rockchip_rk3399_sdhci_5_1',
145 ['arasan_sdhci_5_1', 'third']),
146 get_compat_name(node))
148 def test_empty_file(self):
149 """Test output from a device tree file with no nodes"""
150 dtb_file = get_dtb_file('dtoc_test_empty.dts')
151 output = tools.GetOutputFilename('output')
152 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
153 with open(output) as infile:
154 lines = infile.read().splitlines()
155 self.assertEqual(HEADER.splitlines(), lines)
157 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
158 with open(output) as infile:
159 lines = infile.read().splitlines()
160 self.assertEqual(C_HEADER.splitlines() + [''], lines)
162 def test_simple(self):
163 """Test output from some simple nodes with various types of data"""
164 dtb_file = get_dtb_file('dtoc_test_simple.dts')
165 output = tools.GetOutputFilename('output')
166 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
167 with open(output) as infile:
169 self._CheckStrings(HEADER + '''
170 struct dtd_sandbox_i2c_test {
172 struct dtd_sandbox_pmic_test {
176 struct dtd_sandbox_spl_test {
178 \tunsigned char\tbytearray[3];
179 \tunsigned char\tbyteval;
180 \tfdt32_t\t\tintarray[4];
182 \tunsigned char\tlongbytearray[9];
183 \tunsigned char\tnotstring[5];
184 \tconst char *\tstringarray[3];
185 \tconst char *\tstringval;
187 struct dtd_sandbox_spl_test_2 {
191 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
192 with open(output) as infile:
194 self._CheckStrings(C_HEADER + '''
195 static struct dtd_sandbox_spl_test dtv_spl_test = {
196 \t.bytearray\t\t= {0x6, 0x0, 0x0},
198 \t.intval\t\t\t= 0x1,
199 \t.notstring\t\t= {0x20, 0x21, 0x22, 0x10, 0x0},
200 \t.longbytearray\t\t= {0x9, 0xa, 0xb, 0xc, 0xd, 0xe, 0xf, 0x10,
202 \t.stringval\t\t= "message",
203 \t.boolval\t\t= true,
204 \t.intarray\t\t= {0x2, 0x3, 0x4, 0x0},
205 \t.stringarray\t\t= {"multi-word", "message", ""},
207 U_BOOT_DEVICE(spl_test) = {
208 \t.name\t\t= "sandbox_spl_test",
209 \t.platdata\t= &dtv_spl_test,
210 \t.platdata_size\t= sizeof(dtv_spl_test),
213 static struct dtd_sandbox_spl_test dtv_spl_test2 = {
214 \t.bytearray\t\t= {0x1, 0x23, 0x34},
216 \t.intval\t\t\t= 0x3,
217 \t.longbytearray\t\t= {0x9, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
219 \t.stringval\t\t= "message2",
220 \t.intarray\t\t= {0x5, 0x0, 0x0, 0x0},
221 \t.stringarray\t\t= {"another", "multi-word", "message"},
223 U_BOOT_DEVICE(spl_test2) = {
224 \t.name\t\t= "sandbox_spl_test",
225 \t.platdata\t= &dtv_spl_test2,
226 \t.platdata_size\t= sizeof(dtv_spl_test2),
229 static struct dtd_sandbox_spl_test dtv_spl_test3 = {
230 \t.stringarray\t\t= {"one", "", ""},
232 U_BOOT_DEVICE(spl_test3) = {
233 \t.name\t\t= "sandbox_spl_test",
234 \t.platdata\t= &dtv_spl_test3,
235 \t.platdata_size\t= sizeof(dtv_spl_test3),
238 static struct dtd_sandbox_spl_test_2 dtv_spl_test4 = {
240 U_BOOT_DEVICE(spl_test4) = {
241 \t.name\t\t= "sandbox_spl_test_2",
242 \t.platdata\t= &dtv_spl_test4,
243 \t.platdata_size\t= sizeof(dtv_spl_test4),
246 static struct dtd_sandbox_i2c_test dtv_i2c_at_0 = {
248 U_BOOT_DEVICE(i2c_at_0) = {
249 \t.name\t\t= "sandbox_i2c_test",
250 \t.platdata\t= &dtv_i2c_at_0,
251 \t.platdata_size\t= sizeof(dtv_i2c_at_0),
254 static struct dtd_sandbox_pmic_test dtv_pmic_at_9 = {
255 \t.low_power\t\t= true,
256 \t.reg\t\t\t= {0x9, 0x0},
258 U_BOOT_DEVICE(pmic_at_9) = {
259 \t.name\t\t= "sandbox_pmic_test",
260 \t.platdata\t= &dtv_pmic_at_9,
261 \t.platdata_size\t= sizeof(dtv_pmic_at_9),
266 def test_phandle(self):
267 """Test output from a node containing a phandle reference"""
268 dtb_file = get_dtb_file('dtoc_test_phandle.dts')
269 output = tools.GetOutputFilename('output')
270 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
271 with open(output) as infile:
273 self._CheckStrings(HEADER + '''
275 \tstruct phandle_2_arg clocks[4];
282 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
283 with open(output) as infile:
285 self._CheckStrings(C_HEADER + '''
286 static struct dtd_target dtv_phandle_target = {
287 \t.intval\t\t\t= 0x0,
289 U_BOOT_DEVICE(phandle_target) = {
290 \t.name\t\t= "target",
291 \t.platdata\t= &dtv_phandle_target,
292 \t.platdata_size\t= sizeof(dtv_phandle_target),
295 static struct dtd_target dtv_phandle2_target = {
296 \t.intval\t\t\t= 0x1,
298 U_BOOT_DEVICE(phandle2_target) = {
299 \t.name\t\t= "target",
300 \t.platdata\t= &dtv_phandle2_target,
301 \t.platdata_size\t= sizeof(dtv_phandle2_target),
304 static struct dtd_target dtv_phandle3_target = {
305 \t.intval\t\t\t= 0x2,
307 U_BOOT_DEVICE(phandle3_target) = {
308 \t.name\t\t= "target",
309 \t.platdata\t= &dtv_phandle3_target,
310 \t.platdata_size\t= sizeof(dtv_phandle3_target),
313 static struct dtd_source dtv_phandle_source = {
315 \t\t\t{&dtv_phandle_target, {}},
316 \t\t\t{&dtv_phandle2_target, {11}},
317 \t\t\t{&dtv_phandle3_target, {12, 13}},
318 \t\t\t{&dtv_phandle_target, {}},},
320 U_BOOT_DEVICE(phandle_source) = {
321 \t.name\t\t= "source",
322 \t.platdata\t= &dtv_phandle_source,
323 \t.platdata_size\t= sizeof(dtv_phandle_source),
326 static struct dtd_source dtv_phandle_source2 = {
328 \t\t\t{&dtv_phandle_target, {}},},
330 U_BOOT_DEVICE(phandle_source2) = {
331 \t.name\t\t= "source",
332 \t.platdata\t= &dtv_phandle_source2,
333 \t.platdata_size\t= sizeof(dtv_phandle_source2),
338 def test_aliases(self):
339 """Test output from a node with multiple compatible strings"""
340 dtb_file = get_dtb_file('dtoc_test_aliases.dts')
341 output = tools.GetOutputFilename('output')
342 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
343 with open(output) as infile:
345 self._CheckStrings(HEADER + '''
349 #define dtd_compat2_1_fred dtd_compat1
350 #define dtd_compat3 dtd_compat1
353 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
354 with open(output) as infile:
356 self._CheckStrings(C_HEADER + '''
357 static struct dtd_compat1 dtv_spl_test = {
358 \t.intval\t\t\t= 0x1,
360 U_BOOT_DEVICE(spl_test) = {
361 \t.name\t\t= "compat1",
362 \t.platdata\t= &dtv_spl_test,
363 \t.platdata_size\t= sizeof(dtv_spl_test),
368 def test_addresses64(self):
369 """Test output from a node with a 'reg' property with na=2, ns=2"""
370 dtb_file = get_dtb_file('dtoc_test_addr64.dts')
371 output = tools.GetOutputFilename('output')
372 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
373 with open(output) as infile:
375 self._CheckStrings(HEADER + '''
387 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
388 with open(output) as infile:
390 self._CheckStrings(C_HEADER + '''
391 static struct dtd_test1 dtv_test1 = {
392 \t.reg\t\t\t= {0x1234, 0x5678},
394 U_BOOT_DEVICE(test1) = {
395 \t.name\t\t= "test1",
396 \t.platdata\t= &dtv_test1,
397 \t.platdata_size\t= sizeof(dtv_test1),
400 static struct dtd_test2 dtv_test2 = {
401 \t.reg\t\t\t= {0x1234567890123456, 0x9876543210987654},
403 U_BOOT_DEVICE(test2) = {
404 \t.name\t\t= "test2",
405 \t.platdata\t= &dtv_test2,
406 \t.platdata_size\t= sizeof(dtv_test2),
409 static struct dtd_test3 dtv_test3 = {
410 \t.reg\t\t\t= {0x1234567890123456, 0x9876543210987654, 0x2, 0x3},
412 U_BOOT_DEVICE(test3) = {
413 \t.name\t\t= "test3",
414 \t.platdata\t= &dtv_test3,
415 \t.platdata_size\t= sizeof(dtv_test3),
420 def test_addresses32(self):
421 """Test output from a node with a 'reg' property with na=1, ns=1"""
422 dtb_file = get_dtb_file('dtoc_test_addr32.dts')
423 output = tools.GetOutputFilename('output')
424 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
425 with open(output) as infile:
427 self._CheckStrings(HEADER + '''
436 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
437 with open(output) as infile:
439 self._CheckStrings(C_HEADER + '''
440 static struct dtd_test1 dtv_test1 = {
441 \t.reg\t\t\t= {0x1234, 0x5678},
443 U_BOOT_DEVICE(test1) = {
444 \t.name\t\t= "test1",
445 \t.platdata\t= &dtv_test1,
446 \t.platdata_size\t= sizeof(dtv_test1),
449 static struct dtd_test2 dtv_test2 = {
450 \t.reg\t\t\t= {0x12345678, 0x98765432, 0x2, 0x3},
452 U_BOOT_DEVICE(test2) = {
453 \t.name\t\t= "test2",
454 \t.platdata\t= &dtv_test2,
455 \t.platdata_size\t= sizeof(dtv_test2),
460 def test_addresses64_32(self):
461 """Test output from a node with a 'reg' property with na=2, ns=1"""
462 dtb_file = get_dtb_file('dtoc_test_addr64_32.dts')
463 output = tools.GetOutputFilename('output')
464 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
465 with open(output) as infile:
467 self._CheckStrings(HEADER + '''
479 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
480 with open(output) as infile:
482 self._CheckStrings(C_HEADER + '''
483 static struct dtd_test1 dtv_test1 = {
484 \t.reg\t\t\t= {0x123400000000, 0x5678},
486 U_BOOT_DEVICE(test1) = {
487 \t.name\t\t= "test1",
488 \t.platdata\t= &dtv_test1,
489 \t.platdata_size\t= sizeof(dtv_test1),
492 static struct dtd_test2 dtv_test2 = {
493 \t.reg\t\t\t= {0x1234567890123456, 0x98765432},
495 U_BOOT_DEVICE(test2) = {
496 \t.name\t\t= "test2",
497 \t.platdata\t= &dtv_test2,
498 \t.platdata_size\t= sizeof(dtv_test2),
501 static struct dtd_test3 dtv_test3 = {
502 \t.reg\t\t\t= {0x1234567890123456, 0x98765432, 0x2, 0x3},
504 U_BOOT_DEVICE(test3) = {
505 \t.name\t\t= "test3",
506 \t.platdata\t= &dtv_test3,
507 \t.platdata_size\t= sizeof(dtv_test3),
512 def test_addresses32_64(self):
513 """Test output from a node with a 'reg' property with na=1, ns=2"""
514 dtb_file = get_dtb_file('dtoc_test_addr32_64.dts')
515 output = tools.GetOutputFilename('output')
516 dtb_platdata.run_steps(['struct'], dtb_file, False, output)
517 with open(output) as infile:
519 self._CheckStrings(HEADER + '''
531 dtb_platdata.run_steps(['platdata'], dtb_file, False, output)
532 with open(output) as infile:
534 self._CheckStrings(C_HEADER + '''
535 static struct dtd_test1 dtv_test1 = {
536 \t.reg\t\t\t= {0x1234, 0x567800000000},
538 U_BOOT_DEVICE(test1) = {
539 \t.name\t\t= "test1",
540 \t.platdata\t= &dtv_test1,
541 \t.platdata_size\t= sizeof(dtv_test1),
544 static struct dtd_test2 dtv_test2 = {
545 \t.reg\t\t\t= {0x12345678, 0x9876543210987654},
547 U_BOOT_DEVICE(test2) = {
548 \t.name\t\t= "test2",
549 \t.platdata\t= &dtv_test2,
550 \t.platdata_size\t= sizeof(dtv_test2),
553 static struct dtd_test3 dtv_test3 = {
554 \t.reg\t\t\t= {0x12345678, 0x9876543210987654, 0x2, 0x3},
556 U_BOOT_DEVICE(test3) = {
557 \t.name\t\t= "test3",
558 \t.platdata\t= &dtv_test3,
559 \t.platdata_size\t= sizeof(dtv_test3),