LibXR::LinuxBinaryFileFlash< FLASH_SIZE > Class Template Reference

LinuxBinaryFileFlash 类，用于从二进制文件加载闪存数据 LinuxBinaryFileFlash class for loading flash data from a binary file. More...

#include <linux_flash.hpp>

Inheritance diagram for LibXR::LinuxBinaryFileFlash< FLASH_SIZE >:

Collaboration diagram for LibXR::LinuxBinaryFileFlash< FLASH_SIZE >:

Public Member Functions
	LinuxBinaryFileFlash (const std::string &file_path, size_t min_erase_size=FLASH_SIZE/2, size_t min_write_size=sizeof(uint8_t), bool write_order_check=false, bool write_as_one_check=false)
	LinuxBinaryFileFlash 构造函数 LinuxBinaryFileFlash constructor.
ErrorCode	Erase (size_t offset, size_t size) override
	擦除闪存区域
ErrorCode	Write (size_t offset, ConstRawData data) override
	写入数据 Write data
Public Member Functions inherited from LibXR::Flash
	Flash (size_t min_erase_size, size_t min_write_size, RawData flash_area)
	Constructs a Flash object with specified properties. 构造函数，初始化闪存属性。

Private Member Functions
ErrorCode	SyncToFile ()

Private Attributes
std::string	file_path_
std::array< uint8_t, FLASH_SIZE >	flash_area_ = {}
bool	write_order_check_
bool	write_as_one_check_

Additional Inherited Members
Data Fields inherited from LibXR::Flash
size_t	min_erase_size_
	Minimum erasable block size in bytes. 最小可擦除块大小（字节）。
size_t	min_write_size_
	Minimum writable block size in bytes. 最小可写块大小（字节）。
RawData	flash_area_

Detailed Description

template<size_t FLASH_SIZE>
class LibXR::LinuxBinaryFileFlash< FLASH_SIZE >

LinuxBinaryFileFlash 类，用于从二进制文件加载闪存数据 LinuxBinaryFileFlash class for loading flash data from a binary file.

Template Parameters

FLASH_SIZE

闪存大小 Flash size

Definition at line 23 of file linux_flash.hpp.

Constructor & Destructor Documentation

LinuxBinaryFileFlash()

template<size_t FLASH_SIZE>

LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::LinuxBinaryFileFlash ( const std::string &  file_path, size_t  min_erase_size = FLASH_SIZE / 2, size_t  min_write_size = sizeof(uint8_t), bool  write_order_check = false, bool  write_as_one_check = false  )

inline

LinuxBinaryFileFlash 构造函数 LinuxBinaryFileFlash constructor.

Parameters

file_path	二进制文件路径 Binary file path
min_erase_size	最小擦除块大小 Minimum erase block size
min_write_size	最小写入块大小 Minimum write block size
write_order_check	开启写入顺序检查 Enable write order check
write_as_one_check	开启写入一致性检查 Enable write consistency check

Definition at line 36 of file linux_flash.hpp.

      : Flash(min_erase_size, min_write_size, RawData(&flash_area_, sizeof(flash_area_))),
        file_path_(file_path),
        write_order_check_(write_order_check),
        write_as_one_check_(write_as_one_check)
  {
    std::ifstream file(file_path_, std::ios::binary);
    if (file)
    {
      file.read(reinterpret_cast<char*>(flash_area_.data()),
                static_cast<std::streamsize>(flash_area_.size()));
    }
  }

Member Function Documentation

Erase()

template<size_t FLASH_SIZE>

ErrorCode LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::Erase ( size_t  offset, size_t  size  )

inlineoverridevirtual

擦除闪存区域

Parameters

offset	距离闪存区域起始位置的偏移量 Offset from the start of the flash area
size	要擦除的大小 Size to erase

Returns

ErrorCode

Implements LibXR::Flash.

Definition at line 60 of file linux_flash.hpp.

  {
    ASSERT(offset % min_erase_size_ == 0);
    ASSERT(size % min_erase_size_ == 0);
 
    if ((offset + size) > flash_area_.size())
    {
      return ErrorCode::OUT_OF_RANGE;
    }
 
    std::memset(flash_area_.data() + offset, 0xFF, size);
 
    return SyncToFile();
  }

SyncToFile()

template<size_t FLASH_SIZE>

ErrorCode LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::SyncToFile ( )

inlineprivate

Definition at line 125 of file linux_flash.hpp.

  {
    std::ofstream file(file_path_, std::ios::binary | std::ios::trunc);
    if (!file)
    {
      return ErrorCode::FAILED;
    }
    file.write(reinterpret_cast<const char*>(flash_area_.data()),
               static_cast<std::streamsize>(flash_area_.size()));
    return ErrorCode::OK;
  }

Write()

template<size_t FLASH_SIZE>

ErrorCode LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::Write ( size_t  offset, ConstRawData  data  )

inlineoverridevirtual

写入数据 Write data

Parameters

offset	距离闪存区域起始位置的偏移量 Offset from the start of the flash area
data	要写入的数据 Data to write

Returns

ErrorCode

Implements LibXR::Flash.

Definition at line 82 of file linux_flash.hpp.

  {
    if ((offset + data.size_) > flash_area_.size())
    {
      return ErrorCode::OUT_OF_RANGE;
    }
 
    if (offset % min_write_size_ != 0 || data.size_ % min_write_size_ != 0)
    {
      ASSERT(false);
      return ErrorCode::FAILED;
    }
 
    if (write_order_check_)
    {
      ASSERT(offset % min_erase_size_ == 0);
    }
 
    uint8_t* dst = flash_area_.data() + offset;
    const uint8_t* src = static_cast<const uint8_t*>(data.addr_);
 
    if (write_as_one_check_)
    {
      for (size_t i = 0; i < data.size_; ++i)
      {
        if ((~dst[i] & src[i]))
        {
          ASSERT(false);
          return ErrorCode::FAILED;
        }
      }
    }
 
    std::memcpy(dst, src, data.size_);
    return SyncToFile();
  }

Field Documentation

file_path_

template<size_t FLASH_SIZE>

std::string LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::file_path_

private

Definition at line 120 of file linux_flash.hpp.

flash_area_

template<size_t FLASH_SIZE>

std::array<uint8_t, FLASH_SIZE> LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::flash_area_ = {}

private

Definition at line 121 of file linux_flash.hpp.

{};

write_as_one_check_

template<size_t FLASH_SIZE>

bool LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::write_as_one_check_

private

Definition at line 123 of file linux_flash.hpp.

write_order_check_

template<size_t FLASH_SIZE>

bool LibXR::LinuxBinaryFileFlash< FLASH_SIZE >::write_order_check_

private

Definition at line 122 of file linux_flash.hpp.

---

The documentation for this class was generated from the following file:

• driver/Linux/linux_flash.hpp