feat: add read_bulk() API

Author: patrislav1

inc/udmaio/HwAccessor.hpp

@@ -12,6 +12,7 @@
 #pragma once
 
 #include <cstddef>
+#include <cstring>
 #include <filesystem>
 #include <fstream>
 #include <iostream>
@@ -63,9 +64,14 @@ class HwAccessor : public Logger, private boost::noncopyable {
     void _wr_mem32(uint32_t offs, const void* __restrict__ mem, size_t size);
     void _wr_mem64(uint32_t offs, const void* __restrict__ mem, size_t size);
 
+    virtual std::vector<uint8_t> read_bulk([[maybe_unused]] uint32_t offs,
+                                           [[maybe_unused]] uint32_t size) {
+        return {};
+    }
+
     /**
      * @brief Read register from UIO interface
-     * 
+     *
      * @tparam C Register data type
      * @param offs Register offset into address space
      * @return C Value read from register
@@ -87,7 +93,7 @@ class HwAccessor : public Logger, private boost::noncopyable {
 
     /**
      * @brief Write register to UIO interface
-     * 
+     *
      * @tparam C Register data type
      * @param offs Register offset into address space
      * @param value Value to write
@@ -223,6 +229,14 @@ class HwAccessorMmap : public HwAccessor {
         return irq_count;
     }
 
+    std::vector<uint8_t> read_bulk(uint32_t offs, uint32_t size) final override {
+        std::vector<uint8_t> result;
+        result.resize(size);
+        auto src = _mem_ptr<uint8_t>(offs);
+        memcpy(&result[0], const_cast<uint8_t*>(src), size);
+        return result;
+    }
+
   public:
     UioRegion get_phys_region() const final override {
         const size_t access_offs =

inc/udmaio/UioIf.hpp

@@ -75,6 +75,10 @@ class UioIf : private boost::noncopyable {
     inline void _wr32(uint32_t offs, uint32_t data) { _hw->_wr32(offs, data); }
     inline void _wr64(uint32_t offs, uint64_t data) { _hw->_wr64(offs, data); }
 
+    std::vector<uint8_t> read_bulk(uint32_t offs, uint32_t size) {
+        return _hw->read_bulk(offs, size);
+    }
+
     template <typename C>
     C _rd_reg(uint32_t offs) const {
         return _hw->template _rd_reg<C>(offs);