USRP Hardware Driver and USRP Manual Version: 4.6.0.0
UHD and USRP Manual
 
Loading...
Searching...
No Matches
chdr_packet.ipp
Go to the documentation of this file.
1//
2// Copyright 2020 Ettus Research, a National Instruments Brand
3//
4// SPDX-License-Identifier: GPL-3.0-or-later
5//
6
7#pragma once
8
9#include <uhd/exception.hpp>
11
13namespace uhd { namespace utils { namespace chdr {
14
15template <typename payload_t>
18 payload_t payload,
19 boost::optional<uint64_t> timestamp,
20 std::vector<uint64_t> metadata)
21 : chdr_packet(chdr_w, header, std::vector<uint8_t>(), timestamp, std::move(metadata))
22{
23 set_payload(payload);
24}
25
26template <typename OutputIterator>
28 OutputIterator first, OutputIterator last, uhd::endianness_t endianness) const
29{
30 void* start = static_cast<void*>(&*first);
31 void* end = static_cast<void*>(&*last);
32 serialize_ptr(endianness, start, end);
33}
34
35template <typename InputIterator>
37 InputIterator first,
38 InputIterator last,
39 uhd::endianness_t endianness)
40{
41 void* start = static_cast<void*>(&*first);
42 void* end = static_cast<void*>(&*last);
43 return deserialize_ptr(chdr_w, endianness, start, end);
44}
45
46template <typename payload_t>
48{
49 payload_t payload;
50 // Only Data Packets are allowed to have end on a incomplete CHDR_W length.
51 // This method is never called on a data packet. (They don't have a payload_t)
52 UHD_ASSERT_THROW(this->_payload.size() % sizeof(uint64_t) == 0)
53 auto conv_byte_order = [endianness](uint64_t x) -> uint64_t {
54 return (endianness == uhd::ENDIANNESS_BIG) ? uhd::htonx<uint64_t>(x)
56 };
57 payload.deserialize(reinterpret_cast<const uint64_t*>(this->_payload.data()),
58 this->_payload.size(),
59 conv_byte_order);
60 return payload;
61}
62
63template <typename payload_t>
64void chdr_packet::set_payload(payload_t payload, uhd::endianness_t endianness)
65{
67 // Meaning a 64 bit word (The basic unit of data for payloads)
68 size_t payload_len_words = payload.get_length();
69 this->_payload.resize(payload_len_words * sizeof(uint64_t), 0);
70 auto conv_byte_order = [endianness](uint64_t x) -> uint64_t {
71 return (endianness == uhd::ENDIANNESS_BIG) ? uhd::htonx<uint64_t>(x)
73 };
74 payload.serialize(reinterpret_cast<uint64_t*>(this->_payload.data()),
75 this->_payload.size(),
76 conv_byte_order);
77 set_header_lengths();
78}
79
80template <typename payload_t>
81const std::string chdr_packet::to_string_with_payload(uhd::endianness_t endianness) const
82{
83 payload_t payload = this->get_payload<payload_t>(endianness);
84 return to_string() + payload.to_string();
85}
86
87template <>
88const std::string chdr_packet::to_string_with_payload<chdr_rfnoc::mgmt_payload>(
89 uhd::endianness_t endianness) const
90{
92 this->get_payload<chdr_rfnoc::mgmt_payload>(endianness);
93 return to_string() + payload.to_string() + payload.hops_to_string();
94}
95
96}}} // namespace uhd::utils::chdr
Definition chdr_types.hpp:35
void set_pkt_type(packet_type_t pkt_type)
Set the packet type field (3 bits)
Definition chdr_types.hpp:87
A class that represents a complete multi-hop management transaction.
Definition chdr_types.hpp:809
const std::string to_string() const
Return a string representation of this object.
const std::string hops_to_string() const
Return a string representaiton of the hops contained by this object.
Definition chdr_packet.hpp:21
void set_payload(payload_t payload, uhd::endianness_t endianness=uhd::ENDIANNESS_LITTLE)
Definition chdr_packet.ipp:64
const std::string to_string() const
Return a string representation of this object.
chdr_packet(uhd::rfnoc::chdr_w_t chdr_w, uhd::rfnoc::chdr::chdr_header header, payload_t payload, boost::optional< uint64_t > timestamp=boost::none, std::vector< uint64_t > metadata={})
Definition chdr_packet.ipp:16
payload_t get_payload(uhd::endianness_t endianness=uhd::ENDIANNESS_LITTLE) const
Definition chdr_packet.ipp:47
static chdr_packet deserialize(uhd::rfnoc::chdr_w_t chdr_w, InputIterator first, InputIterator last, endianness_t endianness=uhd::ENDIANNESS_LITTLE)
Definition chdr_packet.ipp:36
const std::string to_string_with_payload(uhd::endianness_t endianness=uhd::ENDIANNESS_LITTLE) const
Return a string representation of this object and deserialize its payload.
Definition chdr_packet.ipp:81
void serialize(OutputIterator first, OutputIterator last, endianness_t endianness=uhd::ENDIANNESS_LITTLE) const
Definition chdr_packet.ipp:27
#define UHD_ASSERT_THROW(code)
Definition exception.hpp:321
STL namespace.
Definition chdr_types.hpp:19
constexpr packet_type_t payload_to_packet_type()
Conversion from payload_t to pkt_type.
chdr_w_t
Type that indicates the CHDR Width in bits.
Definition rfnoc_types.hpp:19
Definition build_info.hpp:12
T htowx(T)
host to worknet: short, long, or long-long
Definition byteswap.ipp:142
T htonx(T)
host to network: short, long, or long-long
Definition byteswap.ipp:122
endianness_t
Definition endianness.hpp:30
@ ENDIANNESS_BIG
Definition endianness.hpp:30