#1304 P25 Phase 1/2 decoder enhancements. (#1898)

* P25 Phase 2 now supports control channel decoding and decoder was enhanced to improve decodes.
* Radio reference site editor updated for phase 2 sites to allow user to select FDMA or TDMA control.
* Decode events are now minimized and de-duplicated.
* Fully parsing all phase 1/2 messages from the latest ICD.
* Vendor specific messaging recoveries (Moto & Harris).
* Patch group management enhancements with stale patch detection.
* Tuner editor now fully resets the min/max frequency values
* Default traffic channel count increased to 20 (from 3).
* ISSI roaming radio and talkgroup values now displayed and aliasable as fully qualified values (e.g. 1234(123.456.7890)
* Moto emergency alarm activation messaging support
* Expanded list of P25 encryption algorithms
* Message (bits) viewer enhanced for P25 phase 1 and phase 2
* IPV4 addresses and UDP ports no longer classified as user values - won't display in event views.
* New framework for describing message binary fields that should reduce overall memory footprint and enhance code readability

Co-authored-by: Dennis Sheirer <dsheirer@github.com>

src/main/java/io/github/dsheirer/bits/LongField.java

@@ -0,0 +1,122 @@
+/*
+ * *****************************************************************************
+ * Copyright (C) 2014-2024 Dennis Sheirer
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>
+ * ****************************************************************************
+ */
+
+package io.github.dsheirer.bits;
+
+/**
+ * Defines a contiguous bit field within a binary message.
+ * @param start bit index, inclusive.
+ * @param end bit index, inclusive.
+ */
+public record LongField(int start, int end)
+{
+    public LongField
+    {
+        if(end - start > 64)
+        {
+            throw new IllegalArgumentException("Long field length [" + (end - start) + "] cannot exceed 64-bits for a long");
+        }
+
+        if(end < start)
+        {
+            throw new IllegalArgumentException("Long field start index must be less than end index");
+        }
+    }
+
+    /**
+     * Utility constructor method.
+     * @param start index (inclusive)
+     * @param end index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField range(int start, int end)
+    {
+        return new LongField(start, end);
+    }
+
+    /**
+     * Utility constructor method for a field with one four bits of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length4(int start)
+    {
+        return new LongField(start, (start + 3));
+    }
+
+    /**
+     * Utility constructor method for a field with one octet of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length8(int start)
+    {
+        return new LongField(start, (start + 7));
+    }
+
+    /**
+     * Utility constructor method for a field with 12 bits of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length12(int start)
+    {
+        return new LongField(start, (start + 11));
+    }
+
+    /**
+     * Utility constructor method for a field with two octets of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length16(int start)
+    {
+        return new LongField(start, (start + 15));
+    }
+
+    /**
+     * Utility constructor method for a field with 20 bits of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length20(int start)
+    {
+        return new LongField(start, (start + 19));
+    }
+
+    /**
+     * Utility constructor method for a field with two octets of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length24(int start)
+    {
+        return new LongField(start, (start + 23));
+    }
+
+    /**
+     * Utility constructor method for a field with three octets of length.
+     * @param start index (inclusive)
+     * @return constructed bit field.
+     */
+    public static LongField length32(int start)
+    {
+        return new LongField(start, (start + 31));
+    }
+}