# ION Memory Control ### Overview ION子系统目的主要是通过在硬件设备和用户空间之间分配和共享内存，实现设备之间零拷贝共享内存。 * 零拷贝：CPU不执行拷贝数据从一个存储区域到另一个存储区域 ION是Google在Android 4.0 ICS中引入，用于改善对于当前不同平台的android设备，使用各种不同内存管理接口来管理相应内存的状况，ION将内存管理机制抽象成一系列通用的接口，可集中分配各类不同内存(`ion_heap_type`区分)。 ION的主要功能： * 内存管理：提供通用（平台无关）的内存管理接口，通过heap管理各种类型的内存。 * 共享内存：可提供驱动之间、用户进程之间、内核空间和用户空间之间的共享内存。 ### ION 内存类型 ION通过heap类型来代表不同的内存，不同的内存有不同的分配方式。 ``` // in ./src/system/core/libion/kernel-headers/linux/ion.h enum ion_heap_type { ION_HEAP_TYPE_SYSTEM, ION_HEAP_TYPE_SYSTEM_CONTIG, ION_HEAP_TYPE_CARVEOUT, ION_HEAP_TYPE_CHUNK, ION_HEAP_TYPE_DMA, ION_HEAP_TYPE_CUSTOM, ION_NUM_HEAPS = 16, }; ``` 每个`heap`中可分配若干个`buffer`，每个`client`(`ion_open()`返回的`fd`)通过`handle`管理对应的`buffer`。每个`buffer`只能有一个`handle`对应，每个用户进程只能有一个`client`，每个`client`可能有多个`handle`(申请多块内存空间)。两个`client`通过文件描述符`fd`，通过映射方式，将相应内存映射，实现共享内存。 ![](/files/-MePQjmuBWEL3wu9OYUG) `handle`通过`ion_alloc_fd()`赋值，`client`通过`handle`来获取分配的`ion`内存的地址，目前来说并没有碰到过使用`ION`共享内存的情况，可能因为效率太低？有因为要使用`C2D`而去申请`ion buffer`的情况，除了因为`C2D`要求使用`ion`，还有为了减少I/O操作加速对图片读写速度的考量，因为通过`ION_IOCRL_XXX`申请到的空间都位于高速缓存中，CPU可以直接读取到，并且在用户进程中为了方便使用，通常会使用`mmap()`将`ion buffer`地址映射到用户空间。 ``` // open /dev/ion static int ion_fd_get(void) { static int fd = -1; ​ if (fd == -1) { fd = ion_open(); } ​ return fd; } ​ /* * @brief alloc ion buffer * @param ion_fd ion_user_handle_t * @param size ion buffer size * @param addr user_space addr */ static int alloc_ion_buffer(int *ion_fd, int size, void **addr) { int ret; ​ if (!ion_fd || !addr || size < 0) { printf("%s: Invalid argument!\n", __FUNCTION__); return -1; } ​ ret = ion_alloc_fd(ion_fd_get(), size, 4096, 1 << 25, 1, ion_fd); if (ret < 0) { printf("%s: ion allocate failed!\n", __FUNCTION__); return -1; } ​ *addr = mmap(NULL, size, PROT_READ | PROT_WRITE, MAP_SHARED, *ion_fd, 0); if (*addr == MAP_FAILED) { printf("%s: mmap failed!\n", __FUNCTION__); return -1; } ​ return 0; } ``` ### 用户空间API 用户空间API通过`ioctl`直接与驱动交互。 ``` // in .//src/system/core/libion/include/ion/ion.h int ion_open(); int ion_close(int fd); int ion_alloc(int fd, size_t len, size_t align, unsigned int heap_mask, unsigned int flags, ion_user_handle_t *handle); int ion_alloc_fd(int fd, size_t len, size_t align, unsigned int heap_mask, unsigned int flags, int *handle_fd); int ion_sync_fd(int fd, int handle_fd); int ion_free(int fd, ion_user_handle_t handle); int ion_map(int fd, ion_user_handle_t handle, size_t length, int prot, int flags, off_t offset, unsigned char **ptr, int *map_fd); int ion_share(int fd, ion_user_handle_t handle, int *share_fd); int ion_import(int fd, int share_fd, ion_user_handle_t *handle); ``` ### ioctl() 用户空间API对应的`ioctl()`操作 ``` // in ./src/system/core/libion/kernel-headers/linux/ion.h #define ION_IOC_ALLOC _IOWR(ION_IOC_MAGIC, 0, struct ion_allocation_data) #define ION_IOC_FREE _IOWR(ION_IOC_MAGIC, 1, struct ion_handle_data) #define ION_IOC_MAP _IOWR(ION_IOC_MAGIC, 2, struct ion_fd_data) #define ION_IOC_SHARE _IOWR(ION_IOC_MAGIC, 4, struct ion_fd_data) #define ION_IOC_IMPORT _IOWR(ION_IOC_MAGIC, 5, struct ion_fd_data) #define ION_IOC_SYNC _IOWR(ION_IOC_MAGIC, 7, struct ion_fd_data) #define ION_IOC_CUSTOM _IOWR(ION_IOC_MAGIC, 6, struct ion_custom_data) ``` 具体的实现在`ion-ioctl.c`中。 ### ion\_alloc\_fd() ``` // in ./src/system/core/libion/ion.c int ion_alloc_fd(int fd, size_t len, size_t align, unsigned int heap_mask, unsigned int flags, int* handle_fd) { ion_user_handle_t handle; int ret; ​ if (!ion_is_legacy(fd)) return -EINVAL; ​ ret = ion_alloc(fd, len, align, heap_mask, flags, &handle); if (ret < 0) return ret; ret = ion_share(fd, handle, handle_fd); ion_free(fd, handle); ​ return ret; } ``` `ion_alloc_fd()`所有的参数实际是调用`ion_alloc()`，填充`ion_allocation_data`结构体，并调用对应的`ioctl`（ION\_IOC\_ALLOC）操作，并返回一个`handle`给`handle_fd`。 ``` // in ./src/system/core/libion/kernel-headers/linux/ion.h struct ion_allocation_data { size_t len; size_t align; unsigned int heap_id_mask; unsigned int flags; ion_user_handle_t handle; }; ``` * **len：**分配的大小。 * **align：**对齐标志，通常为页对齐（4096） * **heap\_mask：**待分配所使用的所有heaps的掩码(用于区分heap类型，实际是1 << ion\_heap\_type) * **flags：**传给heap的标志（如：ION\_FLAG\_CACHED），ion系统使用低16位，高16位用于各自heap实现使用。 * **handle：**ion buffer的句柄 原以为`handle`会作为`ion_alloc_fd()`的返回，但是查看`ion_share()`的源码，在`ion_share()`中会填充`ion_fd_data`结构体——进程共享内存所需的元数据，并且最终返回的是用于共享内存的文件描述符。 ``` // in ./src/system/core/libion/kernel-headers/linux/ion.h /** * struct ion_fd_data - metadata passed to/from userspace for a handle/fd pair * @handle: a handle * @fd: a file descriptor representing that handle * * For ION_IOC_SHARE or ION_IOC_MAP userspace populates the handle field with * the handle returned from ion alloc, and the kernel returns the file * descriptor to share or map in the fd field. For ION_IOC_IMPORT, userspace * provides the file descriptor and the kernel returns the handle. */ struct ion_fd_data { ion_user_handle_t handle; int fd; } ``` ### 后记 关于`ION`的概念就讲这么多，主要集中在应用上，再往下的内核空间API由于本人水平有限，涉及到更底层偏向于物理硬件的内存申请操作即使看过代码也无法能很好的描述其逻辑，而简单的讲解源码在我看来是没有必要的。 第一次运用`ION`是在多路视频应用中，使用了`FFmpeg`来解码视频，由于解码出的图片帧是`YUV420 NV12`，为了显示还需要进行色彩空间转换，如果使用常规色彩空间转换API(如OpenCV)，那么会耗费大量时间在读写和拷贝操作上，因此使用`C2D`库(依赖于`ION`)来完成色彩转换操作。在当时我以为`ION`是一块特殊设计(具有硬件加速功能)且实际存在的物理内存(类似于主存的边角料，但被保留)，因此我理解的是我的用户进程和该物理硬件之间存在内存共享。但是review代码之后，根据我的粗浅理解，这并不会用到`ION`内存共享的特性，只是因为`ION`申请到的buffer已经位于高速缓存中，提高了读写命中率，忙完手上这个AIDemo工程后会开始Camera相关的学习，也正是`ION`框架的应用所在，希望之后会有更好的理解。
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ricardolu.gitbook.io/trantor/ion-memory-control.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.