- PVSM.RU - https://www.pvsm.ru -
Наблюдая за появляющимися драйверами в ядре Linux, не могу не отметить, что разработчики недостаточно хорошо знают инфраструктуру ядра, точнее внутренний API, значительно упрощающий жизнь при написании драйверов устройств. Сегодня я коснусь темы, посвящённой управляемым ресурсам. В частности поясню каким образом они работают и как упрощают разработку драйверов.
Условно разобью предоставляемый API на:
В каждой из категорий я приведу список доступных функций и в случае необходимости дополнительную информацию, на которую стоит обратить внимание. Но вначале кратко расскажу принцип как устроено управление этими ресурсами.
В далёком 2007 году Tejun Heo предложил упростить драйвера устройств с помощью управляемых ресурсов устройств, создав так называемое devres API.
devres: device resource management
Идея заключается в следующем. Каждому устройству соответствует его представление, struct device
, в дереве устройств ядра Linux. В структуру было добавлено поле devres_head
(на самом деле ещё одно для синхронизации доступа), которое указывает на список управляемых ресурсов, если таковые были использованы на стадии ->probe()
. Управляемый ресурс представляет собой выделенную память на куче ассоциированную с некоторой структурой данных, в случае kmalloc()
, например, это просто указатель void *
.
На этапе ->probe()
, как я уже говорил, выполняется пополнение списка управляемых ресурсов, на стадии же ->remove()
базовая часть обслуживания драйверов сама позаботится о высвобождении всех занятых ресурсов ровно в порядке обратном их добавлению.
Для исключительных случаев можно вызвать соответствующее высвобождение раньше и явно. Здесь же кроется и проблема [1], которую мы разберём на примере в следующей части.
Для выделения памяти можно использовать следующие основные функции:
devm_kasprintf()
devm_kcalloc()
devm_kmalloc()
devm_kmemdup()
devm_kstrdup()
devm_kzalloc()
Предназначение каждой по-моему очевидно, останавливаться не буду на этом. Перейдём к примеру использования.
Допустим, мы выделяем память для нашей структуры и хотим, чтобы она автоматически высвободилась, по окончании работы драйвера.
struct my_cool_device {
struct device *dev;
void *memregion;
};
int mydev_probe(...)
{
struct device *dev = ...;
struct my_cool_device *cool;
cool = devm_kzalloc(dev, ...);
if (!cool)
return -ENOMEM;
cool->memregion = devm_kmalloc(dev, ...);
if (!cool->memregion)
return -ENOMEM;
cool->dev = dev;
dev_info(dev, "Found my cool devicen");
return 0;
}
void mydev_remove(...)
{
/* Nothing! */
}
Обратили внимание как красиво у нас выглядит путь выхода при возникновении ошибки в середине функции? И как замечательно выглядит ->remove()
!
Теперь примеры как высвободить ресурс, если это по какой-то причине необходимо сделать явно.
Правильно:
void mydev_remove(...)
{
struct device *dev = ...;
struct my_cool_device *cool = ...;
devm_kfree(dev, cool->memregion);
}
Неправильно:
void mydev_remove(...)
{
struct my_cool_device *cool = ...;
kfree(cool->memregion);
}
Для выделения памяти, подходящей для DMA используйте
dmam_alloc_coherent()
dmam_alloc_noncoherent()
dmam_pool_create()
Ресурсы ввода-вывода можно выделить используя нижеследующие функции
devm_ioport_map()
devm_ioremap()
devm_ioremap_resource(): проверяет ресурс, запрашивает регион памяти, проецирует его на физические адреса устройства
pcim_iomap()
pcim_iomap_regions(): запрашивает регион и проецирует на него физические адреса указанные в требуемых BAR-ах
pcim_iomap_table(): массив спроецированных адресов, индексируемый по номеру BAR-а
Обратите внимание, что нижняя часть относится к устройствам на шине PCI, но при этом вынесена в категорию ввода-вывода.
devm_request_any_context_irq()
devm_request_irq()
devm_request_threaded_irq()
devm_regulator_bulk_get()
devm_regulator_get()
devm_regulator_register()
Шина IIO:
devm_iio_device_alloc()
devm_iio_device_register()
devm_iio_kfifo_allocate()
devm_iio_trigger_alloc()
Шина MDIO:
devm_mdiobus_alloc()
devm_mdiobus_alloc_size()
Шина PCI:
pcim_enable_device(): в случае успешного завершения все операции подразумеваются управляемыми
pcim_pin_device(): оставить устройство разрешённым после высвобождения
Особенно обратите внимание на pcim_enable_device()
. Однажды применив её необходимо вычистить высвобождение регионов, даже если их выделение и проецирование осуществляется старым способом. Например, можно посмотреть детали в commit 5618955c4269 [2].
Шина SPI:
devm_spi_register_master()
GPIO:
devm_gpiod_get()
devm_gpiod_get_index()
devm_gpiod_get_index_optional()
devm_gpiod_get_optional()
Pin control:
devm_pinctrl_get()
Я затронул лишь наиболее часто встречаемые и используемые функции-помощники для управления ресурсами. Об остальном можно почитать в соответствующей документации на API ядра: devres.txt [3].
Автор: andy_shev
Источник [4]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/open-source/88565
Ссылки в тексте:
[1] проблема: #Issue
[2] commit 5618955c4269: https://git.kernel.org/cgit/linux/kernel/git/tiwai/sound.git/commit/?id=5618955c4269b07c8177f88a8075d4879e74cd27
[3] devres.txt: https://www.kernel.org/doc/Documentation/driver-model/devres.txt
[4] Источник: http://habrahabr.ru/post/255459/
Нажмите здесь для печати.