Keep the colleague's microbu-esp32c5 tree in this repository

obu-firmware builds against vanetza-idf from microbu-esp32c5/external, but
that tree was gitignored, so a clone of this repository could not build the
firmware it ships. It is now committed here as ordinary files in its own
folder, microbu-esp32c5/: the colleague's commit cf4b99f plus the V2X2MAP
bridge's signature verification (--trust) used on the bench. Nothing is
fetched from or pushed to the colleague's repository; this repository and
its remotes carry everything. The folder's own .gitignore keeps build output,
downloaded components and private key material out, as it did there; the
committed file set is identical to that repository's tracked files.

The ESP32-C5 is still flashed from obu-firmware/, which only takes
vanetza-idf from microbu-esp32c5/, so the two stay separate folders.
FLASHING.md says how to take a newer version of the colleague's tree (copy
it over the folder, rebuild, test, commit).

microbu-esp32c5/external/vanetza-idf/vanetza/geonet/dcc_information_sharing.hpp

@@ -0,0 +1,90 @@
+#ifndef DCC_INFORMATION_SHARING_HPP_GZCSHZLD
+#define DCC_INFORMATION_SHARING_HPP_GZCSHZLD
+
+#include <vanetza/common/clock.hpp>
+#include <vanetza/common/hook.hpp>
+#include <vanetza/common/unit_interval.hpp>
+#include <vanetza/geonet/cbr_aggregator.hpp>
+#include <vanetza/geonet/dcc_field_generator.hpp>
+
+namespace vanetza
+{
+
+class Runtime;
+
+namespace geonet
+{
+
+class LocationTable;
+
+/**
+ * DccInformationSharing realises the DCC_NET behaviour for ITS-G5, originally specified by
+ * TS 102 636-4-2 V1.1.1 and carried forward by TS 103 836-4-2 V2.1.1 clauses 5.3-5.4
+ * (Release 2; the CBR_G algorithm and trigger cadence implemented here match the current
+ * text step-for-step). CBR_target corresponds to the Release-2 protocol constant
+ * itsGNCBRTarget (TS 103 836-4-2 V2.1.1 Annex A: 0,62), which supersedes the value this
+ * class's original author had to guess at from TS 102 687's undefined NDL_maxChannelUse.
+ */
+class DccInformationSharing : public DccFieldGenerator
+{
+public:
+    /**
+     * Create DCC_net instance
+     *
+     * \param rt Runtime for scheduling periodic update cycles
+     * \param lt Location Table with LocTEX_G5 entries
+     * \param target CBR_target value (usually NDL_maxChannelLoad)
+     * \param delay Delaying first update cycle randomly
+     *
+     * \note Set random delay interval when multiple stations are created at the same time!
+     *       Values shall be distributed uniformly across full integer range.
+     */
+    DccInformationSharing(Runtime& rt, const LocationTable& lt, dcc::ChannelLoad target, UnitInterval delay);
+    DccInformationSharing(Runtime& rt, const LocationTable& lt, dcc::ChannelLoad target);
+
+    DccField generate_dcc_field() override;
+
+    /**
+     * Update local CBR measurement
+     *
+     * Local measurement rate is decoupled from processing in DCC_net,
+     * i.e. DccInformationSharing buffers the given value and the latest
+     * measurement value when its internal update cycle runs.
+     *
+     * \param cbr local CBR measurement
+     */
+    void update_local_cbr(dcc::ChannelLoad cbr);
+
+    /**
+     * Set packet TX power
+     *
+     * \param power Packet transmission output power in dBm
+     */
+    void set_tx_power(unsigned power);
+
+private:
+    void trigger();
+
+    Runtime& m_runtime;
+    const LocationTable& m_location_table;
+    const dcc::ChannelLoad m_cbr_target;
+    dcc::ChannelLoad m_cbr_local;
+    unsigned m_tx_power;
+    CbrAggregator m_aggregator;
+    Clock::duration m_trigger_interval;
+    Timestamp m_last_aggregation;
+    Hook<const CbrAggregator&> m_update_hook;
+
+public:
+    /**
+     * on_global_cbr_update is called at each update cycle,
+     * i.e. when a new global CBR has been calculated
+     */
+    HookRegistry<const CbrAggregator&> on_global_cbr_update;
+};
+
+} // namespace geonet
+} // namespace vanetza
+
+#endif /* DCC_INFORMATION_SHARING_HPP_GZCSHZLD */
+