| blob | f40f1d70ba5bea5ab56ba460388e3768f36306ec |
1 /* packet-oran.c
2 * Routines for O-RAN fronthaul UC-plane dissection
3 * Copyright 2020, Jan Schiefer, Keysight Technologies, Inc.
4 *
5 * Wireshark - Network traffic analyzer
6 * By Gerald Combs <gerald@wireshark.org>
7 * Copyright 1998 Gerald Combs
8 *
9 * SPDX-License-Identifier: GPL-2.0-or-later
10 */
12 /*
13 * Dissector for the O-RAN Fronthaul CUS protocol specification.
14 * See https://specifications.o-ran.org/specifications, WG4, Fronthaul Interfaces Workgroup
15 * The current implementation is based on the ORAN-WG4.CUS.0-v16.01 specification
16 */
18 #include <config.h>
20 #include <math.h>
22 #include <epan/packet.h>
23 #include <epan/expert.h>
24 #include <epan/prefs.h>
25 #include <epan/tap.h>
27 #include <epan/tfs.h>
28 #include <wsutil/array.h>
32 /* N.B. dissector preferences are taking the place of (some) M-plane parameters, so unfortunately it can be
33 * fiddly to get the preferences into a good state to decode a given capture..
34 * TODO:
35 * - for U-Plane, track back to last C-Plane frame for that eAxC
36 * - use upCompHdr values from C-Plane if not overridden by U-Plane?
37 * N.B. this matching is tricky see 7.8.1 Coupling of C-Plane and U-Plane
38 * - Radio transport layer (eCPRI) fragmentation / reassembly
39 * - Detect/indicate signs of application layer fragmentation?
40 * - Not handling M-plane setting for "little endian byte order" as applied to IQ samples and beam weights
41 * - for section extensions, check more constraints (which other extension types appear with them, order)
42 * - when some section extensions are present, some section header fields are effectively ignored - flag any remaining ("ignored, "shall")?
43 * - re-order items (decl and hf definitions) to match spec order?
44 */
46 /* Prototypes */
50 /* Initialize the protocol and registered fields */
400 /* Computed fields */
404 /* Hidden fields for filtering */
410 /* Initialize the subtree pointers */
448 /* Don't want all extensions to open and close together. Use extType-1 entry */
451 /* Expert info */
494 /* These are the message types handled by this dissector */
495 #define ECPRI_MT_IQ_DATA 0
496 #define ECPRI_MT_RT_CTRL_DATA 2
499 /* Preference settings - try to set reasonable defaults */
505 /* TODO: ideally should be per-flow */
509 /* 8.3.3.15 Compression schemes */
510 #define COMP_NONE 0
511 #define COMP_BLOCK_FP 1
512 #define COMP_BLOCK_SCALE 2
513 #define COMP_U_LAW 3
514 #define COMP_MODULATION 4
515 #define BFP_AND_SELECTIVE_RE 5
516 #define MOD_COMPR_AND_SELECTIVE_RE 6
517 #define BFP_AND_SELECTIVE_RE_WITH_MASKS 7
518 #define MOD_COMPR_AND_SELECTIVE_RE_WITH_MASKS 8
520 /* TODO: these ideally should be per-flow too */
524 /* Is udCompHeader present (both directions) */
533 /* Based upon m-plane param, so will be system-wide */
534 static int pref_support_udcompLen = 2; /* start heuristic, can force other settings if necessary */
545 { "BFP_AND_SELECTIVE_RE", "Block Floating Point + selective RE sending", BFP_AND_SELECTIVE_RE },
546 { "MOD_COMPR_AND_SELECTIVE_RE", "Modulation Compression + selective RE sending", MOD_COMPR_AND_SELECTIVE_RE },
547 { "BFP_AND_SELECTIVE_RE_WITH_MASKS", "Block Floating Point + selective RE sending with masks in section header", BFP_AND_SELECTIVE_RE_WITH_MASKS },
548 { "MOD_COMPR_AND_SELECTIVE_RE_WITH_MASKS", "Modulation Compression + selective RE sending with masks in section header", MOD_COMPR_AND_SELECTIVE_RE },
550 };
557 { "BFP_AND_SELECTIVE_RE", "Block Floating Point + selective RE sending", BFP_AND_SELECTIVE_RE },
558 { "BFP_AND_SELECTIVE_RE_WITH_MASKS", "Block Floating Point + selective RE sending with masks in section header", BFP_AND_SELECTIVE_RE_WITH_MASKS },
560 };
567 };
574 };
581 };
583 #define DIR_UPLINK 0
584 #define DIR_DOWNLINK 1
591 };
597 };
603 };
611 };
615 {1, 1, "UL filter for PRACH preamble formats 0, 1, 2; min. passband 839 x 1.25kHz = 1048.75 kHz"},
617 {3, 3, "UL filter for PRACH preamble formats A1, A2, A3, B1, B2, B3, B4, C0, C2; min. passband 139 x \u0394fRA"},
624 };
627 { SEC_C_UNUSED_RB, SEC_C_UNUSED_RB, "Unused Resource Blocks or symbols in Downlink or Uplink" },
657 };
664 /* Table 8.3.3.13-3 */
673 {BFP_AND_SELECTIVE_RE_WITH_MASKS, BFP_AND_SELECTIVE_RE_WITH_MASKS, "BFP + selective RE sending with masks in section header" },
674 {MOD_COMPR_AND_SELECTIVE_RE_WITH_MASKS, MOD_COMPR_AND_SELECTIVE_RE_WITH_MASKS, "mod-compr + selective RE sending with masks in section header"},
677 };
679 /* Table 7.5.2.13-2 */
696 };
698 /* Table 7.5.2.13-3 */
711 };
713 /* Table 7.5.3.14-1 laaMsgType definition */
724 };
733 };
745 };
755 };
761 };
764 /* Table 7.6.1-1 */
795 };
797 /**************************************************************************************/
798 /* Keep track for each Section Extension, which section types are allowed to carry it */
811 /* ST0 ST1 ST3 ST5 ST6 ST10 ST11 */
841 };
844 {
846 /* Don't know about new SE, so don't complain.. */
848 }
860 /* New section type that includes 'ef'.. assume ok */
862 }
863 }
865 /************************************************************************************/
885 };
887 /* Table 7.7.1.2-3 */
896 };
898 /* 7.7.6.2 rbgSize (resource block group size) */
909 };
911 /* 7.7.6.5 */
918 };
920 /* 7.7.10.2 beamGroupType */
927 };
929 /* 7.7.9.2 technology (interface name) */
934 };
936 /* 7.7.18.4 toT (type of transmission) */
938 {0x0, "normal transmission mode, data can be distributed in any way the O-RU is implemented to transmit data"},
943 };
945 /* 7.7.2.2 (width of bfa parameters) */
947 {0, "no bits, the field is not applicable (e.g., O-RU does not support it) or the default value shall be used"},
956 };
958 /* 7.7.2.7 & 7.7.2.8 */
969 };
977 };
985 };
991 };
999 };
1001 /* N.B., table in 7.5.3.38 is truncated.. */
1010 };
1012 /* Table 7.5.3.51-1 */
1031 };
1033 /* Table 16.1-1 Sleep modes */
1040 };
1048 };
1050 /* 7.7.21.3.1 */
1057 };
1065 };
1071 };
1077 };
1079 /* 7.7.24.14 */
1084 };
1086 /* 7.7.24.17 */
1093 };
1095 /* 7.7.24.18 */
1102 };
1106 {
1108 "subframe was dropped"
1109 };
1112 {
1114 "reserved"
1115 };
1119 "full SF"
1120 };
1124 "beam numbers included"
1125 };
1129 "discontinuity between current and next bundle"
1130 };
1134 "PRB-MASK mode"
1135 };
1139 "UL symbol"
1140 };
1144 "non-guard symbol"
1145 };
1149 "time-domain beam numbers included in this command"
1150 };
1154 "no additional measurement report or command"
1155 };
1158 /* Forward declaration */
1159 static int dissect_udcompparam(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree, unsigned offset,
1166 "message is a ACK message"
1167 };
1171 "Puncturing pattern applies to current section"
1172 };
1176 "can assume same UE as in preceding slot"
1177 };
1180 /* Config for (and later, worked-out allocations) bundles for ext11 (dynamic BFW) */
1182 /* Ext 6 config */
1188 /* TODO: store an f value for each bit position? */
1190 /* Ext 12 config */
1193 #define MAX_BFW_EXT12_PAIRS 128
1199 /* Ext 13 config */
1202 #define MAX_BFW_EXT13_ALLOCATIONS 128
1204 /* TODO: store nextSymbolId here too? */
1206 /* Ext 21 config */
1210 /* Results/settings (after calling ext11_work_out_bundles()) */
1212 #define MAX_BFW_BUNDLES 512
1221 /* Work out bundle allocation for ext 11. Take into account ext6/ext21, ext12 or ext13 in this section before ext 11. */
1222 /* Won't be called with numBundPrb=0 */
1227 {
1228 /* Allocation configured by ext 6 */
1232 /* Need to cope with these not dividing exactly, or even having more PRbs in a bundle that
1233 rbg size. i.e. each bundle gets the correct number of PRBs until
1234 all rbg entries are consumed... */
1236 /* TODO: need to check 7.9.4.2. Different cases depending upon value of RAD */
1240 }
1242 /* Maybe also be affected by ext 21 */
1244 /* N.B., have already checked that numPrbc is not 0 */
1246 /* ciPrbGroupSize overrides number of contiguous PRBs in group */
1249 /* numPrbc is the number of PRB groups per antenna - handled in call to dissect_bfw_bundle() */
1250 }
1255 n++) {
1257 /* Watch out for array bound */
1260 }
1262 /* For each bundle... */
1264 /* TODO: Work out where first PRB is */
1265 /* May not be the start of an rbg block... */
1268 /* For each bundle within identified rbgSize block */
1271 /* Start already beyond end, so doesn't count. */
1274 }
1275 /* Bundle consists of numBundPrb bundles */
1276 /* TODO: may involve PRBs from >1 rbg blocks.. */
1279 /* Extends beyond end, so counts but is an orphan bundle */
1282 }
1284 /* Get out if have reached array bound */
1287 }
1288 }
1289 }
1291 }
1293 /* Allocation configured by ext 12 */
1295 /* First, allocate normally from startPrbc, numPrbc */
1298 /* Don't overflow settings->bundles[] ! */
1304 /* Does it go beyond the end? */
1308 }
1309 }
1312 }
1316 /* Loop over pairs, adding bundles for each */
1326 /* Does it go beyond the end? */
1330 }
1331 /* Range check / return */
1335 }
1336 }
1339 }
1340 }
1342 /* Allocation configured by ext 13 */
1347 /* Don't overflow settings->bundles[] ! */
1354 /* ERROR */
1356 }
1357 settings->bundles[alloc_start+n].start = settings->ext13_start_prbs[alloc] + startPrbc + n*numBundPrb;
1362 }
1363 }
1364 }
1365 }
1367 /* Bundles not controlled by other extensions - just divide up range into bundles we have */
1371 /* Don't overflow settings->bundles[] ! */
1377 /* Does it go beyond the end? */
1381 }
1382 }
1383 }
1384 }
1387 /*******************************************************/
1388 /* Overall state of a flow (eAxC/plane) */
1390 /* State for sequence analysis [each direction] */
1395 /* Table recording ackNack requests (ackNackId -> ack_nack_request_t*)
1396 Note that this assumes that the same ackNackId will not be reused within a state,
1397 which may well not be valid */
1400 /* Store udCompHdr seen in C-Plane for UL - can be looked up and used by U-PLane.
1401 Note that this appears in the common section header parts of ST1, ST3, ST5,
1402 so can still be over-written per sectionId in the U-Plane */
1412 /* Modulation compression params */
1413 /* TODO: incomplete (see SE4, SE5, SE23), and needs to be per section! */
1414 //uint16_t mod_comp_re_mask;
1415 //bool mod_compr_csf;
1416 //double mod_compr_mod_comp_scaler;
1421 nstime_t request_frame_time;
1423 SE22,
1424 ST4Cmd1,
1425 ST4Cmd2,
1426 ST4Cmd3,
1427 ST4Cmd4
1431 nstime_t response_frame_time;
1441 };
1443 #define ORAN_C_PLANE 0
1444 #define ORAN_U_PLANE 1
1447 {
1449 }
1452 /* Table maintained on first pass from flow_key(uint32_t) -> flow_state_t* */
1455 /* Table consulted on subsequent passes: frame_num -> flow_result_t* */
1459 /* Sequence analysis */
1474 /* Write the given formatted text to:
1475 - the info column (if pinfo != NULL)
1476 - 1 or 2 other labels (optional)
1477 */
1480 {
1481 #define MAX_INFO_BUFFER 256
1487 }
1493 /* Add to indicated places */
1496 }
1499 }
1502 }
1503 }
1505 /* Add section labels (type + PRB range) for C-Plane, U-Plane */
1506 static void
1509 {
1512 /* None -> all */
1513 write_pdu_label_and_info(section_heading, protocol_item, pinfo, ", Id: %4d (all PRBs) ", section_id);
1516 /* Single PRB */
1517 write_pdu_label_and_info(section_heading, protocol_item, pinfo, ", Id: %4d (PRB: %7u)", section_id, start_prbx);
1520 /* Range */
1521 write_pdu_label_and_info(section_heading, protocol_item, pinfo, ", Id: %4d (PRB: %3u-%3u%s)", section_id, start_prbx,
1523 }
1524 }
1526 static void
1530 {
1533 /* TODO: ?? */
1536 /* Single PRB */
1542 /* Range */
1546 }
1547 }
1550 /* 5.1.3.2.7 (real time control data / IQ data transfer message series identifier) */
1551 static void
1553 {
1554 /* Subtree */
1562 /* All parts of eAxC should be above 0, and should total 16 bits (breakdown controlled by preferences) */
1563 if (!((pref_du_port_id_bits > 0) && (pref_bandsector_id_bits > 0) && (pref_cc_id_bits > 0) && (pref_ru_port_id_bits > 0) &&
1564 ((pref_du_port_id_bits + pref_bandsector_id_bits + pref_cc_id_bits + pref_ru_port_id_bits) == 16))) {
1569 }
1573 /* N.B. For sequence analysis / tapping, just interpret these 2 bytes as eAxC ID... */
1576 /* DU Port ID */
1577 proto_tree_add_bits_ret_val(oran_pcid_tree, hf_oran_du_port_id, tvb, bit_offset, pref_du_port_id_bits, &duPortId, ENC_BIG_ENDIAN);
1579 /* BandSector ID */
1580 proto_tree_add_bits_ret_val(oran_pcid_tree, hf_oran_bandsector_id, tvb, bit_offset, pref_bandsector_id_bits, &bandSectorId, ENC_BIG_ENDIAN);
1582 /* CC ID */
1583 proto_tree_add_bits_ret_val(oran_pcid_tree, hf_oran_cc_id, tvb, bit_offset, pref_cc_id_bits, &ccId, ENC_BIG_ENDIAN);
1585 /* RU Port ID */
1586 proto_tree_add_bits_ret_val(oran_pcid_tree, hf_oran_ru_port_id, tvb, bit_offset, pref_ru_port_id_bits, &ruPortId, ENC_BIG_ENDIAN);
1589 proto_item_append_text(oran_pcid_ti, " (DU_Port_ID: %d, BandSector_ID: %d, CC_ID: %d, RU_Port_ID: %d)",
1593 proto_item *pi = proto_tree_add_string(oran_pcid_tree, hf_oran_c_eAxC_ID, tvb, id_offset, 2, id);
1595 }
1597 /* 5.1.3.2.8 ecpriSeqid (message identifier) */
1598 static int
1599 addSeqid(tvbuff_t *tvb, proto_tree *oran_tree, int offset, int plane, uint8_t *seq_id, proto_item **seq_id_ti)
1600 {
1601 /* Subtree */
1602 proto_item *seqIdItem = proto_tree_add_item(oran_tree, hf_oran_ecpri_seqid, tvb, offset, 2, ENC_NA);
1605 /* Sequence ID (8 bits) */
1606 *seq_id_ti = proto_tree_add_item_ret_uint(oran_seqid_tree, hf_oran_sequence_id, tvb, offset, 1, ENC_NA, &seqId);
1609 /* E bit */
1611 /* Subsequence ID (7 bits) */
1612 proto_tree_add_item_ret_uint(oran_seqid_tree, hf_oran_subsequence_id, tvb, offset, 1, ENC_NA, &subSeqId);
1615 /* radio-transport fragmentation not allowed for C-Plane messages */
1619 }
1620 }
1623 /* TODO: Re-assembly of any radio-fragmentation on U-Plane */
1625 }
1626 }
1628 /* Summary */
1632 }
1634 /* 7.7.1.2 bfwCompHdr (beamforming weight compression header) */
1637 {
1638 /* Subtree */
1644 /* Width and method */
1647 /* Special case: 0 -> 16 */
1651 offset++;
1653 /* Summary */
1659 }
1661 /* 7.7.1.3 bfwCompParam (beamforming weight compression parameter).
1662 * Depends upon passed-in bfwCompMeth (field may be empty) */
1663 static int dissect_bfwCompParam(tvbuff_t *tvb, proto_tree *tree, packet_info *pinfo, int offset,
1666 {
1668 /* Absent! */
1671 }
1673 /* Subtree */
1677 proto_tree *bfwcompparam_tree = proto_item_add_subtree(bfwcompparam_ti, ett_oran_bfwcompparam);
1685 /* 4 reserved bits + exponent */
1690 offset++;
1693 /* Separate into integer and fractional bits? */
1696 offset++;
1699 /* compBitWidth, compShift */
1704 offset++;
1707 /* TODO: activeBeamspaceCoefficientMask - ceil(K/8) octets */
1708 /* proto_tree_add_item(extension_tree, hf_oran_blockScaler,
1709 tvb, offset, 1, ENC_BIG_ENDIAN);
1710 offset++; */
1713 /* TODO: activeBeamspaceCoefficientMask - ceil(K/8) octets */
1714 /* reserved (4 bits) + exponent (4 bits)
1715 proto_tree_add_item(bfwcompparam_tree, hf_oran_reserved_4bits, tvb, offset, 1, ENC_NA);
1716 proto_tree_add_item_ret_uint(bfwcompparam_tree, hf_oran_exponent, tvb, offset, 1, ENC_BIG_ENDIAN, exponent);
1717 offset += 1;
1718 */
1722 /* Not handled */
1724 }
1726 /* Can't go on if compression scheme not supported */
1730 bfw_comp_method,
1732 }
1734 }
1737 /* Special case for uncompressed/16-bit value */
1739 {
1742 }
1744 /* Decompress I/Q value, taking into account method, width, exponent, other input-specific methods */
1745 /* TODO: pass in info needed for Modulation (reMask, csf, mcScaler values) gleaned from SE 4,5,23 */
1746 static float decompress_value(uint32_t bits, uint32_t comp_method, uint8_t iq_width, uint32_t exponent)
1747 {
1754 {
1755 /* A.1.2 Block Floating Point Decompression Algorithm */
1759 /* Check last bit, in case we need to flip to -ve */
1762 }
1764 /* Unscale */
1771 }
1775 /* Not supported! But will be reported as expert info outside of this function! */
1780 /* TODO: ! */
1785 /* Not supported! But will be reported as expert info outside of this function! */
1787 }
1788 }
1790 /* Out-of-range value used for special case */
1791 #define ORPHAN_BUNDLE_NUMBER 999
1793 /* Bundle of PRBs/TRX I/Q samples (ext 11) */
1794 static uint32_t dissect_bfw_bundle(tvbuff_t *tvb, proto_tree *tree, packet_info *pinfo, unsigned offset,
1800 {
1801 /* Set bundle name */
1805 }
1808 }
1810 /* Create Bundle root */
1816 bundle_name,
1818 }
1823 bundle_name,
1824 first_prb);
1825 }
1828 /* Generated bundle id */
1830 bundle_number);
1834 /* bfwCompParam */
1840 /* Can't show details of unsupported compression method */
1842 /* Don't know how to show, so give up */
1844 }
1846 /* Create Bundle subtree */
1851 /* contInd */
1854 /* beamId */
1856 proto_tree_add_item_ret_uint(bundle_tree, hf_oran_beam_id, tvb, offset, 2, ENC_BIG_ENDIAN, &beam_id);
1860 /* Number of weights per bundle (from preference) */
1861 proto_item *wpb_ti = proto_tree_add_uint(bundle_tree, hf_oran_num_weights_per_bundle, tvb, 0, 0,
1862 num_weights_per_bundle);
1865 /* Add the weights for this bundle */
1868 /* Create subtree */
1876 /* I */
1877 /* Get bits, and convert to float. */
1880 /* Add to tree. */
1881 proto_tree_add_float_format_value(bfw_tree, hf_oran_bfw_i, tvb, bit_offset/8, (iq_width+7)/8, value, "#%u=%f", w, value);
1885 /* Q */
1886 /* Get bits, and convert to float. */
1889 /* Add to tree. */
1890 proto_tree_add_float_format_value(bfw_tree, hf_oran_bfw_q, tvb, bit_offset/8, (iq_width+7)/8, value, "#%u=%f", w, value);
1893 }
1895 /* Set extent of bundle */
1899 }
1901 /* Return new bit offset. in/out will always be byte-aligned.. */
1902 static int dissect_ciCompParam(tvbuff_t *tvb, proto_tree *tree, packet_info *pinfo _U_, unsigned bit_offset,
1904 {
1906 /* Nothing in frame so don't even create subtree */
1908 }
1910 /* Subtree */
1917 /* Contents differ by compression method */
1928 /* Separate into integer and fractional bits? */
1934 /* compBitWidth, compShift */
1943 /* reserved, ? bytes of zeros.. */
1945 }
1948 }
1950 /* frameStructure (7.5.2.13) */
1953 {
1955 /* FFT Size (4 bits) */
1957 /* Subcarrier spacing (SCS) */
1958 proto_tree_add_item_ret_uint(tree, hf_oran_frameStructure_subcarrier_spacing, tvb, offset, 1, ENC_NA, &scs);
1960 /* Show slot within frame as a generated field. See table 7.5.13-3 */
1964 }
1969 }
1971 }
1975 {
1978 csf_ti = proto_tree_add_bits_ret_val(tree, hf_oran_csf, tvb, bit_offset, 1, &csf, ENC_BIG_ENDIAN);
1980 /* Table 7.7.4.2-1 Constellation shift definition (index is udIqWidth) */
1984 }
1985 }
1987 /* Set out parameter */
1990 }
1992 }
1995 /* Section 7.
1996 * N.B. these are the green parts of the tables showing Section Types, differing by section Type */
2003 {
2008 /* Section subtree */
2025 /* Config affecting ext11 bundles (initially unset) */
2026 ext11_settings_t ext11_settings;
2031 /* These sections (ST0, ST1, ST2, ST3, ST5, ST9) are similar, so handle as common with per-type differences */
2035 /* sectionID */
2036 proto_item *ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_section_id, tvb, offset, 2, ENC_BIG_ENDIAN, §ionId);
2039 }
2040 offset++;
2042 /* rb */
2045 /* symInc (1 bit) */
2049 proto_item *sym_inc_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_symInc, tvb, offset, 1, ENC_NA, &sym_inc);
2051 /* "0 shall be used" */
2053 }
2054 }
2056 /* reserved (1 bit) */
2058 }
2060 /* startPrbx and numPrbx */
2062 /* startPrbu (10 bits) */
2063 proto_tree_add_item_ret_uint(c_section_tree, hf_oran_startPrbu, tvb, offset, 2, ENC_BIG_ENDIAN, &startPrbu);
2065 /* numPrbu */
2066 numprbc_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_numPrbu, tvb, offset, 1, ENC_NA, &numPrbu);
2068 proto_item_append_text(numprbc_ti, " (all PRBs - configured as %u)", pref_data_plane_section_total_rbs);
2070 }
2072 }
2074 /* startPrbc (10 bits) */
2075 proto_tree_add_item_ret_uint(c_section_tree, hf_oran_startPrbc, tvb, offset, 2, ENC_BIG_ENDIAN, &startPrbc);
2077 /* numPrbc */
2078 numprbc_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_numPrbc, tvb, offset, 1, ENC_NA, &numPrbc);
2080 proto_item_append_text(numprbc_ti, " (all PRBs - configured as %u)", pref_data_plane_section_total_rbs);
2081 }
2083 }
2099 NULL
2100 };
2102 /* reMask */
2106 offset++;
2107 /* numSymbol */
2109 proto_item *numsymbol_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_numSymbol, tvb, offset, 1, ENC_NA, &numSymbol);
2114 }
2115 offset++;
2117 /* [ef] (extension flag) */
2125 proto_tree_add_item_ret_boolean(c_section_tree, hf_oran_ef, tvb, offset, 1, ENC_BIG_ENDIAN, &extension_flag);
2128 /* Other section types don't support extensions */
2130 }
2136 /* Special case for all PRBs */
2139 }
2140 }
2144 }
2146 /* Section type specific fields (after 'numSymbol') */
2149 /* reserved (15 bits) */
2155 /* beamId */
2156 beamId_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_beamId, tvb, offset, 2, ENC_BIG_ENDIAN, &beamId);
2163 {
2164 /* beamId */
2165 beamId_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_beamId, tvb, offset, 2, ENC_BIG_ENDIAN, &beamId);
2168 /* freqOffset */
2170 proto_item *freq_offset_item = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_freqOffset, tvb, offset, 3, ENC_BIG_ENDIAN, &freqOffset);
2175 /* reserved */
2179 proto_item_append_text(sectionHeading, ", BeamId: %d, FreqOffset: %d \u0394f", beamId, freqOffset);
2181 }
2185 /* ueId */
2186 ueId_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_ueId, tvb, offset, 2, ENC_NA, &ueId);
2190 }
2196 {
2197 /* Hidden filter for bf (DMFS-BF) */
2204 /* TODO: create a subtree for each PRB entry with good summary? */
2206 /* Each prb starts byte-aligned */
2209 /* N.B., using width/method from UL U-plane preferences, not certain that this is correct.. */
2211 /* sinrCompParam */
2212 uint32_t exponent = 0; /* N.B. init to silence warnings, but will always be set if read in COMP_BLOCK_FP case */
2218 /* sinrValues for this PRB. TODO: subtree for each PRB? */
2219 /* TODO: not sure how numSinrPerPrb interacts with rb==1... */
2221 unsigned sinr_bits = tvb_get_bits(tvb, bit_offset, pref_sample_bit_width_uplink, ENC_BIG_ENDIAN);
2223 /* TODO: using uplink compression settings from preferences. This isn't right.. */
2224 float value = decompress_value(sinr_bits, pref_iqCompressionUplink, pref_sample_bit_width_uplink, exponent);
2228 /* Show here which subcarriers share which values (they all divide 12..) */
2234 }
2235 }
2238 }
2240 /* Reserved (15 bits) */
2247 }
2248 }
2250 /* ef */
2251 proto_tree_add_item_ret_boolean(c_section_tree, hf_oran_ef, tvb, offset, 1, ENC_BIG_ENDIAN, &extension_flag);
2252 /* ueId */
2255 /* regularizationFactor */
2258 /* reserved (4 bits) */
2260 /* rb ("Value=0 shall be set") */
2262 proto_item *rb_ti = proto_tree_add_item_ret_uint(c_section_tree, hf_oran_rb, tvb, offset, 1, ENC_NA, &rb);
2266 }
2267 /* symInc */
2269 /* startPrbc */
2270 proto_tree_add_item_ret_uint(c_section_tree, hf_oran_startPrbc, tvb, offset, 2, ENC_BIG_ENDIAN, &startPrbc);
2272 /* numPrbc */
2273 proto_tree_add_item_ret_uint(c_section_tree, hf_oran_numPrbc, tvb, offset, 1, ENC_NA, &numPrbc);
2276 /* Hidden filter for bf */
2280 /* ciIsample,ciQsample pairs */
2285 /* Antenna count from preference */
2295 /* PRB subtree */
2302 /* There may be a ciCompParam here.. */
2305 }
2308 /* Antennas */
2314 /* Create subtree for antenna */
2320 /* I */
2321 /* Get bits, and convert to float. */
2325 /* Add to tree. */
2326 proto_tree_add_float_format_value(sample_tree, hf_oran_ciIsample, tvb, bit_offset/8, (16+7)/8, value, "#%u=%f", m, value);
2330 /* Q */
2331 /* Get bits, and convert to float. */
2335 /* Add to tree. */
2336 proto_tree_add_float_format_value(sample_tree, hf_oran_ciQsample, tvb, bit_offset/8, (16+7)/8, value, "#%u=%f", m, value);
2339 }
2341 }
2343 }
2349 /* Section extension commands */
2354 /* Prefetch extType so can use specific extension type ett */
2358 /* Just use first one if out of range */
2360 }
2362 /* Create subtree for each extension (with summary) */
2365 proto_tree *extension_tree = proto_item_add_subtree(extension_ti, ett_oran_c_section_extension[exttype_ett_index-1]);
2367 /* ef (i.e. another extension after this one?) */
2368 proto_tree_add_item_ret_boolean(extension_tree, hf_oran_ef, tvb, offset, 1, ENC_BIG_ENDIAN, &extension_flag);
2370 /* extType */
2372 exttype_ti = proto_tree_add_item(extension_tree, hf_oran_exttype, tvb, offset, 1, ENC_BIG_ENDIAN);
2373 offset++;
2376 proto_item_append_text(extension_ti, " (ext-%u: %s)", exttype, val_to_str_const(exttype, exttype_vals, "Reserved"));
2378 /* Don't tap if out of range. */
2381 }
2383 /* Is this SE allowed for this section type? */
2389 }
2392 /* extLen (number of 32-bit words) */
2393 uint32_t extlen_len = ((exttype==11)||(exttype==19)||(exttype==20)) ? 2 : 1; /* Extensions 11/19/20 are special */
2402 /* Break out to avoid infinitely looping! */
2404 }
2411 {
2415 /* Hidden filter for bf */
2419 /* bfwCompHdr (2 subheaders - bfwIqWidth and bfwCompMeth)*/
2423 /* bfwCompParam */
2429 /* Can't show details of unsupported compression method */
2432 }
2434 /* We know:
2435 - iq_width (above)
2436 - numBfWeights (taken from preference)
2437 - remaining bytes in extension
2438 We can therefore derive TRX (number of antennas).
2439 */
2441 /* I & Q samples
2442 Don't know how many there will be, so just fill available bytes...
2443 */
2450 /* Create antenna subtree */
2456 /* I value */
2457 /* Get bits, and convert to float. */
2460 /* Add to tree. */
2466 /* Leave a gap between I and Q values */
2469 /* Q value */
2470 /* Get bits, and convert to float. */
2473 /* Add to tree. */
2481 }
2482 /* Need to round to next byte */
2486 }
2489 {
2490 /* Hidden filter for bf */
2494 /* bfaCompHdr (get widths of fields to follow) */
2496 /* subtree */
2501 /* reserved (2 bits) */
2503 /* bfAzPtWidth (3 bits) */
2504 proto_tree_add_item_ret_uint(bfa_tree, hf_oran_bfAzPtWidth, tvb, offset, 1, ENC_BIG_ENDIAN, &bfAzPtWidth);
2505 /* bfZePtWidth (3 bits) */
2506 proto_tree_add_item_ret_uint(bfa_tree, hf_oran_bfZePtWidth, tvb, offset, 1, ENC_BIG_ENDIAN, &bfZePtWidth);
2509 /* reserved (2 bits) */
2511 /* bfAz3ddWidth (3 bits) */
2512 proto_tree_add_item_ret_uint(bfa_tree, hf_oran_bfAz3ddWidth, tvb, offset, 1, ENC_BIG_ENDIAN, &bfAz3ddWidth);
2513 /* bfZe3ddWidth (3 bits) */
2514 proto_tree_add_item_ret_uint(bfa_tree, hf_oran_bfZe3ddWidth, tvb, offset, 1, ENC_BIG_ENDIAN, &bfZe3ddWidth);
2519 /* bfAzPt */
2521 proto_tree_add_bits_item(extension_tree, hf_oran_bfAzPt, tvb, bit_offset, bfAzPtWidth+1, ENC_BIG_ENDIAN);
2523 }
2524 /* bfZePt */
2526 proto_tree_add_bits_item(extension_tree, hf_oran_bfZePt, tvb, bit_offset, bfZePtWidth+1, ENC_BIG_ENDIAN);
2528 }
2529 /* bfAz3dd */
2531 proto_tree_add_bits_item(extension_tree, hf_oran_bfAz3dd, tvb, bit_offset, bfAz3ddWidth+1, ENC_BIG_ENDIAN);
2533 }
2534 /* bfZe3dd */
2536 proto_tree_add_bits_item(extension_tree, hf_oran_bfZe3dd, tvb, bit_offset, bfZe3ddWidth+1, ENC_BIG_ENDIAN);
2538 }
2540 /* Pad to next byte (unless last 2 fields already fit in this one) */
2543 }
2546 }
2548 /* bfAzSl (3 bits) */
2550 /* bfZeSl (3 bits) */
2554 }
2557 {
2558 /* codebookindex (8 bits) */
2559 /* "This parameter is not used and shall be set to zero." */
2562 /* layerid */
2564 proto_tree_add_item_ret_uint(extension_tree, hf_oran_layerid, tvb, offset, 1, ENC_BIG_ENDIAN, &layerid);
2565 /* numLayers */
2569 /* Stop here for non-first data layer */
2572 }
2574 /* First data layer case */
2575 /* txScheme */
2577 /* crsReMask */
2581 /* crsShift (1 bit) */
2583 /* reserved (3 bits) */
2585 /* crsSymNum (4 bits) */
2588 /* reserved */
2592 /* reserved (1 bit) */
2594 /* beamIdAP1 (15 bits) */
2597 /* reserved (1 bit) */
2599 /* beamIdAP2 (15 bits) */
2602 /* reserved (1 bit) */
2604 /* beamIdAP3 (15 bits) */
2608 }
2611 {
2612 /* csf */
2615 /* modCompScaler */
2621 /* Work out and show floating point value too. exponent and mantissa are both unsigned */
2627 /* TODO: need to store these in per-section data in state that gets looked up by U-Plane */
2629 }
2632 {
2633 /* Applies only to section types 1,3 and 5 */
2634 /* N.B. there may be multiple instances of this SE in the same frame */
2636 /* There may be one or 2 entries, depending upon extlen */
2648 /* sets can be 3 or 4, depending upon whether last 28 bits are 0.. */
2652 }
2656 }
2660 /* Malformed error!!! */
2663 extlen);
2665 }
2670 /* Subtree for each set */
2679 /* mcScaleReMask (12 bits) */
2680 proto_tree_add_bits_ret_val(set_tree, hf_oran_mc_scale_re_mask, tvb, bit_offset, 12, &mcScaleReMask, ENC_BIG_ENDIAN);
2682 /* csf (1 bit) */
2684 /* mcScaleOffset (15 bits) */
2685 proto_item *ti = proto_tree_add_bits_ret_val(set_tree, hf_oran_mc_scale_offset, tvb, bit_offset, 15, &mcScaleOffset, ENC_BIG_ENDIAN);
2692 /* Summary */
2696 }
2700 /* Reserved (variable-length) */
2702 proto_tree_add_bits_item(extension_tree, hf_oran_reserved, tvb, bit_offset, reserved_bits, ENC_BIG_ENDIAN);
2704 }
2708 }
2711 {
2712 /* Update ext6 recorded info */
2715 /* repetition */
2716 proto_tree_add_bits_item(extension_tree, hf_oran_repetition, tvb, offset*8, 1, ENC_BIG_ENDIAN);
2717 /* rbgSize (PRBs per bit set in rbgMask) */
2720 rbg_size_ti = proto_tree_add_item_ret_uint(extension_tree, hf_oran_rbgSize, tvb, offset, 1, ENC_BIG_ENDIAN, &rbgSize);
2722 /* N.B. this is only true if "se6-rb-bit-supported" is set... */
2725 }
2726 /* rbgMask (28 bits) */
2728 proto_item *rbgmask_ti = proto_tree_add_item_ret_uint(extension_tree, hf_oran_rbgMask, tvb, offset, 4, ENC_BIG_ENDIAN, &rbgMask);
2731 }
2733 /* TODO: if receiver detects non-zero bits outside the valid range, those shall be ignored. */
2735 /* priority */
2736 proto_tree_add_item(extension_tree, hf_oran_noncontig_priority, tvb, offset, 1, ENC_BIG_ENDIAN);
2737 /* symbolMask */
2741 /* Look up rbg_size enum -> value */
2744 /* N.B. reserved, but covered above with expert info (would remain 0) */
2760 /* N.B., encoded in 3 bits, so no other values are possible */
2761 }
2763 /* Set to looked-up value */
2768 /* The O-DU shall not use combinations of startPrbc, numPrbc and rbgSize leading to a value of lastRbgid larger than 27 */
2769 /* i.e., leftmost bit used should not need to go off left end of rbgMask! */
2776 }
2777 }
2779 /* Record (and count) which bits are set in rbgMask */
2788 }
2790 }
2791 }
2793 /* Show how many bits were set in rbgMask */
2795 /* Also, that is the range of bits */
2798 }
2800 /* Complain if last set bit is beyond lastRbgid */
2806 }
2807 }
2809 }
2812 /* Allow ST0 to address multiple eAxC_ID values for transmission blanking */
2818 proto_tree_add_item(extension_tree, hf_oran_regularizationFactor, tvb, offset, 2, ENC_BIG_ENDIAN);
2830 {
2833 /* beamGroupType */
2838 proto_item_append_text(extension_ti, " (%s)", val_to_str_const(beam_group_type, beam_group_type_vals, "Unknown"));
2840 /* numPortc */
2843 offset++;
2845 /* Will append all beamId values to extension_ti, regardless of beamGroupType */
2851 /* Reserved byte */
2853 offset++;
2857 {
2860 /* Beam listing vector case */
2861 /* Work out how many port beam entries there is room for */
2862 /* Using numPortC as visible in issue 18116 */
2864 /* 1 reserved bit */
2867 /* port beam ID (or UEID) */
2875 }
2879 }
2881 {
2885 /* first portListIndex */
2892 /* 1 reserved bit */
2895 /* port beam ID (or UEID) */
2902 /* portListIndex */
2908 }
2909 }
2913 }
2917 /* Warning for unsupported/reserved value */
2920 }
2922 }
2925 {
2926 /* Hidden filter for bf */
2930 /* beamId in section header should be ignored. Guard against appending multiple times.. */
2934 }
2940 /* disableBFWs */
2945 }
2947 /* RAD */
2950 /* bundleOffset (6 bits) */
2953 offset++;
2955 /* numBundPrb (number of prbs in each bundle) */
2956 proto_item *num_bund_prb_ti = proto_tree_add_item_ret_uint(extension_tree, hf_oran_num_bund_prbs,
2958 offset++;
2959 /* value zero is reserved.. */
2963 }
2969 /********************************************/
2970 /* Table 7.7.1.1-1 */
2971 /********************************************/
2976 /* bfwCompHdr (2 subheaders - bfwIqWidth and bfwCompMeth)*/
2980 /* Work out number of bundles, but take care not to divide by zero. */
2983 }
2985 /* Work out bundles! */
2989 /* Add (complete) bundles */
2995 numPrbc :
2996 pref_num_weights_per_bundle,
2997 bfwcomphdr_iq_width,
3004 }
3005 }
3007 /* Set flag from last bundle entry */
3009 }
3010 }
3012 /********************************************/
3013 /* Table 7.7.1.1-2 */
3014 /* No weights in this case */
3015 /********************************************/
3017 /* Work out number of bundles, but take care not to divide by zero. */
3020 }
3026 /* contInd */
3029 /* beamId */
3034 }
3038 }
3040 }
3041 }
3043 /* Add summary to extension root */
3046 }
3049 }
3050 }
3055 {
3058 /* priority */
3059 proto_tree_add_item(extension_tree, hf_oran_noncontig_priority, tvb, offset, 1, ENC_BIG_ENDIAN);
3061 /* symbolMask */
3065 /* There are now 'R' pairs of (offStartPrb, numPrb) values. Fill extlen bytes with values. If last one is not set,
3066 should be populated with 0s. */
3071 {
3072 /* Create a subtree for each pair */
3073 proto_item *pair_ti = proto_tree_add_string(extension_tree, hf_oran_off_start_prb_num_prb_pair,
3077 /* offStartPrb */
3079 proto_tree_add_item_ret_uint(pair_tree, hf_oran_off_start_prb, tvb, offset, 1, ENC_BIG_ENDIAN, &off_start_prb);
3080 offset++;
3082 /* numPrb */
3084 proto_tree_add_item_ret_uint(pair_tree, hf_oran_num_prb, tvb, offset, 1, ENC_BIG_ENDIAN, &num_prb);
3085 offset++;
3089 /* Last pair may be 0,0 if not used. Check for this */
3092 }
3093 /* Add summary to pair root item, and configure details in ext11_settings */
3100 }
3101 }
3102 }
3104 }
3107 {
3108 /* Will update settings for ext11 */
3117 {
3118 /* Subtree for allocation */
3123 /* Reserved (2 bits) */
3126 /* nextSymbolId (4 bits) */
3128 proto_tree_add_item_ret_uint(allocation_tree, hf_oran_nextSymbolId, tvb, offset, 1, ENC_BIG_ENDIAN, &next_symbol_id);
3130 /* nextStartPrbc (10 bits) */
3132 proto_tree_add_item_ret_uint(allocation_tree, hf_oran_nextStartPrbc, tvb, offset, 2, ENC_BIG_ENDIAN, &next_start_prbc);
3135 /* Add summary to allocation root item */
3139 /* Checking for duplicates (expected if e.g. had only 2 entries but extlen bytes still to fill */
3140 if ((allocation_index > 1) && (next_symbol_id == prev_next_symbol_id) && (next_start_prbc == prev_next_start_prbc)) {
3142 }
3144 /* Add entry for configuring ext11. don't store out of range */
3147 }
3148 }
3153 }
3155 }
3158 /* Hidden filter for bf (DMRS BF) */
3167 }
3169 /* Loop over numPortc++1 (from SE 10) nullLayerInd fields */
3173 }
3174 }
3178 {
3179 /* frameStructure */
3182 /* freqOffset */
3185 /* cpLength */
3186 proto_item *cplength_ti = proto_tree_add_item(extension_tree, hf_oran_cpLength, tvb, offset, 2, ENC_BIG_ENDIAN);
3189 }
3192 }
3195 {
3196 /* Just filling available bytes with antMask entries.
3197 N.B., if SE 10 also used, could associate each antMask with (beamId or UEId) RX eAxC */
3201 proto_item *ti = proto_tree_add_item(extension_tree, hf_oran_antMask, tvb, offset, 8, ENC_BIG_ENDIAN);
3204 }
3206 }
3209 {
3213 /* TODO: just filling up all available bytes - some may actually be padding.. */
3214 /* "the preceding Section Type and extension messages implicitly provide the number of scheduled users" */
3216 proto_item *ti = proto_tree_add_bits_item(extension_tree, hf_oran_num_ueid, tvb, bit_offset, 4, ENC_BIG_ENDIAN);
3218 }
3220 }
3223 /* transmissionWindowOffset */
3224 proto_tree_add_item(extension_tree, hf_oran_transmissionWindowOffset, tvb, offset, 2, ENC_BIG_ENDIAN);
3226 /* reserved (2 bits) */
3228 /* transmissionWindowSize (14 bits) */
3229 proto_tree_add_item(extension_tree, hf_oran_transmissionWindowSize, tvb, offset, 2, ENC_BIG_ENDIAN);
3232 /* reserved (6 bits) */
3234 /* toT (2 bits) */
3240 {
3241 /* beamId in section header should be ignored. Guard against appending multiple times.. */
3245 }
3247 /* disableBFWs */
3253 }
3254 /* Repetition */
3256 proto_tree_add_bits_ret_val(extension_tree, hf_oran_repetition, tvb, (offset*8)+1, 1, &repetition, ENC_BIG_ENDIAN);
3257 /* numPortc */
3260 offset++;
3262 /* priority */
3263 proto_tree_add_item(extension_tree, hf_oran_noncontig_priority, tvb, offset, 1, ENC_BIG_ENDIAN);
3264 /* symbolMask */
3268 /* bfwCompHdr */
3276 /* Add entries for each port */
3279 /* Create subtree for port entry*/
3286 /* Reserved (4 bits) */
3288 /* portReMask (12 bits) */
3292 /* Reserved (2 bits) */
3294 /* portSymbolMask (14 bits) */
3298 /* Reserved (1 bit) */
3300 /* beamID (15 bits) */
3301 proto_tree_add_item_ret_uint(port_tree, hf_oran_beamId, tvb, offset, 2, ENC_BIG_ENDIAN, &beamId);
3305 /* No weights present */
3307 /*******************************************************************/
3308 /* Table 7.7.19.1-1 (there is no part -2 for disableBFWs case...), */
3309 /* but for SE 11, bfwCompParam was only present for !disableBFWs */
3310 /*******************************************************************/
3312 /* bfwCompParam */
3321 /* Add weights for each TRX */
3324 /* Create BFW subtree */
3332 /* I */
3333 /* Get bits, and convert to float. */
3336 /* Add to tree. */
3342 /* Q */
3343 /* Get bits, and convert to float. */
3346 /* Add to tree. */
3351 }
3354 }
3356 /* No weights... */
3358 /* Reserved (1 bit) */
3360 /* beamID (15 bits) */
3361 proto_tree_add_item_ret_uint(extension_tree, hf_oran_beamId, tvb, offset, 2, ENC_BIG_ENDIAN, &beamId);
3364 }
3366 /* Set length of this port entry */
3368 }
3369 }
3371 }
3374 {
3375 /* numPuncPatterns */
3377 proto_tree_add_item_ret_uint(extension_tree, hf_oran_numPuncPatterns, tvb, offset, 1, ENC_BIG_ENDIAN, &numPuncPatterns);
3380 /* Add each puncturing pattern */
3384 /* Subtree for this puncturing pattern */
3390 /* SymbolMask (14 bits) */
3393 /* startPuncPrb (10 bits) */
3396 /* numPuncPrb (8 bits) */
3399 /* puncReMask (12 bits) */
3402 /* rb (1 bit) */
3403 proto_item *rb_ti = proto_tree_add_item(pattern_tree, hf_oran_rb, tvb, offset, 1, ENC_BIG_ENDIAN);
3404 /* reserved (1 bit) */
3406 /* multiSDScope (1 bit) */
3408 /* rbgIncl (1 bit) */
3410 proto_tree_add_item_ret_boolean(pattern_tree, hf_oran_RbgIncl, tvb, offset, 1, ENC_BIG_ENDIAN, &rbgIncl);
3414 /* reserved (1 bit) */
3416 /* rbgSize(3 bits) */
3418 /* rbgMask (28 bits) */
3423 }
3426 }
3429 }
3431 {
3432 /* ciPrbGroupSize */
3434 proto_item *prb_group_size_ti = proto_tree_add_item_ret_uint(extension_tree, hf_oran_ci_prb_group_size, tvb, offset, 1, ENC_BIG_ENDIAN, &ci_prb_group_size);
3441 /* Reserved value */
3444 ci_prb_group_size);
3448 /* This value affects how SE 11 is interpreted */
3454 }
3456 }
3458 /* reserved (6 bits) */
3461 /* prgSize (2 bits). Interpretation depends upon section type (5 or 6), but also mplane parameters? */
3464 }
3467 }
3470 }
3473 {
3481 /* Add this request into conversation state on first pass */
3486 /* Insert into flow's tree */
3488 }
3490 /* Try to link forward to ST8 response */
3492 ack_nack_req_id);
3495 }
3496 }
3497 }
3499 }
3502 {
3503 /* Green common header */
3505 /* numSymPrbPattern (4 bits) */
3507 proto_tree_add_item_ret_uint(extension_tree, hf_oran_num_sym_prb_pattern, tvb, offset, 1, ENC_BIG_ENDIAN, &num_sym_prb_pattern);
3508 /* reserved (3 bits) */
3510 /* prbMode (1 bit) */
3512 proto_tree_add_item_ret_boolean(extension_tree, hf_oran_prb_mode, tvb, offset, 1, ENC_BIG_ENDIAN, &prb_mode);
3515 /* reserved (8 bits) */
3519 /* Dissect each SymPrbPattern */
3522 /* Subtree */
3529 /* Orange part */
3531 /* Reserved (2 bits) */
3533 /* symMask (14 bits) */
3536 /* numMcScaleOffset (4 bits) */
3537 proto_tree_add_item(pattern_tree, hf_oran_num_mc_scale_offset, tvb, offset, 1, ENC_BIG_ENDIAN);
3540 /* prbPattern (4 bits) */
3543 /* reserved (8 bits) */
3546 }
3548 /* prbBlkOffset (8 bits) */
3551 /* prbBlkSize (4 bits) */
3554 }
3556 /* Yellowish part */
3558 /* prbBlkSize (4 bits) */
3560 }
3562 /* reserved (4 bits) */
3564 }
3566 /* mcScaleReMask (12 bits) */
3568 proto_tree_add_bits_ret_val(pattern_tree, hf_oran_mc_scale_re_mask, tvb, offset*8 + 4, 12, &mcScaleReMask, ENC_BIG_ENDIAN);
3570 /* csf */
3572 /* mcScaleOffset (15 bits) */
3573 proto_tree_add_bits_ret_val(pattern_tree, hf_oran_mc_scale_offset, tvb, offset*8 + 1, 15, &mcScaleOffset, ENC_BIG_ENDIAN);
3577 }
3579 }
3582 {
3583 /* Hidden filter for bf (DMRS BF) */
3587 /* alpnPerSym (1 bit) */
3589 /* antDmrsSnr (1 bit) */
3591 /* reserved (1 bit) */
3593 /* userGroupSize (5 bits) */
3595 proto_item *ugs_ti = proto_tree_add_item_ret_uint(extension_tree, hf_oran_user_group_size, tvb, offset, 1, ENC_BIG_ENDIAN, &user_group_size);
3598 }
3601 }
3603 /* userGroupId (8 bits) */
3605 proto_tree_add_item_ret_uint(extension_tree, hf_oran_user_group_id, tvb, offset, 1, ENC_BIG_ENDIAN, &user_group_id);
3607 /* TODO: Value 0 can happen in several cases, described in 7.7.24.7.. */
3608 }
3611 /* Dissect each entry (until run out of extlen bytes..). Not sure how this works with padding bytes though... */
3612 /* TODO: how to know when have seen last entry? Zero byte (within last 3 bytes of space) are valid... */
3615 /* Subtree */
3621 /* entryType (3 bits) */
3624 entry_type_ti = proto_tree_add_item_ret_uint(entry_tree, hf_oran_entry_type, tvb, offset, 1, ENC_BIG_ENDIAN, &entry_type);
3627 }
3629 /* dmrsPortNumber (5 bits). Values 0-11 allowed */
3631 proto_item *dpn_ti = proto_tree_add_item_ret_uint(entry_tree, hf_oran_dmrs_port_number, tvb, offset, 1, ENC_BIG_ENDIAN, &dmrs_port_number);
3634 }
3637 /* What follows depends upon entryType */
3641 /* No further fields for these */
3646 /* Type 2/3 are very similar.. */
3648 /* ueIdReset (1 bit) */
3650 /* reserved (1 bit) */
3652 /* dmrsSymbolMask (14 bits) */
3653 /* TODO: break down into separate mask fields? */
3657 /* scrambling */
3661 /* nscid (1 bit) */
3664 /* These 5 bits differ depending upon entry type */
3666 /* dType (1 bit) */
3668 /* cdmWithoutData (2 bits) */
3670 /* lambda (2 bits) */
3672 }
3674 /* reserved (1 bit) */
3676 /* lowPaprType (2 bits) */
3678 /* hoppingMode (2 bits) */
3680 }
3682 /* firstPrb (9 bits) */
3685 /* lastPrb (9 bits) */
3688 /* Reserved (16 bits) */
3694 /* reserved - expert info */
3696 }
3700 }
3702 }
3705 /* Just dissect each available block of 7 bytes as the 14 symbols for a layer,
3706 where each layer could be one or apply to all layers. */
3707 {
3708 /* TODO: should only appear in one section of a message.. */
3712 /* Layer subtree */
3718 /* All 14 symbols for a layer (or all layers) */
3721 /* txWinForOnAirSymbol */
3727 /* Ordering not affected */
3729 }
3732 }
3735 }
3736 }
3739 }
3740 /* Set layer subtree label */
3743 }
3745 }
3748 /* Reserved (8 bits). N.B., added after draft? */
3752 /* Reserved (1 bit) */
3754 /* numFoFb (7 bits) */
3756 proto_tree_add_item_ret_uint(extension_tree, hf_oran_num_fo_fb, tvb, offset, 1, ENC_BIG_ENDIAN, &num_fo_fb);
3759 /* Add each freqOffsetFb value */
3762 /* freqOffsetFb (16 bits) */
3765 /* Show if maps onto a -ve number */
3768 }
3771 }
3775 {
3776 /* Hidden filter for bf (DMRS BF) */
3780 /* beamType (2 bits) */
3782 proto_tree_add_item_ret_uint(extension_tree, hf_oran_beam_type, tvb, offset, 1, ENC_BIG_ENDIAN, &beam_type);
3783 /* reserved (6 bits) */
3784 proto_tree_add_item(extension_tree, hf_oran_reserved_last_6bits, tvb, offset, 1, ENC_BIG_ENDIAN);
3787 /* numElements */
3789 proto_tree_add_item_ret_uint(extension_tree, hf_oran_num_elements, tvb, offset, 1, ENC_BIG_ENDIAN, &num_elements);
3792 /* beamId value(s) */
3796 /* reserved (1 bit) + beamId */
3800 }
3803 /* reserved (1 bit) + beamId */
3809 /* Unknown type... */
3811 }
3813 }
3816 /* Other/unexpected extension types */
3822 }
3824 /* Check offset compared with extlen. There should be 0-3 bytes of padding */
3830 }
3832 /* Move offset to beyond signalled length of extension */
3835 /* Set length of extension header. */
3837 }
3838 /* End of section extension handling */
3842 /* RRM measurement reports have measurement reports after extensions */
3844 {
3845 /* Hidden filter for bf (DMFS-BF) */
3851 /* Measurement report subtree */
3857 /* mf (1 bit) */
3860 /* measTypeId (7 bits) */
3863 meas_type_id_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_meas_type_id, tvb, offset, 1, ENC_BIG_ENDIAN, &meas_type_id);
3866 /* Common to all measurement types */
3869 /* numElements */
3870 proto_tree_add_item_ret_uint(mr_tree, hf_oran_num_elements, tvb, offset, 1, ENC_BIG_ENDIAN, &num_elements);
3871 }
3873 /* All other meas ids have a reserved byte */
3875 }
3878 /* measDataSize (16 bits). N.B. begins at mf field, i.e. 2 bytes before this one */
3881 meas_data_size_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_meas_data_size, tvb, offset, 2, ENC_BIG_ENDIAN, &meas_data_size);
3886 /* Summary for measurement report root */
3887 proto_item_append_text(mr_ti, " (%s)", val_to_str_const(meas_type_id, meas_type_id_vals, "unknown"));
3888 /* And section header */
3889 proto_item_append_text(tree, " (%s)", val_to_str_const(meas_type_id, meas_type_id_vals, "unknown"));
3893 {
3894 /* ueTae */
3897 ue_tae_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_ue_tae, tvb, offset, 2, ENC_BIG_ENDIAN, &ue_tae);
3898 /* Show if maps onto a -ve number */
3901 }
3904 /* Reserved (16 bits) */
3908 }
3910 /* ueLayerPower entries (how many? for now just use up meas_data_size..) */
3914 ue_layer_power_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_ue_layer_power, tvb, offset, 2, ENC_BIG_ENDIAN, &ue_layer_power);
3915 /* Show if maps onto a -ve number */
3918 }
3920 }
3921 /* padding out to 4 bytes */
3924 {
3925 /* ueFreqOffset */
3928 ue_freq_offset_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_ue_freq_offset, tvb, offset, 2, ENC_BIG_ENDIAN, &ue_freq_offset);
3929 /* Show if maps onto a -ve number */
3932 }
3935 /* Reserved (16 bits) */
3939 }
3942 /* reserved (2 bits) */
3944 /* symbolMask (14 bits) */
3948 /* 2 bytes for each PRB ipnPower */
3952 /* ipnPower (2 bytes) */
3953 ipn_power_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_ipn_power, tvb, offset, 2, ENC_BIG_ENDIAN, &ipn_power);
3955 /* Show if maps onto a -ve number */
3958 }
3960 }
3961 /* padding out to 4 bytes */
3964 /* antDmrsSnrVal entries */
3968 /* antDmrsSnrVal (2 bytes) */
3969 snr_value_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_ant_dmrs_snr_val, tvb, offset, 2, ENC_BIG_ENDIAN, &snr_value);
3971 /* Show if maps onto a -ve number */
3974 }
3976 }
3980 /* Anything else is not expected */
3983 meas_type_id,
3987 }
3989 /* Pad out to next 4 bytes */
3992 }
3994 /* End of measurement report tree */
3997 }
3999 /* Request for RRM Measurements has commands after extensions */
4001 {
4004 /* Measurement report subtree */
4009 /* mf (1 bit) */
4012 /* measTypeId (7 bits) */
4015 meas_type_id_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_meas_type_id, tvb, offset, 1, ENC_BIG_ENDIAN, &meas_type_id);
4023 /* reserved (1 byte) */
4026 /* measCmdSize. Presumably number of words so in future could skip unrecognised command types.. */
4027 meas_command_ti = proto_tree_add_item_ret_uint(mr_tree, hf_oran_meas_cmd_size, tvb, offset, 2, ENC_BIG_ENDIAN, &meas_command_size);
4030 /* reserved (2 bits) */
4032 /* symbolMask (14 bits) */
4035 /* reserved (16 bits) */
4041 /* Anything else is not expected */
4044 meas_type_id,
4047 }
4049 }
4051 /* Set extent of overall section */
4055 }
4057 /* Dissect udCompHdr (user data compression header, 7.5.2.10) */
4058 /* bit_width and comp_meth are out params */
4059 static int dissect_udcomphdr(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, unsigned offset,
4062 {
4063 /* Subtree */
4069 /* udIqWidth */
4071 proto_item *iq_width_item = proto_tree_add_item_ret_uint(udcomphdr_tree, hf_oran_udCompHdrIqWidth , tvb, offset, 1, ENC_NA, &hdr_iq_width);
4075 /* udCompMeth */
4077 *comp_meth_ti = proto_tree_add_item_ret_uint(udcomphdr_tree, hf_oran_udCompHdrMeth, tvb, offset, 1, ENC_NA, &ud_comp_meth);
4080 }
4082 /* Summary */
4086 }
4093 }
4095 }
4097 }
4099 /* Dissect udCompParam (user data compression parameter, 8.3.3.15) */
4100 /* bit_width and comp_meth are out params */
4101 static int dissect_udcompparam(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree, unsigned offset,
4105 {
4110 /* Not even creating a subtree for udCompMeth 0, 4, 8 */
4112 }
4114 /* Subtree */
4121 /* Show comp_meth as a generated field */
4122 proto_item *meth_ti = proto_tree_add_uint(udcompparam_tree, hf_oran_udCompHdrMeth_pref, tvb, 0, 0, comp_meth);
4141 NULL
4142 };
4147 /* reserved (4 bits) */
4149 /* exponent (4 bits) */
4158 /* Separate into integer and fractional bits? */
4161 offset++;
4165 /* compBitWidth, compShift */
4174 {
4175 /* sReSMask (exponent in middle!) */
4178 hf_oran_sReSMask,
4179 ett_oran_sresmask,
4180 sres_mask_flags,
4181 ENC_NA,
4184 /* Get rid of exponent-shaped gap */
4189 res++;
4190 }
4191 }
4194 /* exponent */
4203 }
4206 {
4207 /* sReSMask (exponent in middle!) */
4211 hf_oran_sReSMask,
4212 ett_oran_sresmask,
4213 sres_mask_flags,
4214 ENC_NA,
4217 /* Get rid of reserved-shaped gap */
4222 res++;
4223 }
4224 }
4227 /* reserved (4 bits) */
4235 }
4238 /* reserved (set to all zeros), but how many bytes?? */
4240 }
4244 }
4247 /* Dissect ciCompHdr (channel information compression header, 7.5.2.15) */
4248 /* bit_width and comp_meth are out params */
4249 static int dissect_cicomphdr(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree, unsigned offset,
4251 {
4252 /* Subtree */
4258 /* ciIqWidth */
4260 proto_item *iq_width_item = proto_tree_add_item_ret_uint(cicomphdr_tree, hf_oran_ciCompHdrIqWidth , tvb, offset, 1, ENC_NA, &hdr_iq_width);
4264 }
4267 /* ciCompMeth */
4269 proto_tree_add_item_ret_uint(cicomphdr_tree, hf_oran_ciCompHdrMeth, tvb, offset, 1, ENC_NA, &ci_comp_meth);
4272 }
4274 /* ciCompOpt */
4280 /* Summary */
4282 hdr_iq_width,
4286 }
4288 static void dissect_payload_version(proto_tree *tree, tvbuff_t *tvb, packet_info *pinfo, unsigned offset)
4289 {
4291 proto_item *ti = proto_tree_add_item_ret_uint(tree, hf_oran_payload_version, tvb, offset, 1, ENC_NA, &version);
4295 version);
4296 /* TODO: should throw an exception? */
4297 }
4298 }
4302 {
4303 /* Request frame */
4308 /* Work out gap between frames (in ms) */
4321 /* Type of request */
4325 }
4329 {
4331 /* Requests may not get a response, and can't always tell when to expect one */
4333 }
4335 /* Response frame */
4340 /* Work out gap between frames (in ms) */
4352 }
4356 /* Control plane dissector (section 7). */
4359 {
4360 /* Hidden filter for plane */
4364 /* Set up structures needed to add the protocol subtree and manage it */
4372 /* Create display subtree for the protocol */
4381 /* Message identifier */
4386 /* Section common subtree */
4392 /* Peek ahead at the section type */
4399 /* dataDirection */
4401 proto_tree_add_item_ret_uint(section_tree, hf_oran_data_direction, tvb, offset, 1, ENC_NA, &direction);
4404 /* Look up any existing conversation state for eAxC+plane */
4408 /* Update/report status of conversation */
4412 /* Allocate new state */
4416 }
4418 /* Check sequence analysis status */
4419 if (state->last_frame_seen[direction] && (seq_id != state->next_expected_sequence_number[direction])) {
4420 /* Store this result */
4426 }
4427 /* Update conversation info */
4431 }
4433 /* Show any issues associated with this frame number */
4440 /* TODO: could add previous/next frames (in seqId tree?) ? */
4441 }
4443 /* payloadVersion */
4446 /* filterIndex */
4448 /* scs (for ST4 and ST8) */
4449 scs_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_frameStructure_subcarrier_spacing, tvb, offset, 1, ENC_NA, &scs);
4450 }
4452 /* reserved (4 bits) */
4454 }
4456 /* filterIndex (most common case) */
4458 }
4462 /* frameId */
4464 proto_tree_add_item_ret_uint(section_tree, hf_oran_frame_id, tvb, offset, 1, ENC_NA, &frameId);
4467 /* subframeId */
4469 proto_tree_add_item_ret_uint(section_tree, hf_oran_subframe_id, tvb, offset, 1, ENC_NA, &subframeId);
4470 /* slotId */
4472 proto_tree_add_item_ret_uint(section_tree, hf_oran_slot_id, tvb, offset, 2, ENC_BIG_ENDIAN, &slotId);
4474 offset++;
4476 /* startSymbolId */
4481 /* symbolId */
4483 }
4485 /* startSymbolId is in most section types */
4486 ssid_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_start_symbol_id, tvb, offset, 1, ENC_NA, &startSymbolId);
4491 }
4492 }
4494 /* reserved (6 bits) */
4496 }
4497 offset++;
4507 /* numberOfSections (or whatever section has instead) */
4510 /* Slot Control has these fields instead */
4511 /* reserved (4 bits) */
4513 /* cmdScope (4 bits) */
4514 proto_tree_add_item_ret_uint(section_tree, hf_oran_cmd_scope, tvb, offset, 1, ENC_NA, &cmd_scope);
4515 }
4517 /* reserved (7 bits) */
4519 /* ready (1 bit) */
4520 /* TODO: when set, ready in slotId+1.. */
4521 proto_tree_add_item_ret_boolean(section_tree, hf_oran_ready, tvb, offset, 1, ENC_NA, &st8_ready);
4523 /* SCS value is ignored, and may be set to any value by O-RU */
4525 }
4526 }
4528 proto_tree_add_item_ret_uint(section_tree, hf_oran_numberOfSections, tvb, offset, 1, ENC_NA, &nSections);
4529 }
4532 }
4533 offset++;
4535 /* sectionType */
4536 proto_tree_add_item_ret_uint(section_tree, hf_oran_sectionType, tvb, offset, 1, ENC_NA, §ionType);
4539 /* Note this section type in stats */
4542 }
4544 /* Section-specific fields (white entries in Section Type diagrams) */
4558 /* timeOffset */
4561 /* frameStructure */
4565 /* cpLength */
4568 /* reserved */
4575 /* udCompHdr */
4579 /* reserved */
4588 /* timeOffset */
4591 /* frameStructure */
4594 /* cpLength */
4597 /* udCompHdr */
4604 /* numberOfUEs */
4605 proto_tree_add_item_ret_uint(section_tree, hf_oran_numberOfUEs, tvb, offset, 1, ENC_NA, &num_ues);
4607 /* ciCompHdr (was reserved) */
4608 offset = dissect_cicomphdr(tvb, pinfo, section_tree, offset, &bit_width, &ci_comp_method, &ci_comp_opt);
4610 /* Number of sections may not be filled in (at all, or correctly), so set to the number of UEs.
4611 The data entries are per-UE... they don't have a sectionID, but they could have section extensions... */
4614 }
4626 /* numberOfAcks (1 byte) */
4627 proto_tree_add_item_ret_uint(section_tree, hf_oran_number_of_acks, tvb, offset, 1, ENC_BIG_ENDIAN, &number_of_acks);
4629 /* numberOfNacks (1 byte) */
4630 proto_tree_add_item_ret_uint(section_tree, hf_oran_number_of_nacks, tvb, offset, 1, ENC_BIG_ENDIAN, &number_of_nacks);
4633 /* Show ACKs and NACKs. For both, try to link back to request. */
4637 ack_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_ackid, tvb, offset, 2, ENC_BIG_ENDIAN, &ackid);
4640 /* Look up request table in state (which really should be set by now, but test anyway). */
4644 /* On first pass, update with this response */
4648 }
4650 /* Show request details */
4652 }
4654 /* Request not found */
4657 ackid);
4658 }
4659 }
4660 }
4663 proto_item *nack_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_nackid, tvb, offset, 2, ENC_BIG_ENDIAN, &nackid);
4668 nackid);
4670 /* Look up request table in state. */
4674 /* On first pass, update with this response */
4678 }
4680 /* Show request details */
4682 }
4684 /* Request not found */
4687 nackid);
4688 }
4689 }
4690 }
4694 {
4695 /* numSinrPerPrb (3 bits) */
4697 nspp_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_num_sinr_per_prb, tvb, offset, 1, ENC_BIG_ENDIAN, &num_sinr_per_prb);
4715 /* TODO: expert info? */
4716 }
4718 /* reserved (13 bits) */
4719 proto_tree_add_item(section_tree, hf_oran_reserved_last_5bits, tvb, offset, 1, ENC_BIG_ENDIAN);
4724 }
4728 /* reserved (16 bits) */
4732 };
4734 /* Update udCompHdr details in state for UL U-Plane */
4746 }
4747 }
4750 proto_item_append_text(sectionHeading, "%d, %s, Frame: %d, Subframe: %d, Slot: %d, StartSymbol: %d",
4756 /* Set actual length of C-Plane section header */
4762 }
4765 /* Section type 4 doesn't have normal sections, so deal with here before normal sections */
4767 /* numberOfST4Cmds */
4774 }
4777 /* reserved (1 byte) */
4781 /* Loop over commands. Each has 8-byte common header, followed by cmd-specific payload */
4784 /* Table 7.4.6-2: Section Type 4 Command common header format */
4790 /* st4CmdType */
4791 proto_tree_add_item_ret_uint(hdr_tree, hf_oran_st4_cmd_type, tvb, offset, 1, ENC_NA, &st4_cmd_type);
4794 /* st4CmdLen */
4795 len_ti = proto_tree_add_item_ret_uint(hdr_tree, hf_oran_st4_cmd_len, tvb, offset, 2, ENC_NA, &st4_cmd_len);
4797 /* Meaning of 0 not yet defined (v15.00) */
4800 }
4803 }
4806 /* numSlots */
4807 proto_item *slots_ti = proto_tree_add_item_ret_uint(hdr_tree, hf_oran_st4_cmd_num_slots, tvb, offset, 1, ENC_NA, &num_slots);
4810 }
4813 /* ackNackReqId */
4815 ack_nack_req_id_ti = proto_tree_add_item_ret_uint(hdr_tree, hf_oran_st4_cmd_ack_nack_req_id, tvb, offset, 2, ENC_NA, &ack_nack_req_id);
4819 }
4821 /* reserved (16 bits) */
4825 /* Set common header summary */
4834 /* Subtree for this command body */
4842 /* Check fields compatible with chosen command. */
4845 /* "the value of numSlots should be set to zero for this command type" */
4848 num_slots);
4849 }
4850 }
4854 /* "expected reception window for the commands is the symbol zero reception window" */
4857 startSymbolId);
4858 }
4859 }
4861 /* Add format for this command */
4864 {
4868 /* reserved (2 bits) */
4870 /* symbolMask (14 bits) */
4872 proto_item *symbol_mask_ti = proto_tree_add_item_ret_uint(command_tree, hf_oran_symbolMask, tvb, offset, 2, ENC_BIG_ENDIAN, &symbol_mask);
4873 /* Symbol bits before 'startSymbolId' in Section Type 4 common header should be set to 0 by O-DU and shall be ignored by O-RU */
4874 /* lsb is symbol 0 */
4877 proto_item_append_text(symbol_mask_ti, " (startSymbolId is %u, so some lower symbol bits ignored!)", startSymbolId);
4878 /* TODO: expert info too? */
4880 }
4881 }
4884 /* disableTDBFNs */
4885 proto_tree_add_item_ret_boolean(command_tree, hf_oran_disable_tdbfns, tvb, offset, 1, ENC_BIG_ENDIAN, &disable_tdbfns);
4887 /* tdBeamNum */
4891 /* bfwCompHdr (2 subheaders - bfwIqWidth and bfwCompMeth)*/
4894 /* reserved (3 bytes) */
4899 /* No beamnum information to show so get out. */
4901 }
4903 /* Read beam entries until reach end of command length */
4906 /* disableTDBFWs */
4908 proto_tree_add_item_ret_boolean(command_tree, hf_oran_disable_tdbfws, tvb, offset, 1, ENC_BIG_ENDIAN, &disable_tdbfws);
4910 /* tdBeamNum */
4914 /* Showing BFWs? */
4917 /* bfwCompParam */
4923 /* Antenna count from preference */
4928 /* Create antenna subtree */
4934 /* I value */
4935 /* Get bits, and convert to float. */
4938 /* Add to tree. */
4944 /* Leave a gap between I and Q values */
4947 /* Q value */
4948 /* Get bits, and convert to float. */
4951 /* Add to tree. */
4959 }
4960 /* Need to round to next byte */
4962 }
4963 }
4965 }
4967 /* reserved (2 bits) */
4969 /* dirPattern (14 bits) */
4973 /* reserved (2 bits) */
4975 /* guardPattern (14 bits) */
4981 {
4982 /* Only allowed cmdScope is ARRAY-COMMAND */
4985 }
4987 /* reserved (1 bit) */
4989 /* log2MaskBits (4 bits) */
4991 proto_tree_add_item_ret_uint(command_tree, hf_oran_log2maskbits, tvb, offset, 1, ENC_BIG_ENDIAN, &log2maskbits);
4992 /* sleepMode */
4994 proto_tree_add_item_ret_uint(command_tree, hf_oran_sleepmode_trx, tvb, offset, 1, ENC_BIG_ENDIAN, &sleep_mode);
4997 /* reserved (4 bits) */
4999 /* numSlotsExt (20 bits) */
5001 proto_item *num_slots_ext_ti = proto_tree_add_item_ret_uint(command_tree, hf_oran_num_slots_ext, tvb, offset, 3, ENC_BIG_ENDIAN, &num_slots_ext);
5004 }
5006 /* Time should be rounded up according to SCS */
5008 /* From table 7.5.2.13-3 */
5013 /* Only using valid SCS. TODO: is this test ok? */
5015 /* Round up to next slot */
5018 }
5019 }
5022 /* reserved (2 bits) */
5025 /* symbolMask (14 bits) */
5028 sm_ti = proto_tree_add_item_ret_uint(command_tree, hf_oran_symbolMask, tvb, offset, 2, ENC_BIG_ENDIAN, &symbol_mask);
5032 }
5036 }
5041 }
5044 /* antMask (16-2048 bits). Size is lookup from log2MaskBits enum.. */
5048 }
5049 proto_item *ant_mask_ti = proto_tree_add_item(command_tree, hf_oran_antMask_trx_control, tvb, offset, antmask_length, ENC_NA);
5050 /* show count */
5056 antenna_count++;
5057 }
5058 }
5059 }
5063 /* Pad to next 4-byte boundary */
5066 }
5068 }
5071 /* reserved (2+4=6 bits) */
5073 /* sleepMode (2 bits) */
5075 proto_tree_add_item_ret_uint(command_tree, hf_oran_sleepmode_asm, tvb, offset, 1, ENC_BIG_ENDIAN, &sleep_mode);
5078 /* reserved (4 bits) */
5080 /* numSlotsExt (20 bits) */
5084 /* reserved (2 bits) */
5086 /* symbolMask (14 bits) */
5089 sm_ti = proto_tree_add_item_ret_uint(command_tree, hf_oran_symbolMask, tvb, offset, 2, ENC_BIG_ENDIAN, &symbol_mask);
5093 }
5097 }
5102 }
5105 /* reserved (2 bytes) */
5111 /* Error! */
5114 st4_cmd_type);
5116 }
5118 /* Check apparent size of padding (0-3 bytes ok) */
5122 "Dissected ST4 command does not match signalled st4CmdLen - set to %u (%u bytes) but dissected %u bytes",
5124 }
5126 /* Advance by signalled length (needs to be aligned on 4-byte boundary) */
5129 /* Set end of command tree */
5134 /* Add this request into conversation state on first pass */
5141 ack_nack_req_id,
5142 request_details);
5143 }
5145 /* On later passes, try to link forward to ST8 response */
5147 ack_nack_req_id);
5150 }
5151 }
5152 }
5153 }
5154 }
5155 /* LAA doesn't have sections either.. */
5157 /* 7.2.5 Table 6.4-6 */
5161 /* laaMsgType */
5164 laa_msg_type_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_laaMsgType, tvb, offset, 1, ENC_NA, &laa_msg_type);
5165 /* laaMsgLen */
5167 proto_item *len_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_laaMsgLen, tvb, offset, 1, ENC_NA, &laa_msg_len);
5171 }
5176 /* Payload */
5179 /* LBT_PDSCH_REQ */
5180 /* lbtHandle (16 bits) */
5183 /* lbtOffset (10 bits) */
5186 /* lbtMode (2 bits) */
5188 /* reserved (1 bit) */
5190 /* lbtDeferFactor (3 bits) */
5193 /* lbtBackoffCounter (10 bits) */
5196 /* MCOT (4 bits) */
5197 mcot_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_MCOT, tvb, offset, 1, ENC_BIG_ENDIAN, &mcot);
5203 }
5204 /* reserved (10 bits) */
5205 proto_tree_add_bits_item(section_tree, hf_oran_reserved, tvb, (offset*8)+6, 10, ENC_BIG_ENDIAN);
5208 /* LBT_DRS_REQ */
5209 /* lbtHandle (16 bits) */
5212 /* lbtOffset (10 bits) */
5215 /* lbtMode (2 bits) */
5217 /* reserved (28 bits) */
5218 proto_tree_add_bits_item(section_tree, hf_oran_reserved, tvb, (offset*8)+4, 28, ENC_BIG_ENDIAN);
5221 /* LBT_PDSCH_RSP */
5222 /* lbtHandle (16 bits) */
5225 /* lbtPdschRes (2 bits) */
5227 /* inParSF (1 bit) */
5229 /* sfStatus (1 bit) */
5231 /* sfnSf (12 bits) */
5234 /* reserved (24 bits) */
5238 /* LBT_DRS_RSP */
5239 /* lbtHandle (16 bits) */
5242 /* lbtDrsRes (1 bit) */
5244 /* reserved (7 bits) */
5245 proto_tree_add_item(section_tree, hf_oran_reserved_last_7bits, tvb, offset, 1, ENC_BIG_ENDIAN);
5248 /* LBT_Buffer_Error */
5249 /* lbtHandle (16 bits) */
5252 /* lbtBufErr (1 bit) */
5254 /* reserved (7 bits) */
5255 proto_tree_add_item(section_tree, hf_oran_reserved_last_7bits, tvb, offset, 1, ENC_BIG_ENDIAN);
5258 /* LBT_CWCONFIG_REQ */
5259 /* lbtHandle (16 bits) */
5262 /* lbtCWConfig_H (8 bits) */
5265 /* lbtCWConfig_T (8 bits) */
5268 /* lbtMode (2 bits) */
5270 /* lbtTrafficClass (3 bits) */
5272 /* reserved (19 bits) */
5273 proto_tree_add_bits_item(section_tree, hf_oran_reserved, tvb, (offset*8)+5, 19, ENC_BIG_ENDIAN);
5276 /* LBT_CWCONFIG_RSP */
5277 /* lbtHandle (16 bits) */
5280 /* lbtCWR_Rst (1 bit) */
5282 /* reserved (7 bits) */
5283 proto_tree_add_item(section_tree, hf_oran_reserved_last_7bits, tvb, offset, 1, ENC_BIG_ENDIAN);
5287 /* Unhandled! */
5290 laa_msg_type);
5293 }
5294 /* For now just skip indicated length of bytes */
5296 }
5299 /* Dissect each C section */
5303 protocol_item,
5306 num_sinr_per_prb);
5307 }
5309 /* Expert error if we are short of tvb by > 3 bytes */
5314 }
5317 }
5324 {
5325 /* I */
5329 proto_item *i_ti = proto_tree_add_float(tree, hf_oran_iSample, tvb, samples_offset/8, sample_len_in_bytes, i_value);
5330 proto_item_set_text(i_ti, "iSample: % 0.7f 0x%04x (RE-%2u in the PRB)", i_value, i_bits, sample_number);
5332 /* Q */
5336 proto_item *q_ti = proto_tree_add_float(tree, hf_oran_qSample, tvb, samples_offset/8, sample_len_in_bytes, q_value);
5337 proto_item_set_text(q_ti, "qSample: % 0.7f 0x%04x (RE-%2u in the PRB)", q_value, q_bits, sample_number);
5341 }
5345 {
5347 /* All sections will start the same way */
5350 /* Move offset back to the start of the section */
5354 /* This field appears several bytes into the U-plane section */
5356 /* Are there enough bytes to still read the length field? */
5361 }
5363 /* Read the length field */
5366 /* Is this less than a valid section? Realistic minimal section will be bigger than this..
5367 * Could take into account numPrbU, etc */
5372 }
5374 /* Does this section fit into the frame? */
5379 }
5381 /* Move past this section */
5384 /* Are we at the end of the frame? */
5385 /* TODO: if frame is less than 60 bytes, there may be > 4 bytes, likely zeros.. */
5389 }
5391 }
5393 }
5396 {
5399 }
5403 /* - iq width could be anything, though unlikely to be signalled as (say) < 1-3? */
5404 /* - meth should be 0-8 */
5405 /* - reserved byte should be 0 */
5406 return (((first_byte & 0x0f) <= MOD_COMPR_AND_SELECTIVE_RE_WITH_MASKS) && (reserved_byte == 0));
5407 }
5409 static bool udcomphdr_appears_present(flow_state_t *flow, uint32_t direction, tvbuff_t *tvb, int offset)
5410 {
5411 /* Should really not happen, but guard against this anyway. */
5413 /* No state to update. */
5415 }
5419 /* Return cached value */
5421 }
5423 /* Work it out, and save answer for next time */
5427 }
5428 }
5430 /* Downlink */
5432 /* Return cached value */
5434 }
5436 /* Work it out, and save answer for next time */
5440 }
5441 }
5442 }
5444 /* User plane dissector (section 8) */
5445 static int
5448 {
5449 /* Hidden filter for plane */
5453 /* Set up structures needed to add the protocol subtree and manage it */
5461 /* Create display subtree for the protocol */
5466 /* Transport header */
5467 /* Real-time control data / IQ data transfer message series identifier */
5472 /* Message identifier */
5477 /* Common header for time reference */
5482 /* dataDirection */
5484 proto_tree_add_item_ret_uint(timing_header_tree, hf_oran_data_direction, tvb, offset, 1, ENC_NA, &direction);
5486 /* payloadVersion */
5488 /* filterIndex */
5494 /* frameId */
5496 proto_tree_add_item_ret_uint(timing_header_tree, hf_oran_frame_id, tvb, offset, 1, ENC_NA, &frameId);
5499 /* subframeId */
5501 proto_tree_add_item_ret_uint(timing_header_tree, hf_oran_subframe_id, tvb, offset, 1, ENC_NA, &subframeId);
5502 /* slotId */
5504 proto_tree_add_item_ret_uint(timing_header_tree, hf_oran_slot_id, tvb, offset, 2, ENC_BIG_ENDIAN, &slotId);
5506 offset++;
5507 /* symbolId */
5509 proto_tree_add_item_ret_uint(timing_header_tree, hf_oran_symbolId, tvb, offset, 1, ENC_NA, &symbolId);
5510 offset++;
5514 proto_item *pi = proto_tree_add_string(timing_header_tree, hf_oran_refa, tvb, ref_a_offset, 3, id);
5518 val_to_str_const(direction, data_direction_vals, "Unknown"), frameId, subframeId, slotId, symbolId);
5524 /* Update/report status of conversation */
5529 /* Create conversation if doesn't exist yet */
5531 /* Allocate new state */
5535 }
5537 /* Check sequence analysis status */
5538 if (state->last_frame_seen[direction] && (seq_id != state->next_expected_sequence_number[direction])) {
5539 /* Store this result */
5545 }
5546 /* Update sequence analysis state */
5550 }
5552 /* Show any issues associated with this frame number */
5560 /* TODO: could add previous/next frame (in seqId tree?) ? */
5561 }
5562 }
5564 /* Look up preferences for samples */
5573 }
5575 /* If uplink, load any udCompHdr settings written by C-Plane */
5578 /* Initialise settings from udpCompHdr from C-Plane */
5584 }
5585 }
5587 /* Need a valid value (e.g. 9, 14). 0 definitely won't work, as won't progress around loop! */
5588 /* N.B. may yet be overwritten by udCompHdr settings in sections below! */
5594 sample_bit_width);
5596 }
5602 /* Add each section (no count, just keep parsing until payload used) */
5604 /* Section subtree */
5610 /* Section Header fields (darker green part) */
5612 /* sectionId */
5614 proto_item *ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_section_id, tvb, offset, 2, ENC_BIG_ENDIAN, §ionId);
5617 }
5618 offset++;
5619 /* rb */
5622 /* symInc */
5624 /* startPrbu */
5626 proto_tree_add_item_ret_uint(section_tree, hf_oran_startPrbu, tvb, offset, 2, ENC_BIG_ENDIAN, &startPrbu);
5629 /* numPrbu */
5637 /* udCompHdr (if preferences indicate will be present) */
5641 /* 7.5.2.10 */
5642 /* Extract these values to inform how wide IQ samples in each PRB will be. */
5646 /* Not part of udCompHdr */
5649 }
5651 /* No fields to dissect - just showing comp values from prefs */
5652 /* iqWidth */
5653 proto_item *iq_width_item = proto_tree_add_uint(section_tree, hf_oran_udCompHdrIqWidth_pref, tvb, 0, 0, sample_bit_width);
5654 proto_item_append_text(iq_width_item, (ud_cmp_hdr_cplane) ? " (from c-plane)" : " (from preferences)");
5657 /* udCompMethod */
5658 ud_comp_meth_item = proto_tree_add_uint(section_tree, hf_oran_udCompHdrMeth_pref, tvb, 0, 0, compression);
5659 proto_item_append_text(ud_comp_meth_item, (ud_cmp_hdr_cplane) ? " (from c-plane)" : " (from preferences)");
5661 }
5663 /* Not supported! TODO: other places where comp method is looked up (e.g., bfw?) */
5672 compression,
5674 }
5676 /* udCompLen (when supported, methods 5,6,7,8) */
5682 ud_comp_len_ti = proto_tree_add_item_ret_uint(section_tree, hf_oran_udCompLen, tvb, offset, 2, ENC_NA, &ud_comp_len);
5685 }
5686 /* TODO: report if less than a viable section in frame? */
5687 /* Check that there is this much length left in the frame */
5692 }
5693 /* Actual length of section will be checked below, at the end of the section */
5695 }
5696 }
5698 /* sReSMask1 + sReSMask2 (depends upon compression method) */
5702 {
5716 NULL
5717 };
5719 /* reserved (4 bits) */
5721 /* sReSMask1 (12 bits) */
5724 hf_oran_sReSMask1,
5725 ett_oran_sresmask,
5726 sres_mask1_2_flags,
5727 ENC_NA,
5730 /* Count REs present */
5734 res++;
5735 }
5736 }
5740 /* reserved (4 bits) */
5742 /* sReSMask2 (12 bits) */
5744 hf_oran_sReSMask2,
5745 ett_oran_sresmask,
5746 sres_mask1_2_flags,
5747 ENC_NA,
5755 }
5756 }
5758 /* Count REs present */
5762 res++;
5763 }
5764 }
5766 }
5767 }
5771 /* TODO: should this use the same pref as c-plane? */
5773 /* Special case for all PRBs (NR: the total number of PRBs may be > 255) */
5776 }
5778 /* Add each PRB */
5780 /* Create subtree */
5788 /* udCompParam (depends upon compression method) */
5790 offset = dissect_udcompparam(tvb, pinfo, rb_tree, offset, compression, &exponent, &sresmask, false);
5793 /* Show PRB number in root */
5796 /* Work out how many REs / PRB */
5801 /* Work out which mask should be used */
5803 /* Selective RE cases, use value from compModParam */
5805 }
5807 /* With masks (in section). Choose between sresmask1 and sresmask2 */
5809 /* Even values */
5811 }
5813 /* Odd values */
5815 }
5816 }
5818 /* Count REs present using sresmask */
5820 /* Use sresmask to pick out which REs are present */
5823 res_per_prb++;
5824 }
5825 }
5826 }
5828 /* N.B. bytes for samples need to be padded out to next byte
5829 (certainly where there aren't 12 REs in PRB..) */
5835 /* Optionally trying to show I/Q RE values */
5837 /* Individual values */
5842 /* Use sresmask to pick out which REs are present */
5847 samples++;
5848 }
5849 }
5850 }
5852 /* All 12 REs are present */
5856 samples++;
5857 }
5858 }
5860 }
5862 /* Advance past samples */
5865 /* Set end of prb subtree */
5867 }
5869 /* Set extent of section */
5875 }
5878 number_of_sections++;
5881 /* Show number of sections found */
5882 proto_item *ti = proto_tree_add_uint(oran_tree, hf_oran_numberOfSections, tvb, 0, 0, number_of_sections);
5885 /* Expert error if we are short of tvb by > 3 bytes */
5890 }
5893 }
5896 /**********************************************************************/
5897 /* Main dissection function. */
5898 /* N.B. ecpri message type passed in as 'data' arg by eCPRI dissector */
5899 static int
5901 {
5905 /* Allocate and zero tap struct */
5916 /* Not dissecting other types - assume these are handled by eCPRI dissector */
5918 }
5923 }
5926 {
5929 }
5932 /* Register the protocol with Wireshark. */
5933 void
5935 {
5938 /* Section 5.1.3.2.7 */
5944 },
5946 /* Section 5.1.3.2.7 */
5952 },
5954 /* Section 5.1.3.2.7 */
5960 },
5962 /* Section 5.1.3.2.7 */
5968 },
5970 /* Section 5.1.3.2.8 */
5976 },
5978 /* Section 5.1.3.2.8 */
5984 },
5986 /* Section 5.1.3.2.8 */
5992 },
5994 /* Section 7.5.2.1 */
6000 },
6002 /* Section 7.5.2.2 */
6008 },
6010 /* Section 7.5.2.3 */
6016 },
6018 /* Section 7.5.2.4 */
6024 },
6026 /* Section 7.5.2.5 */
6032 },
6034 /* Section 7.5.2.6 */
6040 },
6042 /* Generated for convenience */
6048 },
6050 /* Section 7.5.2.7 */
6056 },
6058 /* Section 7.5.2.8 */
6064 },
6066 /* Section 7.5.2.9 */
6072 },
6074 /* Section 7.5.2.10 */
6080 },
6082 /* Section 7.5.2.11 */
6088 },
6090 /* Section 7.5.2.12 */
6096 },
6098 /* Section 7.5.2.13 */
6104 },
6106 /* Section 7.5.2.13 */
6112 HFILL }
6113 },
6115 /* Section 7.5.2.14 */
6121 },
6128 },
6130 /* Section 7.5.3.1 */
6136 },
6138 /* Section 7.5.3.2 */
6144 },
6146 /* Section 7.5.5.3 */
6152 },
6154 /* Section 7.5.3.4 */
6160 },
6162 /* Section 7.5.3.5 */
6168 },
6174 },
6180 },
6186 },
6192 },
6198 },
6204 },
6210 },
6216 },
6222 },
6228 },
6234 },
6240 },
6242 /* Section 7.5.3.6 */
6248 },
6250 /* Section 7.5.3.7 */
6256 },
6258 /* Section 7.5.3.8 */
6264 },
6266 /* Section 7.5.3.9 */
6272 },
6279 },
6281 /* Section 7.6.2.1 */
6286 "The extension type, which provides additional parameters specific to subject data extension", HFILL}
6287 },
6289 /* Section 7.6.2.3 */
6295 },
6297 /* Section 7.7.1 */
6303 },
6309 },
6315 },
6316 /* Section 7.7.1.4 */
6322 },
6323 /* Section 7.7.1.5 */
6329 },
6331 /* Section 7.5.3.10 */
6337 },
6339 /* Section 7.5.3.11 */
6345 },
6347 /* Section 7.5.3.12 */
6353 },
6355 /* Section 7.5.3.14 */
6361 },
6363 /* Section 7.5.3.15 */
6369 },
6371 /* Section 7.5.3.16 */
6377 },
6379 /* Section 7.5.3.17 */
6385 },
6387 /* Section 7.5.3.18 */
6393 },
6395 /* Section 7.5.3.19 */
6400 "LBT start time in microseconds from the beginning of the subframe scheduled by this message", HFILL}
6401 },
6403 /* Section 7.5.3.20 */
6409 },
6411 /* Section 7.5.3.21 */
6417 },
6419 /* Section 7.5.3.22 */
6425 },
6427 /* Section 7.5.3.23 */
6433 },
6435 /* Section 7.5.3.22 */
6441 },
6443 /* Section 7.5.3.25 */
6449 },
6451 /* Section 7.5.3.26. */
6457 },
6459 /* Section 7.5.3.27 */
6465 },
6467 /* Section 7.5.3.28 */
6473 },
6475 /* Section 7.5.3.29 */
6481 },
6483 /* Section 7.5.3.30 */
6489 },
6491 /* Section 7.5.3.31 */
6497 },
6499 /* Reserved fields */
6505 },
6512 },
6518 },
6524 },
6530 },
6536 },
6542 },
6548 },
6554 },
6560 },
6566 },
6572 },
6578 },
6584 },
6590 },
6596 },
6602 },
6608 },
6614 },
6617 /* 7.7.11.10 */
6623 },
6624 /* 7.7.11.9 */
6630 },
6632 /* 7.7.1.2 bfwCompHdr (beamforming weight compression header) */
6638 },
6644 },
6650 },
6652 /* 7.5.3.32 */
6658 },
6660 /* Table 7.5.3.32-1 */
6666 },
6672 },
6678 },
6680 /* Section 7.7.6.6 */
6686 },
6687 /* 7.7.20.9 */
6693 },
6694 /* 7.7.20.10 */
6700 },
6701 /* 7.7.6.5 */
6707 },
6708 /* 7.7.6.4 */
6714 },
6716 /* 7.7.22.2 */
6722 },
6724 /* Subtree for next 2 items */
6730 },
6732 /* 7.7.12.4 */
6738 },
6739 /* 7.7.12.5 */
6745 },
6747 /* symbolId 8.3.3.7 */
6753 },
6755 /* startPrbu 8.3.3.11 */
6761 },
6763 /* numPrbu 8.3.3.12 */
6769 },
6771 /* 7.7.1.3 */
6777 },
6779 /* 6.3.3.13 */
6784 "Defines the compression method for the user data in every section in the C-Plane message", HFILL}
6785 },
6790 "Defines the compression method for the user data in every section in the C-Plane message", HFILL}
6791 },
6792 /* 8.3.3.18 */
6798 },
6800 /* 6.3.3.13 */
6806 },
6812 },
6814 /* Section 8.3.3.15 (not always present - depends upon meth) */
6819 "Applies to whatever compression method is specified by the associated sectionID's compMeth value", HFILL}
6820 },
6821 /* 8.3.3.18 */
6827 },
6834 },
6840 },
6846 },
6852 },
6858 },
6864 },
6870 },
6876 },
6882 },
6888 },
6894 },
6900 },
6902 /* 8.3.3.20 */
6908 },
6909 /* 8.3.3.21 */
6915 },
6922 },
6928 },
6934 },
6940 },
6942 /* Section 6.3.3.15 */
6948 },
6950 /* Section 6.3.3.16 */
6956 },
6963 },
6970 },
6977 },
6984 },
6987 /* Section 7.5.2.15 */
6993 },
6998 "Defines the compression method for the user data in every section in the C-Plane message", HFILL}
6999 },
7005 },
7011 },
7013 /* 7.7.11.7 */
7019 },
7020 /* 7.7.11.8 */
7026 },
7027 /* 7.7.11.4 */
7033 },
7039 },
7045 },
7052 },
7054 /* 7.5.3.13 */
7060 },
7066 },
7072 },
7074 /* 7.7.10.2 */
7080 },
7081 /* 7.7.10.3 */
7087 },
7089 /* 7.7.4.2 (1 bit) */
7095 },
7096 /* 7.7.4.3 */
7102 },
7104 /* 7.7.5.1 */
7110 },
7112 /* mcScaleReMask 7.7.5.2 (12 bits) */
7118 },
7119 /* mcScaleOffset 7.7.5.4 (15 bits) */
7125 },
7126 /* eAxCmask (7.7.7.2) */
7132 },
7133 /* technology (interface name) 7.7.9.2 */
7139 },
7140 /* Exttype 14 (7.7.14.2) */
7146 },
7148 /* Exttype 19 (7.7.19.8) */
7154 },
7155 /* 7.7.19.9 */
7161 },
7168 },
7170 /* Ext 13 */
7176 },
7177 /* 7.7.13.2 */
7183 },
7184 /* 7.7.13.3 */
7190 },
7192 /* Puncturing patters as appears in SE 20 */
7198 },
7200 /* 7.7.20.2 numPuncPatterns */
7206 },
7207 /* 7.7.20.3 symbolMask */
7213 },
7214 /* 7.7.20.4 startPuncPrb */
7220 },
7221 /* 7.7.20.5 numPuncPrb */
7227 },
7228 /* 7.7.20.6 puncReMask */
7234 },
7235 /* 7.7.20.12 multiSDScope */
7241 },
7242 /* 7.7.20.4 rbgIncl */
7248 },
7250 /* 7.7.21.2 ciPrbGroupSize */
7256 },
7257 /* 7.21.3 */
7263 },
7269 },
7271 /* 7.7.17.2 numUeID */
7277 },
7279 /* 7.7.16.2 antMask */
7285 },
7287 /* 7.7.18.2 transmissionWindowOffset */
7292 "start of the transmission window as an offset to when the transmission window would have been without this parameter, i.e. (Ta3_max - Ta3_min)", HFILL}
7293 },
7294 /* 7.7.18.3 transmissionWindowSize */
7300 },
7301 /* 7.7.18.4 toT */
7307 },
7309 /* 7.7.2.2 bfaCompHdr */
7315 },
7316 /* 7.7.2.2-2: bfAzPtWidth */
7322 },
7323 /* 7.7.2.2-3: bfZePtWidth */
7329 },
7330 /* 7.7.2.2-4: bfAz3ddWidth */
7336 },
7337 /* 7.7.2.2-5: bfZe3ddWidth */
7343 },
7345 /* 7.7.2.3 bfAzPt */
7351 },
7352 /* 7.7.2.4 bfZePt */
7358 },
7359 /* 7.7.2.5 bfAz3dd */
7365 },
7366 /* 7.7.2.6 bfZe3dd */
7372 },
7374 /* 7.7.2.7 bfAzSl */
7380 },
7381 /* 7.7.2.8 bfZeSl */
7387 },
7389 /* 7.5.2.17 */
7395 },
7396 /* 7.5.2.18 */
7402 },
7409 },
7411 /* 7.5.3.38 */
7417 },
7418 /* 7.5.3.39 */
7424 },
7425 /* 7.5.3.40 */
7431 },
7432 /* 7.5.3.41 */
7438 },
7445 },
7447 /* 7.5.3.52 */
7453 },
7459 },
7461 /* 7.5.3.51 */
7467 },
7468 /* 7.5.3.53 */
7474 },
7475 /* 7.5.3.54 */
7481 },
7482 /* 7.5.3.55 */
7488 },
7489 /* 7.5.3.34 */
7495 },
7496 /* 7.5.3.35 */
7502 },
7503 /* 7.5.3.36 */
7509 },
7510 /* 7.5.3.37 */
7516 },
7518 /* Links between acknack requests & responses */
7524 },
7530 },
7536 },
7542 },
7548 },
7550 /* 7.5.3.43 */
7556 },
7558 /* 7.5.3.44 */
7564 },
7565 /* 7.5.3.43 */
7571 },
7573 /* 7.5.3.56 */
7579 },
7581 /* 7.5.3.49 */
7587 },
7588 /* 7.5.3.50 */
7594 },
7596 /* For convenient filtering */
7602 },
7608 },
7614 },
7617 /* 5.1.3.2.7 */
7623 },
7629 },
7630 /* 5.1.3.2.8 */
7636 },
7638 /* 7.7.23.2 */
7644 },
7645 /* 7.7.23.11 */
7651 },
7658 },
7660 /* 7.7.23.3 */
7666 },
7667 /* 7.7.23.5 */
7673 HFILL}
7674 },
7675 /* 7.7.23.4 */
7681 },
7683 /* 7.7.3.2 */
7689 },
7690 /* 7.7.3.3 */
7696 },
7697 /* 7.7.3.5 */
7703 },
7704 /* 7.7.3.4 */
7710 },
7711 /* 7.7.3.6 */
7717 },
7718 /* 7.7.3.8 */
7724 },
7725 /* 7.7.3.7 */
7731 },
7732 /* 7.7.3.9 */
7738 },
7739 /* 7.7.3.10 */
7745 },
7746 /* 7.7.3.11 */
7752 },
7754 /* 7.7.10.3a */
7760 },
7767 },
7773 },
7775 /* 7.7.24.6 */
7781 },
7782 /* 7.7.24.7 */
7788 },
7789 /* 7.7.24.8 */
7795 },
7796 /* 7.7.24.9 */
7802 },
7803 /* 7.7.24.10 */
7809 },
7810 /* 7.7.24.11 */
7816 },
7817 /* 7.7.24.12 */
7823 },
7824 /* 7.7.24.13 */
7830 },
7831 /* 7.7.24.14 */
7837 },
7838 /* 7.7.24.15 */
7844 },
7845 /* 7.7.24.16 */
7851 },
7852 /* 7.7.24.19 */
7858 },
7859 /* 7.7.24.20 */
7865 },
7867 /* 7.7.24.17 */
7868 /* TODO: add value_string */
7874 },
7875 /* 7.7.24.18 */
7881 },
7888 },
7894 },
7895 /* 7.7.26.2 */
7901 },
7902 /* 7.7.26.3 */
7908 },
7910 /* 7.5.2.19 */
7916 },
7918 /* 7.5.3.68 */
7924 },
7931 },
7932 /* 7.5.3.57 */
7938 },
7939 /* 7.5.3.59 */
7945 },
7947 /* 7.5.3.58 */
7953 },
7954 /* 7.5.3.66 */
7960 },
7961 /* 7.5.3.60 */
7967 },
7968 /* 7.5.3.61 */
7974 },
7976 /* 7.5.3.62 */
7982 },
7983 /* 7.5.3.63 */
7989 },
7990 /* 7.5.3.64 */
7996 },
7998 /* 7.5.27.2 */
8003 NULL,
8004 HFILL}
8005 },
8006 /* 7.5.3.65 */
8012 HFILL}
8013 },
8020 },
8026 },
8033 },
8039 },
8045 }
8046 };
8048 /* Setup protocol subtree array */
8085 &ett_oran_dmrs_entry
8086 };
8091 }
8096 { &ei_oran_unsupported_bfw_compression_method, { "oran_fh_cus.unsupported_bfw_compression_method", PI_UNDECODED, PI_WARN, "Unsupported BFW Compression Method", EXPFILL }},
8097 { &ei_oran_invalid_sample_bit_width, { "oran_fh_cus.invalid_sample_bit_width", PI_UNDECODED, PI_ERROR, "Unsupported sample bit width", EXPFILL }},
8098 { &ei_oran_reserved_numBundPrb, { "oran_fh_cus.reserved_numBundPrb", PI_MALFORMED, PI_ERROR, "Reserved value of numBundPrb", EXPFILL }},
8099 { &ei_oran_extlen_wrong, { "oran_fh_cus.extlen_wrong", PI_MALFORMED, PI_ERROR, "extlen doesn't match number of dissected bytes", EXPFILL }},
8100 { &ei_oran_invalid_eaxc_bit_width, { "oran_fh_cus.invalid_exac_bit_width", PI_UNDECODED, PI_ERROR, "Inconsistent eAxC bit width", EXPFILL }},
8101 { &ei_oran_extlen_zero, { "oran_fh_cus.extlen_zero", PI_MALFORMED, PI_ERROR, "extlen - zero is reserved value", EXPFILL }},
8102 { &ei_oran_rbg_size_reserved, { "oran_fh_cus.rbg_size_reserved", PI_MALFORMED, PI_ERROR, "rbgSize - zero is reserved value", EXPFILL }},
8103 { &ei_oran_frame_length, { "oran_fh_cus.frame_length", PI_MALFORMED, PI_ERROR, "there should be 0-3 bytes remaining after PDU in frame", EXPFILL }},
8104 { &ei_oran_numprbc_ext21_zero, { "oran_fh_cus.numprbc_ext21_zero", PI_MALFORMED, PI_ERROR, "numPrbc shall not be set to 0 when ciPrbGroupSize is configured", EXPFILL }},
8105 { &ei_oran_ci_prb_group_size_reserved, { "oran_fh_cus.ci_prb_group_size_reserved", PI_MALFORMED, PI_WARN, "ciPrbGroupSize should be 2-254", EXPFILL }},
8106 { &ei_oran_st8_nackid, { "oran_fh_cus.st8_nackid", PI_SEQUENCE, PI_WARN, "operation for this ackId failed", EXPFILL }},
8107 { &ei_oran_st4_no_cmds, { "oran_fh_cus.st4_nackid", PI_MALFORMED, PI_ERROR, "Not valid to have no commands in ST4", EXPFILL }},
8108 { &ei_oran_st4_zero_len_cmd, { "oran_fh_cus.st4_zero_len_cmd", PI_MALFORMED, PI_WARN, "ST4 cmd with length 0 is reserved", EXPFILL }},
8109 { &ei_oran_st4_wrong_len_cmd, { "oran_fh_cus.st4_wrong_len_cmd", PI_MALFORMED, PI_ERROR, "ST4 cmd with length not matching contents", EXPFILL }},
8110 { &ei_oran_st4_unknown_cmd, { "oran_fh_cus.st4_unknown_cmd", PI_MALFORMED, PI_ERROR, "ST4 cmd with unknown command code", EXPFILL }},
8111 { &ei_oran_mcot_out_of_range, { "oran_fh_cus.mcot_out_of_range", PI_MALFORMED, PI_ERROR, "MCOT should be 1-10", EXPFILL }},
8112 { &ei_oran_se10_unknown_beamgrouptype, { "oran_fh_cus.se10_unknown_beamgrouptype", PI_MALFORMED, PI_WARN, "SE10 - unknown BeamGroupType value", EXPFILL }},
8113 { &ei_oran_start_symbol_id_not_zero, { "oran_fh_cus.startsymbolid_shall_be_zero", PI_MALFORMED, PI_WARN, "For ST4 commands 3&4, startSymbolId shall be 0", EXPFILL }},
8114 { &ei_oran_trx_control_cmd_scope, { "oran_fh_cus.trx_command.bad_cmdscope", PI_MALFORMED, PI_WARN, "TRX command must have cmdScope of ARRAY-COMMAND", EXPFILL }},
8115 { &ei_oran_unhandled_se, { "oran_fh_cus.se_not_handled", PI_UNDECODED, PI_WARN, "SE not recognised/handled by dissector", EXPFILL }},
8116 { &ei_oran_bad_symbolmask, { "oran_fh_cus.bad_symbol_mask", PI_MALFORMED, PI_WARN, "For non-zero sleepMode, symbolMask must be 0x0 or 0x3ffff", EXPFILL }},
8117 { &ei_oran_numslots_not_zero, { "oran_fh_cus.numslots_not_zero", PI_MALFORMED, PI_WARN, "For ST4 TIME_DOMAIN_BEAM_WEIGHTS, numSlots should be 0", EXPFILL }},
8118 { &ei_oran_version_unsupported, { "oran_fh_cus.version_unsupported", PI_UNDECODED, PI_WARN, "Protocol version unsupported", EXPFILL }},
8119 { &ei_oran_laa_msg_type_unsupported, { "oran_fh_cus.laa_msg_type_unsupported", PI_UNDECODED, PI_WARN, "laaMsgType unsupported", EXPFILL }},
8120 { &ei_oran_se_on_unsupported_st, { "oran_fh_cus.se_on_unsupported_st", PI_MALFORMED, PI_WARN, "Section Extension should not appear on this Section Type", EXPFILL }},
8121 { &ei_oran_cplane_unexpected_sequence_number, { "oran_fh_cus.unexpected_seq_no_cplane", PI_SEQUENCE, PI_WARN, "Unexpected sequence number seen in C-Plane", EXPFILL }},
8122 { &ei_oran_uplane_unexpected_sequence_number, { "oran_fh_cus.unexpected_seq_no_uplane", PI_SEQUENCE, PI_WARN, "Unexpected sequence number seen in U-Plane", EXPFILL }},
8123 { &ei_oran_acknack_no_request, { "oran_fh_cus.acknack_no_request", PI_SEQUENCE, PI_WARN, "Have ackNackId response, but no request", EXPFILL }},
8124 { &ei_oran_udpcomphdr_should_be_zero, { "oran_fh_cus.udcomphdr_should_be_zero", PI_MALFORMED, PI_WARN, "C-Plane udCompHdr in DL should be set to 0", EXPFILL }},
8125 { &ei_oran_radio_fragmentation_c_plane, { "oran_fh_cus.radio_fragmentation_c_plane", PI_MALFORMED, PI_ERROR, "Radio fragmentation not allowed in C-PLane", EXPFILL }},
8126 { &ei_oran_radio_fragmentation_u_plane, { "oran_fh_cus.radio_fragmentation_u_plane", PI_UNDECODED, PI_WARN, "Radio fragmentation in C-PLane not yet supported", EXPFILL }},
8127 { &ei_oran_lastRbdid_out_of_range, { "oran_fh_cus.lastrbdid_out_of_range", PI_MALFORMED, PI_WARN, "SE 6 has bad rbgSize", EXPFILL }},
8128 { &ei_oran_rbgMask_beyond_last_rbdid, { "oran_fh_cus.rbgmask_beyond_lastrbdid", PI_MALFORMED, PI_WARN, "rbgMask has bits set beyond lastRbgId", EXPFILL }},
8129 { &ei_oran_unexpected_measTypeId, { "oran_fh_cus.unexpected_meastypeid", PI_MALFORMED, PI_WARN, "unexpected measTypeId", EXPFILL }},
8130 { &ei_oran_unsupported_compression_method, { "oran_fh_cus.compression_type_unsupported", PI_UNDECODED, PI_WARN, "Unsupported compression type", EXPFILL }},
8131 { &ei_oran_ud_comp_len_wrong_size, { "oran_fh_cus.ud_comp_len_wrong_size", PI_MALFORMED, PI_WARN, "udCompLen does not match length of U-Plane section", EXPFILL }},
8132 { &ei_oran_sresmask2_not_zero_with_rb, { "oran_fh_cus.sresmask2_not_zero", PI_MALFORMED, PI_WARN, "sReSMask2 should be zero when rb set", EXPFILL }},
8133 { &ei_oran_st6_rb_shall_be_0, { "oran_fh_cus.st6_rb_set", PI_MALFORMED, PI_WARN, "rb should not be set for Section Type 6", EXPFILL }},
8134 { &ei_oran_st10_numsymbol_not_14, { "oran_fh_cus.st10_numsymbol_not_14", PI_MALFORMED, PI_WARN, "numSymbol should be 14 for Section Type 10", EXPFILL }},
8135 { &ei_oran_st10_startsymbolid_not_0, { "oran_fh_cus.st10_startsymbolid_not_0", PI_MALFORMED, PI_WARN, "startSymbolId should be 0 for Section Type 10", EXPFILL }}
8136 };
8138 /* Register the protocol name and description */
8141 /* Allow dissector to find be found by name. */
8144 /* Register the tap name. */
8147 /* Required function calls to register the header fields and subtrees */
8158 /* Register bit width/compression preferences separately by direction. */
8161 prefs_register_uint_preference(oran_module, "oran.bandsector_id_bits", "BandSector ID bits [b]",
8162 "The bit width of BandSector ID - sum of a,b,c&d (eAxC) must be 16", 10, &pref_bandsector_id_bits);
8169 "The bit width of a sample in the Uplink (if no udcompHdr)", 10, &pref_sample_bit_width_uplink);
8172 prefs_register_enum_preference(oran_module, "oran.ud_comp_hdr_up", "udCompHdr field is present for uplink",
8173 "The udCompHdr field in U-Plane messages may or may not be present, depending on the "
8174 "configuration of the O-RU. This preference instructs the dissector to expect "
8179 "The bit width of a sample in the Downlink (if no udcompHdr)", 10, &pref_sample_bit_width_downlink);
8180 prefs_register_enum_preference(oran_module, "oran.ud_comp_down", "Downlink User Data Compression",
8182 prefs_register_enum_preference(oran_module, "oran.ud_comp_hdr_down", "udCompHdr field is present for downlink",
8183 "The udCompHdr field in U-Plane messages may or may not be present, depending on the "
8184 "configuration of the O-RU. This preference instructs the dissector to expect "
8188 prefs_register_uint_preference(oran_module, "oran.rbs_in_uplane_section", "Total RBs in User-Plane data section",
8191 prefs_register_uint_preference(oran_module, "oran.num_weights_per_bundle", "Number of weights per bundle",
8192 "Used in decoding of section extension type 11 (Flexible BF weights)", 10, &pref_num_weights_per_bundle);
8210 }
8212 /* Simpler form of proto_reg_handoff_oran which can be used if there are
8213 * no prefs-dependent registration function calls. */
8214 void
8216 {
8217 }
8219 /*
8220 * Editor modelines - http://www.wireshark.org/tools/modelines.html
8221 *
8222 * Local Variables:
8223 * c-basic-offset: 4
8224 * tab-width: 8
8225 * indent-tabs-mode: nil
8226 * End:
8227 *
8228 * ex: set shiftwidth=4 tabstop=8 expandtab:
8229 * :indentSize=4:tabSize=8:noTabs=true:
8230 */