mirror of
https://github.com/smaeul/u-boot.git
synced 2025-11-03 21:48:15 +00:00
589c2d9e51
Allow phandles to be copied over from a template. This can potentially cause duplicate phandles, so detect this and report an error. Signed-off-by: Simon Glass <sjg@chromium.org>
1003 lines
38 KiB
Python
Executable File
1003 lines
38 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
# SPDX-License-Identifier: GPL-2.0+
|
|
|
|
"""
|
|
Tests for the Fdt module
|
|
Copyright (c) 2018 Google, Inc
|
|
Written by Simon Glass <sjg@chromium.org>
|
|
"""
|
|
|
|
from argparse import ArgumentParser
|
|
import os
|
|
import shutil
|
|
import sys
|
|
import tempfile
|
|
import unittest
|
|
|
|
# Bring in the patman libraries
|
|
our_path = os.path.dirname(os.path.realpath(__file__))
|
|
sys.path.insert(1, os.path.join(our_path, '..'))
|
|
|
|
# Bring in the libfdt module
|
|
sys.path.insert(2, 'scripts/dtc/pylibfdt')
|
|
sys.path.insert(2, os.path.join(our_path, '../../scripts/dtc/pylibfdt'))
|
|
sys.path.insert(2, os.path.join(our_path,
|
|
'../../build-sandbox_spl/scripts/dtc/pylibfdt'))
|
|
|
|
#pylint: disable=wrong-import-position
|
|
from dtoc import fdt
|
|
from dtoc import fdt_util
|
|
from dtoc.fdt_util import fdt32_to_cpu, fdt64_to_cpu
|
|
from dtoc.fdt import Type, BytesToValue
|
|
import libfdt
|
|
from u_boot_pylib import test_util
|
|
from u_boot_pylib import tools
|
|
from u_boot_pylib import tout
|
|
|
|
#pylint: disable=protected-access
|
|
|
|
def _get_property_value(dtb, node, prop_name):
|
|
"""Low-level function to get the property value based on its offset
|
|
|
|
This looks directly in the device tree at the property's offset to find
|
|
its value. It is useful as a check that the property is in the correct
|
|
place.
|
|
|
|
Args:
|
|
node: Node to look in
|
|
prop_name: Property name to find
|
|
|
|
Returns:
|
|
Tuple:
|
|
Prop object found
|
|
Value of property as a string (found using property offset)
|
|
"""
|
|
prop = node.props[prop_name]
|
|
|
|
# Add 12, which is sizeof(struct fdt_property), to get to start of data
|
|
offset = prop.GetOffset() + 12
|
|
data = dtb.GetContents()[offset:offset + len(prop.value)]
|
|
return prop, [chr(x) for x in data]
|
|
|
|
def find_dtb_file(dts_fname):
|
|
"""Locate a test file in the test/ directory
|
|
|
|
Args:
|
|
dts_fname (str): Filename to find, e.g. 'dtoc_test_simple.dts]
|
|
|
|
Returns:
|
|
str: Path to the test filename
|
|
"""
|
|
return os.path.join('tools/dtoc/test', dts_fname)
|
|
|
|
|
|
class TestFdt(unittest.TestCase):
|
|
"""Tests for the Fdt module
|
|
|
|
This includes unit tests for some functions and functional tests for the fdt
|
|
module.
|
|
"""
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
tools.prepare_output_dir(None)
|
|
|
|
@classmethod
|
|
def tearDownClass(cls):
|
|
tools.finalise_output_dir()
|
|
|
|
def setUp(self):
|
|
self.dtb = fdt.FdtScan(find_dtb_file('dtoc_test_simple.dts'))
|
|
|
|
def test_fdt(self):
|
|
"""Test that we can open an Fdt"""
|
|
self.dtb.Scan()
|
|
root = self.dtb.GetRoot()
|
|
self.assertTrue(isinstance(root, fdt.Node))
|
|
|
|
def test_get_node(self):
|
|
"""Test the GetNode() method"""
|
|
node = self.dtb.GetNode('/spl-test')
|
|
self.assertTrue(isinstance(node, fdt.Node))
|
|
|
|
node = self.dtb.GetNode('/i2c@0/pmic@9')
|
|
self.assertTrue(isinstance(node, fdt.Node))
|
|
self.assertEqual('pmic@9', node.name)
|
|
self.assertIsNone(self.dtb.GetNode('/i2c@0/pmic@9/missing'))
|
|
|
|
node = self.dtb.GetNode('/')
|
|
self.assertTrue(isinstance(node, fdt.Node))
|
|
self.assertEqual(0, node.Offset())
|
|
|
|
def test_flush(self):
|
|
"""Check that we can flush the device tree out to its file"""
|
|
fname = self.dtb._fname
|
|
with open(fname, 'rb') as inf:
|
|
inf.read()
|
|
os.remove(fname)
|
|
with self.assertRaises(IOError):
|
|
with open(fname, 'rb'):
|
|
pass
|
|
self.dtb.Flush()
|
|
with open(fname, 'rb') as inf:
|
|
inf.read()
|
|
|
|
def test_pack(self):
|
|
"""Test that packing a device tree works"""
|
|
self.dtb.Pack()
|
|
|
|
def test_get_fdt_raw(self):
|
|
"""Tetst that we can access the raw device-tree data"""
|
|
self.assertTrue(isinstance(self.dtb.GetContents(), bytes))
|
|
|
|
def test_get_props(self):
|
|
"""Tests obtaining a list of properties"""
|
|
node = self.dtb.GetNode('/spl-test')
|
|
props = self.dtb.GetProps(node)
|
|
self.assertEqual(['boolval', 'bootph-all', 'bytearray', 'byteval',
|
|
'compatible', 'int64val', 'intarray', 'intval',
|
|
'longbytearray', 'maybe-empty-int', 'notstring',
|
|
'stringarray', 'stringval', ],
|
|
sorted(props.keys()))
|
|
|
|
def test_check_error(self):
|
|
"""Tests the ChecKError() function"""
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt.CheckErr(-libfdt.NOTFOUND, 'hello')
|
|
self.assertIn('FDT_ERR_NOTFOUND: hello', str(exc.exception))
|
|
|
|
def test_get_fdt(self):
|
|
"""Test getting an Fdt object from a node"""
|
|
node = self.dtb.GetNode('/spl-test')
|
|
self.assertEqual(self.dtb, node.GetFdt())
|
|
|
|
def test_bytes_to_value(self):
|
|
"""Test converting a string list into Python"""
|
|
self.assertEqual(BytesToValue(b'this\0is\0'),
|
|
(Type.STRING, ['this', 'is']))
|
|
|
|
class TestNode(unittest.TestCase):
|
|
"""Test operation of the Node class"""
|
|
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
tools.prepare_output_dir(None)
|
|
|
|
@classmethod
|
|
def tearDownClass(cls):
|
|
tools.finalise_output_dir()
|
|
|
|
def setUp(self):
|
|
self.dtb = fdt.FdtScan(find_dtb_file('dtoc_test_simple.dts'))
|
|
self.node = self.dtb.GetNode('/spl-test')
|
|
self.fdt = self.dtb.GetFdtObj()
|
|
|
|
def test_offset(self):
|
|
"""Tests that we can obtain the offset of a node"""
|
|
self.assertTrue(self.node.Offset() > 0)
|
|
|
|
def test_delete(self):
|
|
"""Tests that we can delete a property"""
|
|
node2 = self.dtb.GetNode('/spl-test2')
|
|
offset1 = node2.Offset()
|
|
self.node.DeleteProp('intval')
|
|
offset2 = node2.Offset()
|
|
self.assertTrue(offset2 < offset1)
|
|
self.node.DeleteProp('intarray')
|
|
offset3 = node2.Offset()
|
|
self.assertTrue(offset3 < offset2)
|
|
with self.assertRaises(libfdt.FdtException):
|
|
self.node.DeleteProp('missing')
|
|
|
|
def test_delete_get_offset(self):
|
|
"""Test that property offset update when properties are deleted"""
|
|
self.node.DeleteProp('intval')
|
|
prop, value = _get_property_value(self.dtb, self.node, 'longbytearray')
|
|
self.assertEqual(prop.value, value)
|
|
|
|
def test_find_node(self):
|
|
"""Tests that we can find a node using the FindNode() functoin"""
|
|
node = self.dtb.GetRoot().FindNode('i2c@0')
|
|
self.assertEqual('i2c@0', node.name)
|
|
subnode = node.FindNode('pmic@9')
|
|
self.assertEqual('pmic@9', subnode.name)
|
|
self.assertEqual(None, node.FindNode('missing'))
|
|
|
|
def test_refresh_missing_node(self):
|
|
"""Test refreshing offsets when an extra node is present in dtb"""
|
|
# Delete it from our tables, not the device tree
|
|
del self.dtb._root.subnodes[-1]
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.dtb.Refresh()
|
|
self.assertIn('Internal error, offset', str(exc.exception))
|
|
|
|
def test_refresh_extra_node(self):
|
|
"""Test refreshing offsets when an expected node is missing"""
|
|
# Delete it from the device tre, not our tables
|
|
self.fdt.del_node(self.node.Offset())
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.dtb.Refresh()
|
|
self.assertIn('Internal error, node name mismatch '
|
|
'spl-test != spl-test2', str(exc.exception))
|
|
|
|
def test_refresh_missing_prop(self):
|
|
"""Test refreshing offsets when an extra property is present in dtb"""
|
|
# Delete it from our tables, not the device tree
|
|
del self.node.props['notstring']
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.dtb.Refresh()
|
|
self.assertIn("Internal error, node '/spl-test' property 'notstring' missing, offset ",
|
|
str(exc.exception))
|
|
|
|
def test_lookup_phandle(self):
|
|
"""Test looking up a single phandle"""
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_phandle.dts'))
|
|
node = dtb.GetNode('/phandle-source2')
|
|
prop = node.props['clocks']
|
|
target = dtb.GetNode('/phandle-target')
|
|
self.assertEqual(target, dtb.LookupPhandle(fdt32_to_cpu(prop.value)))
|
|
|
|
def test_add_node_space(self):
|
|
"""Test adding a single node when out of space"""
|
|
self.fdt.pack()
|
|
self.node.AddSubnode('subnode')
|
|
with self.assertRaises(libfdt.FdtException) as exc:
|
|
self.dtb.Sync(auto_resize=False)
|
|
self.assertIn('FDT_ERR_NOSPACE', str(exc.exception))
|
|
|
|
self.dtb.Sync(auto_resize=True)
|
|
offset = self.fdt.path_offset('/spl-test/subnode')
|
|
self.assertTrue(offset > 0)
|
|
|
|
def test_add_nodes(self):
|
|
"""Test adding various subnode and properies"""
|
|
node = self.dtb.GetNode('/i2c@0')
|
|
|
|
# Add one more node next to the pmic one
|
|
sn1 = node.AddSubnode('node-one')
|
|
sn1.AddInt('integer-a', 12)
|
|
sn1.AddInt('integer-b', 23)
|
|
|
|
# Sync so that everything is clean
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
# Add two subnodes next to pmic and node-one
|
|
sn2 = node.AddSubnode('node-two')
|
|
sn2.AddInt('integer-2a', 34)
|
|
sn2.AddInt('integer-2b', 45)
|
|
|
|
sn3 = node.AddSubnode('node-three')
|
|
sn3.AddInt('integer-3', 123)
|
|
|
|
# Add a property to the node after i2c@0 to check that this is not
|
|
# disturbed by adding a subnode to i2c@0
|
|
orig_node = self.dtb.GetNode('/orig-node')
|
|
orig_node.AddInt('integer-4', 456)
|
|
|
|
# Add a property to the pmic node to check that pmic properties are not
|
|
# disturbed
|
|
pmic = self.dtb.GetNode('/i2c@0/pmic@9')
|
|
pmic.AddInt('integer-5', 567)
|
|
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
def test_add_one_node(self):
|
|
"""Testing deleting and adding a subnode before syncing"""
|
|
subnode = self.node.AddSubnode('subnode')
|
|
self.node.AddSubnode('subnode2')
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
# Delete a node and add a new one
|
|
subnode.Delete()
|
|
self.node.AddSubnode('subnode3')
|
|
self.dtb.Sync()
|
|
|
|
def test_refresh_name_mismatch(self):
|
|
"""Test name mismatch when syncing nodes and properties"""
|
|
self.node.AddInt('integer-a', 12)
|
|
|
|
wrong_offset = self.dtb.GetNode('/i2c@0')._offset
|
|
self.node._offset = wrong_offset
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.dtb.Sync()
|
|
self.assertIn("Internal error, node '/spl-test' name mismatch 'i2c@0'",
|
|
str(exc.exception))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.node.Refresh(wrong_offset)
|
|
self.assertIn("Internal error, node '/spl-test' name mismatch 'i2c@0'",
|
|
str(exc.exception))
|
|
|
|
def test_copy_node(self):
|
|
"""Test copy_node() function"""
|
|
def do_copy_checks(dtb, dst, second1_ph_val, expect_none):
|
|
self.assertEqual(
|
|
['/dest/base', '/dest/first@0', '/dest/existing'],
|
|
[n.path for n in dst.subnodes])
|
|
|
|
chk = dtb.GetNode('/dest/base')
|
|
self.assertTrue(chk)
|
|
self.assertEqual(
|
|
{'compatible', 'bootph-all', '#address-cells', '#size-cells'},
|
|
chk.props.keys())
|
|
|
|
# Check the first property
|
|
prop = chk.props['bootph-all']
|
|
self.assertEqual('bootph-all', prop.name)
|
|
self.assertEqual(True, prop.value)
|
|
self.assertEqual(chk.path, prop._node.path)
|
|
|
|
# Check the second property
|
|
prop2 = chk.props['compatible']
|
|
self.assertEqual('compatible', prop2.name)
|
|
self.assertEqual('sandbox,i2c', prop2.value)
|
|
self.assertEqual(chk.path, prop2._node.path)
|
|
|
|
base = chk.FindNode('base')
|
|
self.assertTrue(chk)
|
|
|
|
first = dtb.GetNode('/dest/base/first@0')
|
|
self.assertTrue(first)
|
|
over = dtb.GetNode('/dest/base/over')
|
|
self.assertTrue(over)
|
|
|
|
# Make sure that the phandle for 'over' is copied
|
|
self.assertIn('phandle', over.props.keys())
|
|
|
|
second = dtb.GetNode('/dest/base/second')
|
|
self.assertTrue(second)
|
|
self.assertEqual([over.name, first.name, second.name],
|
|
[n.name for n in chk.subnodes])
|
|
self.assertEqual(chk, over.parent)
|
|
self.assertEqual(
|
|
{'bootph-all', 'compatible', 'reg', 'low-power', 'phandle'},
|
|
over.props.keys())
|
|
|
|
if expect_none:
|
|
self.assertIsNone(prop._offset)
|
|
self.assertIsNone(prop2._offset)
|
|
self.assertIsNone(over._offset)
|
|
else:
|
|
self.assertTrue(prop._offset)
|
|
self.assertTrue(prop2._offset)
|
|
self.assertTrue(over._offset)
|
|
|
|
# Now check ordering of the subnodes
|
|
self.assertEqual(
|
|
['second1', 'second2', 'second3', 'second4'],
|
|
[n.name for n in second.subnodes])
|
|
|
|
# Check the 'second_1_bad' phandle is not copied over
|
|
second1 = second.FindNode('second1')
|
|
self.assertTrue(second1)
|
|
sph = second1.props.get('phandle')
|
|
self.assertTrue(sph)
|
|
self.assertEqual(second1_ph_val, sph.bytes)
|
|
|
|
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_copy.dts'))
|
|
tmpl = dtb.GetNode('/base')
|
|
dst = dtb.GetNode('/dest')
|
|
second1_ph_val = (dtb.GetNode('/dest/base/second/second1').
|
|
props['phandle'].bytes)
|
|
dst.copy_node(tmpl)
|
|
|
|
do_copy_checks(dtb, dst, second1_ph_val, expect_none=True)
|
|
|
|
dtb.Sync(auto_resize=True)
|
|
|
|
# Now check the resulting FDT. It should have duplicate phandles since
|
|
# 'over' has been copied to 'dest/base/over' but still exists in its old
|
|
# place
|
|
new_dtb = fdt.Fdt.FromData(dtb.GetContents())
|
|
with self.assertRaises(ValueError) as exc:
|
|
new_dtb.Scan()
|
|
self.assertIn(
|
|
'Duplicate phandle 1 in nodes /dest/base/over and /base/over',
|
|
str(exc.exception))
|
|
|
|
# Remove the source nodes for the copy
|
|
new_dtb.GetNode('/base').Delete()
|
|
|
|
# Now it should scan OK
|
|
new_dtb.Scan()
|
|
|
|
dst = new_dtb.GetNode('/dest')
|
|
do_copy_checks(new_dtb, dst, second1_ph_val, expect_none=False)
|
|
|
|
def test_copy_subnodes_from_phandles(self):
|
|
"""Test copy_node() function"""
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_copy.dts'))
|
|
|
|
orig = dtb.GetNode('/')
|
|
node_list = fdt_util.GetPhandleList(orig, 'copy-list')
|
|
|
|
dst = dtb.GetNode('/dest')
|
|
dst.copy_subnodes_from_phandles(node_list)
|
|
|
|
pmic = dtb.GetNode('/dest/over')
|
|
self.assertTrue(pmic)
|
|
|
|
subn = dtb.GetNode('/dest/first@0')
|
|
self.assertTrue(subn)
|
|
self.assertEqual({'a-prop', 'b-prop', 'reg'}, subn.props.keys())
|
|
|
|
self.assertEqual(
|
|
['/dest/earlier', '/dest/later', '/dest/over', '/dest/first@0',
|
|
'/dest/second', '/dest/existing', '/dest/base'],
|
|
[n.path for n in dst.subnodes])
|
|
|
|
# Make sure that the phandle for 'over' is not copied
|
|
over = dst.FindNode('over')
|
|
tout.debug(f'keys: {over.props.keys()}')
|
|
self.assertNotIn('phandle', over.props.keys())
|
|
|
|
# Check the merged properties, first the base ones in '/dest'
|
|
expect = {'bootph-all', 'compatible', 'stringarray', 'longbytearray',
|
|
'maybe-empty-int'}
|
|
|
|
# Properties from 'base'
|
|
expect.update({'#address-cells', '#size-cells'})
|
|
|
|
# Properties from 'another'
|
|
expect.add('new-prop')
|
|
|
|
self.assertEqual(expect, set(dst.props.keys()))
|
|
|
|
|
|
class TestProp(unittest.TestCase):
|
|
"""Test operation of the Prop class"""
|
|
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
tools.prepare_output_dir(None)
|
|
|
|
@classmethod
|
|
def tearDownClass(cls):
|
|
tools.finalise_output_dir()
|
|
|
|
def setUp(self):
|
|
self.dtb = fdt.FdtScan(find_dtb_file('dtoc_test_simple.dts'))
|
|
self.node = self.dtb.GetNode('/spl-test')
|
|
self.fdt = self.dtb.GetFdtObj()
|
|
|
|
def test_missing_node(self):
|
|
"""Test GetNode() when the node is missing"""
|
|
self.assertEqual(None, self.dtb.GetNode('missing'))
|
|
|
|
def test_phandle(self):
|
|
"""Test GetNode() on a phandle"""
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_phandle.dts'))
|
|
node = dtb.GetNode('/phandle-source2')
|
|
prop = node.props['clocks']
|
|
self.assertTrue(fdt32_to_cpu(prop.value) > 0)
|
|
|
|
def _convert_prop(self, prop_name):
|
|
"""Helper function to look up a property in self.node and return it
|
|
|
|
Args:
|
|
str: Property name to find
|
|
|
|
Returns:
|
|
fdt.Prop: object for this property
|
|
"""
|
|
prop = self.fdt.getprop(self.node.Offset(), prop_name)
|
|
return fdt.Prop(self.node, -1, prop_name, prop)
|
|
|
|
def test_make_prop(self):
|
|
"""Test we can convert all the the types that are supported"""
|
|
prop = self._convert_prop('boolval')
|
|
self.assertEqual(Type.BOOL, prop.type)
|
|
self.assertEqual(True, prop.value)
|
|
|
|
prop = self._convert_prop('intval')
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertEqual(1, fdt32_to_cpu(prop.value))
|
|
|
|
prop = self._convert_prop('int64val')
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertEqual(0x123456789abcdef0, fdt64_to_cpu(prop.value))
|
|
|
|
prop = self._convert_prop('intarray')
|
|
self.assertEqual(Type.INT, prop.type)
|
|
val = [fdt32_to_cpu(val) for val in prop.value]
|
|
self.assertEqual([2, 3, 4], val)
|
|
|
|
prop = self._convert_prop('byteval')
|
|
self.assertEqual(Type.BYTE, prop.type)
|
|
self.assertEqual(5, ord(prop.value))
|
|
|
|
prop = self._convert_prop('longbytearray')
|
|
self.assertEqual(Type.BYTE, prop.type)
|
|
val = [ord(val) for val in prop.value]
|
|
self.assertEqual([9, 10, 11, 12, 13, 14, 15, 16, 17], val)
|
|
|
|
prop = self._convert_prop('stringval')
|
|
self.assertEqual(Type.STRING, prop.type)
|
|
self.assertEqual('message', prop.value)
|
|
|
|
prop = self._convert_prop('stringarray')
|
|
self.assertEqual(Type.STRING, prop.type)
|
|
self.assertEqual(['multi-word', 'message'], prop.value)
|
|
|
|
prop = self._convert_prop('notstring')
|
|
self.assertEqual(Type.BYTE, prop.type)
|
|
val = [ord(val) for val in prop.value]
|
|
self.assertEqual([0x20, 0x21, 0x22, 0x10, 0], val)
|
|
|
|
def test_get_empty(self):
|
|
"""Tests the GetEmpty() function for the various supported types"""
|
|
self.assertEqual(True, fdt.Prop.GetEmpty(Type.BOOL))
|
|
self.assertEqual(chr(0), fdt.Prop.GetEmpty(Type.BYTE))
|
|
self.assertEqual(tools.get_bytes(0, 4), fdt.Prop.GetEmpty(Type.INT))
|
|
self.assertEqual('', fdt.Prop.GetEmpty(Type.STRING))
|
|
|
|
def test_get_offset(self):
|
|
"""Test we can get the offset of a property"""
|
|
prop, value = _get_property_value(self.dtb, self.node, 'longbytearray')
|
|
self.assertEqual(prop.value, value)
|
|
|
|
def test_widen(self):
|
|
"""Test widening of values"""
|
|
node2 = self.dtb.GetNode('/spl-test2')
|
|
node3 = self.dtb.GetNode('/spl-test3')
|
|
prop = self.node.props['intval']
|
|
|
|
# No action
|
|
prop2 = node2.props['intval']
|
|
prop.Widen(prop2)
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertEqual(1, fdt32_to_cpu(prop.value))
|
|
|
|
# Convert single value to array
|
|
prop2 = self.node.props['intarray']
|
|
prop.Widen(prop2)
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertTrue(isinstance(prop.value, list))
|
|
|
|
# A 4-byte array looks like a single integer. When widened by a longer
|
|
# byte array, it should turn into an array.
|
|
prop = self.node.props['longbytearray']
|
|
prop2 = node2.props['longbytearray']
|
|
prop3 = node3.props['longbytearray']
|
|
self.assertFalse(isinstance(prop2.value, list))
|
|
self.assertEqual(4, len(prop2.value))
|
|
self.assertEqual(b'\x09\x0a\x0b\x0c', prop2.value)
|
|
prop2.Widen(prop)
|
|
self.assertTrue(isinstance(prop2.value, list))
|
|
self.assertEqual(9, len(prop2.value))
|
|
self.assertEqual(['\x09', '\x0a', '\x0b', '\x0c', '\0',
|
|
'\0', '\0', '\0', '\0'], prop2.value)
|
|
prop3.Widen(prop)
|
|
self.assertTrue(isinstance(prop3.value, list))
|
|
self.assertEqual(9, len(prop3.value))
|
|
self.assertEqual(['\x09', '\x0a', '\x0b', '\x0c', '\x0d',
|
|
'\x0e', '\x0f', '\x10', '\0'], prop3.value)
|
|
|
|
def test_widen_more(self):
|
|
"""More tests of widening values"""
|
|
node2 = self.dtb.GetNode('/spl-test2')
|
|
node3 = self.dtb.GetNode('/spl-test3')
|
|
prop = self.node.props['intval']
|
|
|
|
# Test widening a single string into a string array
|
|
prop = self.node.props['stringval']
|
|
prop2 = node2.props['stringarray']
|
|
self.assertFalse(isinstance(prop.value, list))
|
|
self.assertEqual(7, len(prop.value))
|
|
prop.Widen(prop2)
|
|
self.assertTrue(isinstance(prop.value, list))
|
|
self.assertEqual(3, len(prop.value))
|
|
|
|
# Enlarging an existing array
|
|
prop = self.node.props['stringarray']
|
|
prop2 = node2.props['stringarray']
|
|
self.assertTrue(isinstance(prop.value, list))
|
|
self.assertEqual(2, len(prop.value))
|
|
prop.Widen(prop2)
|
|
self.assertTrue(isinstance(prop.value, list))
|
|
self.assertEqual(3, len(prop.value))
|
|
|
|
# Widen an array of ints with an int (should do nothing)
|
|
prop = self.node.props['intarray']
|
|
prop2 = node2.props['intval']
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertEqual(3, len(prop.value))
|
|
prop.Widen(prop2)
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertEqual(3, len(prop.value))
|
|
|
|
# Widen an empty bool to an int
|
|
prop = self.node.props['maybe-empty-int']
|
|
prop3 = node3.props['maybe-empty-int']
|
|
self.assertEqual(Type.BOOL, prop.type)
|
|
self.assertEqual(True, prop.value)
|
|
self.assertEqual(Type.INT, prop3.type)
|
|
self.assertFalse(isinstance(prop.value, list))
|
|
self.assertEqual(4, len(prop3.value))
|
|
prop.Widen(prop3)
|
|
self.assertEqual(Type.INT, prop.type)
|
|
self.assertTrue(isinstance(prop.value, list))
|
|
self.assertEqual(1, len(prop.value))
|
|
|
|
def test_add(self):
|
|
"""Test adding properties"""
|
|
self.fdt.pack()
|
|
# This function should automatically expand the device tree
|
|
self.node.AddZeroProp('one')
|
|
self.node.AddZeroProp('two')
|
|
self.node.AddZeroProp('three')
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
# Updating existing properties should be OK, since the device-tree size
|
|
# does not change
|
|
self.fdt.pack()
|
|
self.node.SetInt('one', 1)
|
|
self.node.SetInt('two', 2)
|
|
self.node.SetInt('three', 3)
|
|
self.dtb.Sync(auto_resize=False)
|
|
|
|
# This should fail since it would need to increase the device-tree size
|
|
self.node.AddZeroProp('four')
|
|
with self.assertRaises(libfdt.FdtException) as exc:
|
|
self.dtb.Sync(auto_resize=False)
|
|
self.assertIn('FDT_ERR_NOSPACE', str(exc.exception))
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
def test_add_more(self):
|
|
"""Test various other methods for adding and setting properties"""
|
|
self.node.AddZeroProp('one')
|
|
self.dtb.Sync(auto_resize=True)
|
|
data = self.fdt.getprop(self.node.Offset(), 'one')
|
|
self.assertEqual(0, fdt32_to_cpu(data))
|
|
|
|
self.node.SetInt('one', 1)
|
|
self.dtb.Sync(auto_resize=False)
|
|
data = self.fdt.getprop(self.node.Offset(), 'one')
|
|
self.assertEqual(1, fdt32_to_cpu(data))
|
|
|
|
val = 1234
|
|
self.node.AddInt('integer', val)
|
|
self.dtb.Sync(auto_resize=True)
|
|
data = self.fdt.getprop(self.node.Offset(), 'integer')
|
|
self.assertEqual(val, fdt32_to_cpu(data))
|
|
|
|
val = '123' + chr(0) + '456'
|
|
self.node.AddString('string', val)
|
|
self.dtb.Sync(auto_resize=True)
|
|
data = self.fdt.getprop(self.node.Offset(), 'string')
|
|
self.assertEqual(tools.to_bytes(val) + b'\0', data)
|
|
|
|
self.fdt.pack()
|
|
self.node.SetString('string', val + 'x')
|
|
with self.assertRaises(libfdt.FdtException) as exc:
|
|
self.dtb.Sync(auto_resize=False)
|
|
self.assertIn('FDT_ERR_NOSPACE', str(exc.exception))
|
|
self.node.SetString('string', val[:-1])
|
|
|
|
prop = self.node.props['string']
|
|
prop.SetData(tools.to_bytes(val))
|
|
self.dtb.Sync(auto_resize=False)
|
|
data = self.fdt.getprop(self.node.Offset(), 'string')
|
|
self.assertEqual(tools.to_bytes(val), data)
|
|
|
|
self.node.AddEmptyProp('empty', 5)
|
|
self.dtb.Sync(auto_resize=True)
|
|
prop = self.node.props['empty']
|
|
prop.SetData(tools.to_bytes(val))
|
|
self.dtb.Sync(auto_resize=False)
|
|
data = self.fdt.getprop(self.node.Offset(), 'empty')
|
|
self.assertEqual(tools.to_bytes(val), data)
|
|
|
|
self.node.SetData('empty', b'123')
|
|
self.assertEqual(b'123', prop.bytes)
|
|
|
|
# Trying adding a lot of data at once
|
|
self.node.AddData('data', tools.get_bytes(65, 20000))
|
|
self.dtb.Sync(auto_resize=True)
|
|
|
|
def test_string_list(self):
|
|
"""Test adding string-list property to a node"""
|
|
val = ['123', '456']
|
|
self.node.AddStringList('stringlist', val)
|
|
self.dtb.Sync(auto_resize=True)
|
|
data = self.fdt.getprop(self.node.Offset(), 'stringlist')
|
|
self.assertEqual(b'123\x00456\0', data)
|
|
|
|
val = []
|
|
self.node.AddStringList('stringlist', val)
|
|
self.dtb.Sync(auto_resize=True)
|
|
data = self.fdt.getprop(self.node.Offset(), 'stringlist')
|
|
self.assertEqual(b'', data)
|
|
|
|
def test_delete_node(self):
|
|
"""Test deleting a node"""
|
|
old_offset = self.fdt.path_offset('/spl-test')
|
|
self.assertGreater(old_offset, 0)
|
|
self.node.Delete()
|
|
self.dtb.Sync()
|
|
new_offset = self.fdt.path_offset('/spl-test', libfdt.QUIET_NOTFOUND)
|
|
self.assertEqual(-libfdt.NOTFOUND, new_offset)
|
|
|
|
def test_from_data(self):
|
|
"""Test creating an FDT from data"""
|
|
dtb2 = fdt.Fdt.FromData(self.dtb.GetContents())
|
|
self.assertEqual(dtb2.GetContents(), self.dtb.GetContents())
|
|
|
|
self.node.AddEmptyProp('empty', 5)
|
|
self.dtb.Sync(auto_resize=True)
|
|
self.assertTrue(dtb2.GetContents() != self.dtb.GetContents())
|
|
|
|
def test_missing_set_int(self):
|
|
"""Test handling of a missing property with SetInt"""
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.node.SetInt('one', 1)
|
|
self.assertIn("node '/spl-test': Missing property 'one'",
|
|
str(exc.exception))
|
|
|
|
def test_missing_set_data(self):
|
|
"""Test handling of a missing property with SetData"""
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.node.SetData('one', b'data')
|
|
self.assertIn("node '/spl-test': Missing property 'one'",
|
|
str(exc.exception))
|
|
|
|
def test_missing_set_string(self):
|
|
"""Test handling of a missing property with SetString"""
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.node.SetString('one', 1)
|
|
self.assertIn("node '/spl-test': Missing property 'one'",
|
|
str(exc.exception))
|
|
|
|
def test_get_filename(self):
|
|
"""Test the dtb filename can be provided"""
|
|
self.assertEqual(tools.get_output_filename('source.dtb'),
|
|
self.dtb.GetFilename())
|
|
|
|
|
|
class TestFdtUtil(unittest.TestCase):
|
|
"""Tests for the fdt_util module
|
|
|
|
This module will likely be mostly replaced at some point, once upstream
|
|
libfdt has better Python support. For now, this provides tests for current
|
|
functionality.
|
|
"""
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
tools.prepare_output_dir(None)
|
|
|
|
@classmethod
|
|
def tearDownClass(cls):
|
|
tools.finalise_output_dir()
|
|
|
|
def setUp(self):
|
|
self.dtb = fdt.FdtScan(find_dtb_file('dtoc_test_simple.dts'))
|
|
self.node = self.dtb.GetNode('/spl-test')
|
|
|
|
def test_get_int(self):
|
|
"""Test getting an int from a node"""
|
|
self.assertEqual(1, fdt_util.GetInt(self.node, 'intval'))
|
|
self.assertEqual(3, fdt_util.GetInt(self.node, 'missing', 3))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetInt(self.node, 'intarray')
|
|
self.assertIn("property 'intarray' has list value: expecting a single "
|
|
'integer', str(exc.exception))
|
|
|
|
def test_get_int64(self):
|
|
"""Test getting a 64-bit int from a node"""
|
|
self.assertEqual(0x123456789abcdef0,
|
|
fdt_util.GetInt64(self.node, 'int64val'))
|
|
self.assertEqual(3, fdt_util.GetInt64(self.node, 'missing', 3))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetInt64(self.node, 'intarray')
|
|
self.assertIn(
|
|
"property 'intarray' should be a list with 2 items for 64-bit values",
|
|
str(exc.exception))
|
|
|
|
def test_get_string(self):
|
|
"""Test getting a string from a node"""
|
|
self.assertEqual('message', fdt_util.GetString(self.node, 'stringval'))
|
|
self.assertEqual('test', fdt_util.GetString(self.node, 'missing',
|
|
'test'))
|
|
self.assertEqual('', fdt_util.GetString(self.node, 'boolval'))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
self.assertEqual(3, fdt_util.GetString(self.node, 'stringarray'))
|
|
self.assertIn("property 'stringarray' has list value: expecting a "
|
|
'single string', str(exc.exception))
|
|
|
|
def test_get_string_list(self):
|
|
"""Test getting a string list from a node"""
|
|
self.assertEqual(['message'],
|
|
fdt_util.GetStringList(self.node, 'stringval'))
|
|
self.assertEqual(
|
|
['multi-word', 'message'],
|
|
fdt_util.GetStringList(self.node, 'stringarray'))
|
|
self.assertEqual(['test'],
|
|
fdt_util.GetStringList(self.node, 'missing', ['test']))
|
|
self.assertEqual([], fdt_util.GetStringList(self.node, 'boolval'))
|
|
|
|
def test_get_args(self):
|
|
"""Test getting arguments from a node"""
|
|
node = self.dtb.GetNode('/orig-node')
|
|
self.assertEqual(['message'], fdt_util.GetArgs(self.node, 'stringval'))
|
|
self.assertEqual(
|
|
['multi-word', 'message'],
|
|
fdt_util.GetArgs(self.node, 'stringarray'))
|
|
self.assertEqual([], fdt_util.GetArgs(self.node, 'boolval'))
|
|
self.assertEqual(['-n first', 'second', '-p', '123,456', '-x'],
|
|
fdt_util.GetArgs(node, 'args'))
|
|
self.assertEqual(['a space', 'there'],
|
|
fdt_util.GetArgs(node, 'args2'))
|
|
self.assertEqual(['-n', 'first', 'second', '-p', '123,456', '-x'],
|
|
fdt_util.GetArgs(node, 'args3'))
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetArgs(self.node, 'missing')
|
|
self.assertIn(
|
|
"Node '/spl-test': Expected property 'missing'",
|
|
str(exc.exception))
|
|
|
|
def test_get_bool(self):
|
|
"""Test getting a bool from a node"""
|
|
self.assertEqual(True, fdt_util.GetBool(self.node, 'boolval'))
|
|
self.assertEqual(False, fdt_util.GetBool(self.node, 'missing'))
|
|
self.assertEqual(True, fdt_util.GetBool(self.node, 'missing', True))
|
|
self.assertEqual(False, fdt_util.GetBool(self.node, 'missing', False))
|
|
|
|
def test_get_byte(self):
|
|
"""Test getting a byte from a node"""
|
|
self.assertEqual(5, fdt_util.GetByte(self.node, 'byteval'))
|
|
self.assertEqual(3, fdt_util.GetByte(self.node, 'missing', 3))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetByte(self.node, 'longbytearray')
|
|
self.assertIn("property 'longbytearray' has list value: expecting a "
|
|
'single byte', str(exc.exception))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetByte(self.node, 'intval')
|
|
self.assertIn("property 'intval' has length 4, expecting 1",
|
|
str(exc.exception))
|
|
|
|
def test_get_bytes(self):
|
|
"""Test getting multiple bytes from a node"""
|
|
self.assertEqual(bytes([5]), fdt_util.GetBytes(self.node, 'byteval', 1))
|
|
self.assertEqual(None, fdt_util.GetBytes(self.node, 'missing', 3))
|
|
self.assertEqual(
|
|
bytes([3]), fdt_util.GetBytes(self.node, 'missing', 3, bytes([3])))
|
|
|
|
with self.assertRaises(ValueError) as exc:
|
|
fdt_util.GetBytes(self.node, 'longbytearray', 7)
|
|
self.assertIn(
|
|
"Node 'spl-test' property 'longbytearray' has length 9, expecting 7",
|
|
str(exc.exception))
|
|
|
|
self.assertEqual(
|
|
bytes([0, 0, 0, 1]), fdt_util.GetBytes(self.node, 'intval', 4))
|
|
self.assertEqual(
|
|
bytes([3]), fdt_util.GetBytes(self.node, 'missing', 3, bytes([3])))
|
|
|
|
def test_get_phandle_list(self):
|
|
"""Test getting a list of phandles from a node"""
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_phandle.dts'))
|
|
node = dtb.GetNode('/phandle-source2')
|
|
self.assertEqual([1], fdt_util.GetPhandleList(node, 'clocks'))
|
|
node = dtb.GetNode('/phandle-source')
|
|
self.assertEqual([1, 2, 11, 3, 12, 13, 1],
|
|
fdt_util.GetPhandleList(node, 'clocks'))
|
|
self.assertEqual(None, fdt_util.GetPhandleList(node, 'missing'))
|
|
|
|
def test_get_data_type(self):
|
|
"""Test getting a value of a particular type from a node"""
|
|
self.assertEqual(1, fdt_util.GetDatatype(self.node, 'intval', int))
|
|
self.assertEqual('message', fdt_util.GetDatatype(self.node, 'stringval',
|
|
str))
|
|
with self.assertRaises(ValueError):
|
|
self.assertEqual(3, fdt_util.GetDatatype(self.node, 'boolval',
|
|
bool))
|
|
def test_fdt_cells_to_cpu(self):
|
|
"""Test getting cells with the correct endianness"""
|
|
val = self.node.props['intarray'].value
|
|
self.assertEqual(0, fdt_util.fdt_cells_to_cpu(val, 0))
|
|
self.assertEqual(2, fdt_util.fdt_cells_to_cpu(val, 1))
|
|
|
|
dtb2 = fdt.FdtScan(find_dtb_file('dtoc_test_addr64.dts'))
|
|
node1 = dtb2.GetNode('/test1')
|
|
val = node1.props['reg'].value
|
|
self.assertEqual(0x1234, fdt_util.fdt_cells_to_cpu(val, 2))
|
|
|
|
node2 = dtb2.GetNode('/test2')
|
|
val = node2.props['reg'].value
|
|
self.assertEqual(0x1234567890123456, fdt_util.fdt_cells_to_cpu(val, 2))
|
|
self.assertEqual(0x9876543210987654, fdt_util.fdt_cells_to_cpu(val[2:],
|
|
2))
|
|
self.assertEqual(0x12345678, fdt_util.fdt_cells_to_cpu(val, 1))
|
|
|
|
def test_ensure_compiled(self):
|
|
"""Test a degenerate case of this function (file already compiled)"""
|
|
dtb = fdt_util.EnsureCompiled(find_dtb_file('dtoc_test_simple.dts'))
|
|
self.assertEqual(dtb, fdt_util.EnsureCompiled(dtb))
|
|
|
|
def test_ensure_compiled_tmpdir(self):
|
|
"""Test providing a temporary directory"""
|
|
old_outdir = tools.outdir
|
|
try:
|
|
tools.outdir= None
|
|
tmpdir = tempfile.mkdtemp(prefix='test_fdt.')
|
|
dtb = fdt_util.EnsureCompiled(find_dtb_file('dtoc_test_simple.dts'),
|
|
tmpdir)
|
|
self.assertEqual(tmpdir, os.path.dirname(dtb))
|
|
shutil.rmtree(tmpdir)
|
|
finally:
|
|
tools.outdir = old_outdir
|
|
|
|
def test_get_phandle_name_offset(self):
|
|
val = fdt_util.GetPhandleNameOffset(self.node, 'missing')
|
|
self.assertIsNone(val)
|
|
|
|
dtb = fdt.FdtScan(find_dtb_file('dtoc_test_phandle.dts'))
|
|
node = dtb.GetNode('/phandle-source')
|
|
node, name, offset = fdt_util.GetPhandleNameOffset(node,
|
|
'phandle-name-offset')
|
|
self.assertEqual('phandle3-target', node.name)
|
|
self.assertEqual('fred', name)
|
|
self.assertEqual(123, offset)
|
|
|
|
def run_test_coverage(build_dir):
|
|
"""Run the tests and check that we get 100% coverage
|
|
|
|
Args:
|
|
build_dir (str): Directory containing the build output
|
|
"""
|
|
test_util.run_test_coverage('tools/dtoc/test_fdt.py', None,
|
|
['tools/patman/*.py', 'tools/u_boot_pylib/*', '*test_fdt.py'],
|
|
build_dir)
|
|
|
|
|
|
def run_tests(names, processes):
|
|
"""Run all the test we have for the fdt model
|
|
|
|
Args:
|
|
names (list of str): List of test names provided. Only the first is used
|
|
processes (int): Number of processes to use (None means as many as there
|
|
are CPUs on the system. This must be set to 1 when running under
|
|
the python3-coverage tool
|
|
|
|
Returns:
|
|
int: Return code, 0 on success
|
|
"""
|
|
test_name = names[0] if names else None
|
|
result = test_util.run_test_suites(
|
|
'test_fdt', False, False, False, processes, test_name, None,
|
|
[TestFdt, TestNode, TestProp, TestFdtUtil])
|
|
|
|
return (0 if result.wasSuccessful() else 1)
|
|
|
|
|
|
def main():
|
|
"""Main program for this tool"""
|
|
parser = ArgumentParser()
|
|
parser.add_argument('-B', '--build-dir', type=str, default='b',
|
|
help='Directory containing the build output')
|
|
parser.add_argument('-P', '--processes', type=int,
|
|
help='set number of processes to use for running tests')
|
|
parser.add_argument('-t', '--test', action='store_true', dest='test',
|
|
default=False, help='run tests')
|
|
parser.add_argument('-T', '--test-coverage', action='store_true',
|
|
default=False,
|
|
help='run tests and check for 100% coverage')
|
|
parser.add_argument('name', nargs='*')
|
|
args = parser.parse_args()
|
|
|
|
# Run our meagre tests
|
|
if args.test:
|
|
ret_code = run_tests(args.name, args.processes)
|
|
return ret_code
|
|
if args.test_coverage:
|
|
run_test_coverage(args.build_dir)
|
|
return 0
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main())
|