Refactored TDF processing PHP code to confirm to new TDF format

2024-02-09 23:30:47 +00:00
parent 09a5be91fd
commit c563443737
58 changed files with 1877 additions and 1762 deletions
--- a/build/scripts/Targets/TargetDescriptionFiles/RegisterGroup.php
+++ b/build/scripts/Targets/TargetDescriptionFiles/RegisterGroup.php
@@ -0,0 +1,76 @@
+<?php
+namespace Targets\TargetDescriptionFiles;
+
+require_once __DIR__ . "/Register.php";
+require_once __DIR__ . "/RegisterGroupReference.php";
+
+class RegisterGroup
+{
+    public ?string $key = null;
+    public ?string $name = null;
+    public ?int $offset = null;
+
+    /** @var Register[] */
+    public array $registersMappedByName = [];
+
+    /** @var Register[] */
+    public array $registers = [];
+
+    /** @var RegisterGroup[] */
+    public array $subGroups = [];
+
+    /** @var RegisterGroupReference[] */
+    public array $subGroupReferences = [];
+
+    public function __construct(
+        ?string $key,
+        ?string $name,
+        ?int $offset,
+        array $registers,
+        array $subGroups,
+        array $subGroupReferences
+    ) {
+        $this->key = $key;
+        $this->name = $name;
+        $this->offset = $offset;
+        $this->registers = $registers;
+        $this->subGroups = $subGroups;
+        $this->subGroupReferences = $subGroupReferences;
+    }
+
+    public function getRegister(array|string $keys): ?Register
+    {
+        if (is_string($keys)) {
+            $keys = explode('.', $keys);
+        }
+
+        $registerKey = array_pop($keys);
+        $group = !empty($keys) > 1 ? $this->getSubGroup($keys) : $this;
+
+        if ($group instanceof RegisterGroup) {
+            foreach ($group->registers as $register) {
+                if ($register->key === $registerKey) {
+                    return $register;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    public function getSubGroup(array|string $subGroupKeys): ?RegisterGroup
+    {
+        if (is_string($subGroupKeys)) {
+            $subGroupKeys = explode('.', $subGroupKeys);
+        }
+
+        $firstLevelSubGroupKey = array_shift($subGroupKeys);
+        foreach ($this->subGroups as $subGroup) {
+            if ($subGroup->key === $firstLevelSubGroupKey) {
+                return !empty($subGroupKeys) ? $subGroup->getSubGroup($subGroupKeys) : $subGroup;
+            }
+        }
+
+        return null;
+    }
+}