Kernel API 5 - Linux Driver Model(ext) #
--
김도집 2025-01-12 08:50:12
시스템 디바이스(cpu, timer, rtc 등)를 위한 드라이버 모델이다.
관련 자료형 및 함수는 <linux/sysdev.h>에 선언되어 있다.
1.2.1 sysdev_class #
<linux/sysdev.h>에 선언되어 있다.
struct sysdev_class {
struct list_head drivers;
int (*shutdown)(struct sys_device *);
int (*suspend)(struct sys_device *, pm_message_t state);
int (*resume)(struct sys_device *);
struct kset kset;
1.2.2 sysdev_class_register #
<linux/sysdev.h>에 선언되어 있다.
int sysdev_class_register(struct sysdev_class *);
1.2.3 sysdev_class_unregister #
<linux/sysdev.h>에 선언되어 있다.
void sysdev_class_unregister(struct sysdev_class);
1.2.4 sysdev_driver #
<linux/sysdev.h>에 선언되어 있다.
struct sysdev_driver {
struct list_head entry;
int (*add)(struct sys_device *);
int (*remove)(struct sys_device *);
int (*shutdown)(struct sys_device *);
int (*suspend)(struct sys_device *, pm_message_t state);
int (*resume)(struct sys_device *);
};
<linux/sysdev.h>에 선언되어 있다.
struct sys_device {
u32 id;
struct sysdev_class *cls;
struct kobject kobj;
};
1.2.6 sysdev_register #
<linux/sysdev.h>에 선언되어 있다.
int sysdev_register(struct sys_device *);
관련함수: sysdev_unregister
1.2.7 sysdev_unregiser #
<linux/sysdev.h>에 선언되어 있다.
void sysdev_unregister(struct sys_device *);
관련함수: sysdev_register
1.2.8 sysdev_attribute #
<linux/sysdev.h>에 선언되어 있다.
struct sysdev_attribute {
struct attribute attr;
ssize_t (*show)(struct sys_device *, char *);
ssize_t (*store)(struct sys_device *, const char *, size_t);
};
1.2.9 SYSDEV_ATTR #
<linux/sysdev.h>에 선언되어 있다.
sysdev_attribute형의 attr_##name으로 자료 구조체를 만드는 매크로이다.
SYSDEV_ATTR(_name, _mode, _show, _store)
1.2.10 sysdev_create_file #
<linux/sysdev.h>에 선언되어 있다.
int sysdev_create_file(struct sys_device *, struct sysdev_attribute *);
관련함수: sysdev_remove_file
1.2.11 sysdev_remove_file #
<linux/sysdev.h>에 선언되어 있다.
void sysdev_remove_file(struct sys_device *, struct sysdev_attribute *);
관련함수: sysdev_create_file
1.3 firmware #
일부 디바이스의 경우엔 firmware를 로드하거나 업데이트할 필요가 있다. 이러한 경우를 위하여 리눅스 2.6의 sysfs를 이용하여 사용자 수준에서 firmware 데이터를 커널 수준으로 로드할 수 있다.
firmware와 관련된 것들은 <linux/firmware.h>에 선언되어 있다.
| 함수 | 설명 |
| request_firmware | |
| request_firmware_nowait | |
| release_firmware | |
firmware 인터페이스에서 사용하는 기본 자료형은
struct fw;가 있다.
struct firmware {
size_t size;
u8 *data;
};
==== request_firmware ===
sysfs를 통해 사용자 수준의 데이터를 커널 수준으로 넘겨 받는다.
int request_firmware(const struct firmware **fw, char *name, struct device *device);
넘겨 받은 데이터는 fw 구조체 내에 저장이 된다. 넘겨 받은 firmware 데이터의 이름은 name으로 설정한다. device는 firmware와 관련된 디바이스이다.
실제 데이터는 fw->data에 있으며, 그 크기는 fw->size가 되는 것이다. 따라서 이 값을 디바이스에 로드하거나 업데이트하면 된다.
1.3.2 request_firmware_nowait #
request_firmware는 firmware를 요구 받았을 때 완료되기까지 휴면상태가 되는데, request_firmware_nowait는 휴면되지 않는다.
int request_firmware_nowait(struct module *module, char *name, struct device *device,
void *context, void (*cont)(const struct firmware *fw,
void *context));
1.3.3 release_firmware #
request_firmware를 통해 받은 firmware 데이터에 대한 자원 할당을 해제한다.
void release_firmware(struct firmware *fw);
1.3.4 firmware의 사용 #
사용자 수준에서는 /sys/class/firmware 디렉토리 아래에 디바이스 이름의 디렉토리가 만들어진다. 그 아래에 loading, data, device 등의 파일 또는 심볼릭 링크가 만들어진다.
loading은 현재 firmware의 로딩이 완료되면 0을 쓰고, 로딩을 중단한다면 -1, 이외의 값은 로딩 중임을 의미한다.
data를 통해 firmware 데이터를 write하면 된다.
device는 /sys/device에서 해당 디바이스에 대한 심볼릭 링크이다.
경우에 따라서 firmware를 로딩하는 시간이 길어지면 timeout이 걸리는데, 이는 /sys/class/fimrware/timeout를 통해 timeout 시간을 변경할 수 있다.
