hisi-rf-link 0.1.0-alpha.26

Host-side linker, archive normalization, and ABI inventory for HiSilicon radio blobs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# dependencies = []
# ///
"""Regression tests for the bundled HiSilicon relocation tools."""

import runpy
import unittest
from pathlib import Path


PATCHER = runpy.run_path(str(Path(__file__).with_name("patch-reloc.py")))
encode_branchi = PATCHER["encode_branchi"]
VERIFIER = runpy.run_path(str(Path(__file__).with_name("verify-layout.py")))
find_self_call_offsets = VERIFIER["find_self_call_offsets"]


class BranchiEncodingTests(unittest.TestCase):
    def test_forward_offsets_match_vendor_linker(self) -> None:
        base = 0x1105_003B
        self.assertEqual(encode_branchi(base, 0x004), 0x1105_013B)
        self.assertEqual(encode_branchi(base, 0x020), 0x1105_083B)
        self.assertEqual(encode_branchi(base, 0x086), 0x1125_01BB)
        self.assertEqual(encode_branchi(base, 0x094), 0x1125_053B)

    def test_backward_offset_matches_vendor_linker(self) -> None:
        self.assertEqual(encode_branchi(0x1705_103B, -0x16), 0x17F5_1ABB)

    def test_rejects_invalid_offsets(self) -> None:
        with self.assertRaises(ValueError):
            encode_branchi(0, 3)
        with self.assertRaises(ValueError):
            encode_branchi(0, 0x200)


class SelfCallPlaceholderTests(unittest.TestCase):
    def test_detects_unresolved_weak_call(self) -> None:
        placeholder = b"\x97\x00\x00\x00\xe7\x80\x00\x00"
        self.assertEqual(find_self_call_offsets(b"abc" + placeholder + b"xyz"), [3])

    def test_ignores_normal_call(self) -> None:
        self.assertEqual(find_self_call_offsets(b"\x97\x00\x00\x00\xe7\x80\x40\x00"), [])


if __name__ == "__main__":
    unittest.main()