TBufPool简介
TPipe可以管理全局内存资源，而TBufPool可以手动管理或复用Unified Buffer/L1 Buffer物理内存，主要用于多个stage计算中Unified Buffer/L1 Buffer物理内存不足的场景。
模板参数
template <TPosition pos, uint32_t bufIDSize = 4> class TBufPool{...};
参数名称 |
含义 |
|---|---|
pos |
TBufPool逻辑位置，可以为VECIN、VECOUT、VECCALC、A1、B1、C1。关于TPosition的具体介绍请参考TPosition。 |
bufIDSize |
TBufPool可分配Buffer数量，默认为4，不超过16。 |
功能图示
下图展示了资源池划分的过程：
- 通过TPipe::InitBuffer接口可以申请Buffer内存并使用队列进行管理；
- 通过TPipe::InitBufPool可以划分出资源池BufPool1；
- 通过TPipe::InitBufPool可以指定BufPool1与BufPool3地址和长度复用;
- 通过TBufPool::InitBuffer及TBufPool::InitBufPool接口继续将BufPool1及BufPool3划分成Buffer或TBufPool资源池。
图1 BufPool资源池划分
如图示的嵌套关系，最外层TBufPool(BufPool1与BufPool3)需要通过TPipe::InitBufPool申请并初始化，内层TBufPool(BufPool2)可以通过TBufPool::InitBufPool申请并初始化。
注意事项
- TBufPool必须通过TPipe::InitBufPool或TBufPool::InitBufPool接口进行划分和初始化；资源池只能整体划分成部分，无法部分拼接为整体；
- 不同TBufPool资源池切换进行计算时，需要调用TBufPool::Reset()接口清空已完成计算的TBufPool，清空后的TBufPool资源池及分配的Buffer和数据默认无效；
- 不同资源池间分配的Buffer无法混用避免数据踩踏；
- Alloc/Free、EnQue/DeQue在切分TBufPool资源池时必须成对匹配使用，自动确保同步；
- 切换资源池的时候，若手写同步，Ascend C不保证地址读写复用同步。因此不推荐手写同步。
父主题： TBufPool
