Keep vanetza-idf in obu-firmware, so a plain clone builds the firmware

obu-firmware builds against the vanetza-idf C-ITS library, which until now
came from the colleague's microbu-esp32c5 tree beside the repository and was
not tracked here, so a clone of this repository could not build the firmware
it ships. The library alone is now part of obu-firmware, as
obu-firmware/external/vanetza-idf: their external/vanetza-idf at commit
cf4b99f, unchanged (9775 files; see its PROVENANCE.md). CMake takes it from
there by default; -DVANETZA_IDF_DIR still points the build elsewhere.

The rest of the colleague's tree (their own VAM firmware, PKI tooling,
station-link Python tools, the V2X2MAP bridge) stays out of this repository
and gitignored; nothing is pushed to their repository. NOTES.md, docs/06,
TODO.md and the pcap verifier's usage line point at the new location.

obu-firmware/external/vanetza-idf/vanetza/geonet/address.cpp

@@ -0,0 +1,88 @@
+#include "address.hpp"
+#include "serialization.hpp"
+#include <boost/functional/hash.hpp>
+
+namespace vanetza
+{
+namespace geonet
+{
+
+constexpr std::size_t Address::length_bytes;
+
+namespace // anonymous namespace for local constants
+{
+constexpr uint16_t manually_configured_mask = 0x8000;
+constexpr uint16_t station_type_mask = 0x7c00;
+constexpr uint16_t country_code_mask = 0x03ff;
+constexpr unsigned station_type_shift = 10;
+} // namespace
+
+Address::Address() :
+    m_manually_configured(false),
+    m_station_type(StationType::Unknown),
+    m_country_code(0)
+{
+}
+
+Address::Address(const MacAddress& addr) :
+    m_manually_configured(false),
+    m_station_type(StationType::Unknown),
+    m_country_code(0),
+    m_mid(addr)
+{
+}
+
+bool Address::operator==(const Address& other) const
+{
+    return (this->m_manually_configured == other.m_manually_configured &&
+        this->m_station_type == other.m_station_type &&
+        this->m_country_code == other.m_country_code &&
+        this->m_mid == other.m_mid);
+}
+
+bool Address::operator!=(const Address& other) const
+{
+    return !(*this == other);
+}
+
+void serialize(const Address& addr, OutputArchive& ar)
+{
+    uint16_t manuallyConfiguredAndTypeAndCountryCode = addr.country_code().raw();
+    manuallyConfiguredAndTypeAndCountryCode |=
+        (static_cast<uint16_t>(addr.station_type()) << station_type_shift) & station_type_mask;
+    manuallyConfiguredAndTypeAndCountryCode |=
+        addr.is_manually_configured() ? manually_configured_mask : 0x0000;
+    serialize(host_cast(manuallyConfiguredAndTypeAndCountryCode), ar);
+    serialize(ar, addr.mid());
+}
+
+void deserialize(Address& addr, InputArchive& ar)
+{
+    uint16_t tmp;
+    deserialize(tmp, ar);
+    addr.is_manually_configured((tmp & manually_configured_mask) != 0);
+    addr.country_code(tmp & country_code_mask);
+    addr.station_type(static_cast<StationType>((tmp & station_type_mask) >> station_type_shift));
+    MacAddress mid;
+    deserialize(ar, mid);
+    addr.mid(mid);
+}
+
+} // namespace geonet
+} // namespace vanetza
+
+namespace std
+{
+
+namespace gn = vanetza::geonet;
+size_t hash<gn::Address>::operator()(const gn::Address& addr) const
+{
+    size_t seed = 0;
+    boost::hash_combine(seed, addr.is_manually_configured());
+    boost::hash_combine(seed, addr.station_type());
+    boost::hash_combine(seed, addr.country_code().raw());
+    boost::hash_range(seed, addr.mid().octets.begin(), addr.mid().octets.end());
+    return seed;
+}
+
+} // namespace std