LibXR::DatabaseRaw< MinWriteSize >::FlashInfo Struct Reference

Flash 存储的块信息结构 (Structure representing a Flash storage block). More...

Collaboration diagram for LibXR::DatabaseRaw< MinWriteSize >::FlashInfo:

Public Member Functions
	FlashInfo ()
	构造一个擦除态 FlashInfo 缓冲对象 (Construct one erased-state FlashInfo buffer object).

Data Fields
union {
uint32_t   header
	Flash 块头签名 / Flash block-header signature. More...
uint8_t   padding [MinWriteSize]
	按最小写入单元对齐的原始块前缀 / Raw block prefix aligned to one minimum write unit. More...
};
	让块前缀既能按签名读取，也能按最小写入单元整体写入 / Expose the block prefix both as a signature field and as one full minimum-write-unit write span
KeyInfo	key
	紧跟在块头后的首个键头 / First key header stored right after the block header.

Detailed Description

template<size_t MinWriteSize>
struct LibXR::DatabaseRaw< MinWriteSize >::FlashInfo

Flash 存储的块信息结构 (Structure representing a Flash storage block).

Definition at line 163 of file raw.hpp.

Constructor & Destructor Documentation

FlashInfo()

template<size_t MinWriteSize>

LibXR::DatabaseRaw< MinWriteSize >::FlashInfo::FlashInfo ( )

inline

构造一个擦除态 FlashInfo 缓冲对象 (Construct one erased-state FlashInfo buffer object).

Definition at line 169 of file raw.hpp.

{
 
template <size_t MinWriteSize>
class DatabaseRaw : public Database
{
  static constexpr uint32_t FLASH_HEADER =
      0x12345678 + LIBXR_DATABASE_VERSION;
 
  static constexpr uint32_t CHECKSUM_BYTE = 0x9abcedf0;
 
  // 存储布局定义：块角色、位图编码、键头与块头。
  // Storage layout definitions: block roles, bitmap encodings, key headers,
  // and block headers.
#include "layout.hpp"
 
  size_t recycle_threshold_ = 0;
 
  Flash& flash_;
 
  uint32_t block_size_;
 
  uint8_t write_buffer_[MinWriteSize];
 
  // 底层 Flash 读写辅助：按最小写入单元对齐、补齐、复制。
  // Low-level Flash I/O helpers: minimum-write-unit alignment, tail padding,
  // and raw copying.
#include "flash_io.hpp"
 
  // 块级语义：初始化、校验、失效、已用空间计算和块间复制。
  // Block-level semantics: initialization, validation, invalidation,
  // used-space accounting, and block-to-block copying.
#include "block_ops.hpp"
 
  // 键级语义：查找、追加、逻辑更新、条目地址计算。
  // Key-level semantics: lookup, append, logical replacement, and entry
  // address calculations.
#include "key_ops.hpp"
 
 public:
  // 对外生命周期与主流程：构造、初始化、读写、恢复、回收。
  // Public lifecycle and main flow: construction, initialization, read/write,
  // restore, and recycle.
#include "lifecycle.hpp"
};
 
}  // namespace LibXR

Field Documentation

header

template<size_t MinWriteSize>

uint32_t LibXR::DatabaseRaw< MinWriteSize >::FlashInfo::header

Flash 块头签名 / Flash block-header signature.

Definition at line 182 of file raw.hpp.

key

template<size_t MinWriteSize>

KeyInfo LibXR::DatabaseRaw< MinWriteSize >::FlashInfo::key

紧跟在块头后的首个键头 / First key header stored right after the block header.

Definition at line 185 of file raw.hpp.

padding

template<size_t MinWriteSize>

uint8_t LibXR::DatabaseRaw< MinWriteSize >::FlashInfo::padding[MinWriteSize]

按最小写入单元对齐的原始块前缀 / Raw block prefix aligned to one minimum write unit.

Definition at line 183 of file raw.hpp.

---

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

• src/middleware/database/raw/raw.hpp