# LPM 逻辑分区管理(Logical partition management)，支持动态创建、删除、查找、读写物理存储设备上的逻辑分区。 ## LPM 使用说明 ### LPM 初始化 初始化 API 是一定要执行的，确保 LPM 初始化后能正确的管理 block 设备。 #### 1. LPM 初始化 ```lpm_init(void);``` 上电初始化首先要执行的函数，用于初始化 **lpm** 链表 #### 2. LPM 管理 BLOCK 设备 ```int lpm_dev_blk_append(struct rt_device *dev)``` 把 **block_dev** 交由 **lpm** 管理 #### 3. LPM 查找被管理的 BLOCK 设备 ```struct lpm_dev *lpm_dev_find(const char *dev_name)``` 可以查找到 **block_dev** 是否被 **lpm** 管理 ### LPM API LPM 组件提供了API 可供用户动态调用 #### 1. 查找分区 ```struct lpm_partition *lpm_partition_find(const char *dev_name, const char *name)``` 查找当前 block 设备上的 分区信息 | 参数 | 描述 | | -------- | --------------------------------------------------- | | dev_name | block 设备的名字，可以通过 list_device 查看到的名字 | | name | 分区的名字 | | return | 返回分区的指针 | #### 2. 创建分区 ```struct lpm_partition *lpm_partition_create(const char *dev_name, const char *name, uint32_t size)``` 在当前 block 设备上创建一个分区 | 参数 | 描述 | | -------- | --------------------------------------------------- | | dev_name | block 设备的名字，可以通过 list_device 查看到的名字 | | name | 分区的名字 | | return | 返回分区的指针 | #### 3. 删除分区 ```int lpm_partition_delete(const char *dev_name, const char *name)``` 删除当前 block 设备上的分区 | 参数 | 描述 | | -------- | --------------------------------------------------- | | dev_name | block 设备的名字，可以通过 list_device 查看到的名字 | | name | 分区的名字 | | return | 返回分区的指针 | #### 4. 删除所有分区 ```int lpm_partition_delete_all(const char *dev_name)``` 删除当前 block 设备上的所有分区 | 参数 | 描述 | | -------- | --------------------------------------------------- | | dev_name | block 设备的名字，可以通过 list_device 查看到的名字 | | return | 返回分区的指针 | #### 5. 创建 block 设备 ```struct rt_device *lpm_blk_device_create(const char *dev_name, const char *parition_name)``` 在 lpm 分区上创建一个 block 设备，新的 block 设备名是就是传递进去的分区名 | 参数 | 描述 | | -------- | --------------------------------------------------- | | dev_name | block 设备的名字，可以通过 list_device 查看到的名字 | | name | 分区的名字 | | return | 返回新的 block 设备的指针 | #### 6. 分区读数据 ```int lpm_partition_read(const struct lpm_partition *part, uint32_t sector_no, uint8_t *buf, size_t size)``` 对分区进行读操作。 | 参数 | 描述 | | --------- | -------------------- | | part | 分区的名字 | | sector_no | 开始读的 sector | | buf | 读数据的缓冲区 | | size | 读数据的长度 | | return | 返回读取到数据的长度 | #### 7. 分区写数据 ```int lpm_partition_write(const struct lpm_partition *part, uint32_t sector_no, const uint8_t *buf, size_t size)``` 对分区进行写操作。 | 参数 | 描述 | | --------- | ---------------- | | part | 分区的名字 | | sector_no | 开始读的 sector | | buf | 写数据的缓冲区 | | size | 写数据的长度 | | return | 返回写数据的长度 | #### 8. 分区擦除 ```int lpm_partition_erase(const struct lpm_partition *part, uint32_t block_no, size_t num)``` 擦除分区。 | 参数 | 描述 | | -------- | ----------------- | | part | 分区的名字 | | block_no | 开始擦的 block | | num | 擦除的 block 数量 | | return | 返回结果 | #### 9. 分区全部擦除 ```int lpm_partition_erase_all(const struct lpm_partition *part)``` 擦除分区上的所有数据。 | 参数 | 描述 | | -------- | ----------------- | | part | 分区的名字 | | return | 返回结果 | #### 10. 打印分区信息 ```int lpm_dump_partition(void)``` 打印所有的分区信息。 ``` ==================== LPM partition table ============================ | dev_name | par_name | block_size | offset | length | --------------------------------------------------------------------- | norflash | app | 0x00001000 | 0x00000003 | 0x00000004 | | norflash | abb | 0x00001000 | 0x00000008 | 0x00000004 | ===================================================================== ``` ### LPM 命令行 #### 1. 探测分区信息 ```lpmm probe norflash app ``` 探测 **norflash** block 设备上是否存在 **app** 这个分区 ``` msh />lpmm probe norflash app find partition name is app Probed a block device | app | offset: 3 | size: 4 | ``` #### 2. 读取分区信息 ```lpmm read norflash app 0 1``` 读取 **norflash** 设备上，第 0 个 sector 开始，1 个 sector 长度的数据 ``` Read data success. Start sector_no from 0x00000000, size is 4096. The data is: Offset (h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F [00000000] 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F ................ [00000010] 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F ................ [00000020] 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F !"#$%&'()*+,-./ [00000030] 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 0123456789:;<=>? ``` #### 3. 在分区上写数据 ```lpmm write norflash app 0 1``` 写 **norflash** 设备上，第 0 个 sector 开始，1 个 sector 长度的数据，block 设备每次读写都是一个 block , 目前不支持用户写自定义数据。 ``` msh />lpmm write norflash app 0 1 find partition name is app LPM Write Success at the Device name (norflash) the partition name (app) . ``` #### 4. 创建一个新的分区 ```lpmm create norflash cpp 10``` 在**norflash** 设备上，创建一个分区**cpp**，大小为 **10** 个 block ``` msh />lpmm create norflash cpp 10 Create block device | cpp | offset: 3 | size: 10 |. ``` #### 5. 删除一个分区 ```lpmm delete norflash app``` 删除 **norflash** 设备上的分区 **app** ``` msh />lpmm delete norflash app delete lpm_dev name is norflash partition name is app Delete norflash Partition app Success. ``` #### 6. 删除所有分区 ```lpmm delete norflash all``` 删除 **norflash** 设备上的所有分区 ``` msh />lpmm delete norflash all delete lpm_dev name is norflash partition name is cpp delete lpm_dev name is norflash partition name is abb delete lpm_dev name is norflash partition name is app ``` #### 7. 显示分区信息 ```lpmm dump norflash part``` 打印 **norflash** 的分区信息 ``` msh />lpmm dump norflash part ==================== LPM partition table ============================ | dev_name | par_name | block_size | offset | length | --------------------------------------------------------------------- | norflash | cpp | 0x00001000 | 0x00000003 | 0x0000000a | | norflash | abb | 0x00001000 | 0x00000008 | 0x00000004 | | norflash | app | 0x00001000 | 0x00000003 | 0x0000000a | ===================================================================== ``` #### 8. 显示 BLOCK 设备 ```lpmm dump norflash dev``` 打印被 **lpm** 管理的 block 设备 ``` msh />lpmm dump norflash dev ==================== LPM Device table ======================= | dev_name | bytes_per_sector | sector_count | block_size | ------------------------------------------------------------- | norflash | 0x00001000 | 0x00001000 | 0x00001000 | ============================================================= ```