platform-device-model — скилл для Claude Code: установка
Скилл platform-device-model для Claude Code объясняет привязку Linux-драйверов к platform bus, работу probe и remove, sysfs и deferred probe. Описывает задачи разработки драйверов устройств и работы с Device Tree.
MIT 378 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a claude-codeЧто делает platform-device-model
Скилл разбирает модель устройств Linux: связи между struct device, device_driver и шиной, жизненный цикл platform_driver, получение ресурсов и регистрацию обработчиков probe и remove. Он показывает каркас драйвера с devm_*, чтение свойств из DT или ACPI, сохранение данных через platform_set_drvdata и создание атрибута sysfs.
Отдельные шаги посвящены -EPROBE_DEFER, диагностике через /sys/bus/platform, debugfs и udevadm, а также переходу от legacy board file к DT. При отсутствующем драйвере-поставщике deferred probe будет повторяться бесконечно. В примерах используются platform_get_resource, devm_ioremap_resource и device_property_read_u32.
Какие задачи решает
- связать
platform_driverс устройством Linux - перенести драйвер с legacy board file на DT
- получить memory resource и отобразить его через
devm_ioremap_resource - вывести состояние драйвера через sysfs
- разобраться с бесконечным deferred probe
Примеры запросов агенту
- Преобразуй legacy board file драйвер в DT
platform_driverсdevm_ioremap. - Покажи, как реализовать
probeиremoveдля platform device с автоматической очисткой. - Добавь атрибут sysfs для состояния драйвера и объясни, как проверить его через
/sys/bus/platform.
Как установить platform-device-model
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a claude-code2Вручную: положить файлы
~/.claude/skills/platform-device-model/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/platform-device-model/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a codex2Вручную: положить файлы
.agents/skills/platform-device-model/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a cursor2Вручную: положить файлы
.cursor/skills/platform-device-model/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/kernel-dev/platform-device-model2Вручную: положить файлы
.github/skills/platform-device-model/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/kernel-dev/platform-device-modelВручную: положить файлы
.devin/skills/platform-device-model/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о platform-device-model
Как установить platform-device-model в Claude Code?
Выполните npx skills add mohitmishra786/low-level-dev-skills --skill platform-device-model -a claude-code, затем проверьте файл ~/.claude/skills/platform-device-model/SKILL.md.
Что делает platform-device-model?
Скилл помогает писать и отлаживать Linux-драйверы для platform bus: связывать устройство и драйвер, получать ресурсы, читать свойства DT или ACPI, создавать sysfs-атрибуты и обрабатывать deferred probe.
На каких платформах работает platform-device-model?
Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.
Исходный текст
SKILL.md · MIT
---
name: platform-device-model
description: Platform device model skill for Linux driver binding. Use when implementing platform_driver probe/remove, sysfs attributes, device properties, or deferred probe. Activates on queries about platform_device, platform_driver, driver model, sysfs, probe remove, or Linux device bus.
---
# Platform Device Model
## Purpose
Explain the Linux driver model for platform (and similar) buses: `struct device`, `device_driver`, `probe`/`remove`, resource acquisition, sysfs, and deferred probe — the glue between device tree and driver code.
## When to Use
- Implementing or debugging `platform_driver` lifecycle
- Exposing driver state via sysfs
- Understanding uevent / `udev` device node creation
- Before `skills/kernel-dev/writing-char-drivers`
## Workflow
### 1. Object hierarchy
```
bus_type (platform, amba, pci, i2c, spi)
├── struct device — hardware instance
└── struct device_driver — driver logic
└── probe(dev) / remove(dev)
```
Platform devices often come from DT (`of_platform`) or legacy board files.
### 2. Platform driver skeleton
```c
static int my_probe(struct platform_device *pdev)
{
struct resource *res;
void __iomem *base;
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
base = devm_ioremap_resource(&pdev->dev, res);
if (IS_ERR(base))
return PTR_ERR(base);
platform_set_drvdata(pdev, priv);
return 0;
}
static void my_remove(struct platform_device *pdev)
{
/* devm_* auto-cleanup on remove */
}
static struct platform_driver my_pdrv = {
.probe = my_probe,
.remove = my_remove,
.driver = {
.name = "my-dev",
.of_match_table = my_of_match,
},
};
module_platform_driver(my_pdrv);
```
Prefer `devm_*` helpers for automatic unwind.
### 3. Device properties (DT / ACPI)
```c
u32 speed;
device_property_read_u32(&pdev->dev, "clock-speed", &speed);
bool flag = device_property_present(&pdev->dev, "feature-x");
```
### 4. Sysfs (driver visibility)
```c
static ssize_t status_show(struct device *dev,
struct device_attribute *attr, char *buf)
{
return sysfs_emit(buf, "ok\n");
}
static DEVICE_ATTR_RO(status);
/* in probe */
device_create_file(&pdev->dev, &dev_attr_status);
```
### 5. Deferred probe
Return `-EPROBE_DEFER` when a clock, regulator, or bus is not ready — core retries later.
### 6. Debug
```bash
ls /sys/bus/platform/devices/
ls /sys/bus/platform/drivers/
cat /sys/kernel/debug/devices_deferred # if debugfs enabled
udevadm monitor
```
### 7. Agent usage
```
/platform-device-model Convert legacy board file driver to DT platform_driver with devm_ioremap
```
## Common Problems
| Symptom | Cause | Fix |
|---------|-------|-----|
| `-EBUSY` on probe | Resource claimed twice | Check `status` / duplicate nodes |
| No `/dev` node | Char device not registered | See `writing-char-drivers` |
| Deferred forever | Supplier driver missing | Fix DT dependency chain |
| Remove crash | Manual free vs devm mismatch | Use devm consistently |
| Name mismatch | `.name` vs `compatible` | OF uses `of_match_table` |
## Related Skills
- `skills/kernel-dev/device-tree` — hardware description
- `skills/kernel/device-drivers` — IRQ, DMA, regmap depth
- `skills/kernel-dev/writing-char-drivers` — userspace interface
- `skills/kernel-dev/bus-drivers-i2c-spi` — other bus types
- `skills/low-level-programming/linux-kernel-modules` — module loading
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills