Vietnamese (machine translation)

Lưu ý

Mục đích của file này là để độc giả tiếng Việt có thể đọc và hiểu tài liệu nhân kernel dễ dàng hơn, không phải để tạo ra một nhánh tài liệu riêng. Nếu bạn có bất kỳ nhận xét hoặc cập nhật nào cho file này, vui lòng thử cập nhật file tiếng Anh gốc trước. Nếu bạn thấy có sự khác biệt giữa bản dịch và bản gốc, hoặc có vấn đề về bản dịch, vui lòng gửi góp ý hoặc patch cho người dịch của file này, hoặc nhờ người bảo trì và người review tài liệu tiếng Việt giúp đỡ.

Bản gốc:

The Basic Device Structure

Người dịch:

Google Translate (machine translation)

Phiên bản gốc:

8541d8f725c6

Cảnh báo

Tài liệu này được dịch tự động bằng máy và chưa được review bởi người dịch. Nội dung có thể không chính xác hoặc khó hiểu ở một số chỗ. Khi có sự khác biệt với bản gốc, bản gốc luôn là chuẩn. Bản dịch chất lượng cao (được review) được đặt trong thư mục vi_VN/.

Cấu trúc thiết bị cơ bản

Xem kerneldoc để biết thiết bị cấu trúc.

Giao diện lập trình

Trình điều khiển xe buýt phát hiện ra thiết bị sẽ sử dụng điều này để đăng ký thiết bị có lõi:

int device_register(struct device * dev);

Xe buýt nên khởi tạo các trường sau:

  • cha mẹ

    • tên

    • bus_id

    • xe buýt

Một thiết bị sẽ bị xóa khỏi lõi khi số tham chiếu của nó đạt tới 0. Số lượng tham chiếu có thể được điều chỉnh bằng cách sử dụng:

thiết bị cấu trúc * get_device(thiết bị cấu trúc * dev);

void put_device(thiết bị cấu trúc * dev);

get_device() sẽ trả về một con trỏ tới thiết bị cấu trúc được truyền cho nó nếu tham chiếu chưa phải là 0 (nếu nó đang trong quá trình đã bị loại bỏ rồi).

Trình điều khiển có thể truy cập khóa trong cấu trúc thiết bị bằng cách sử dụng:

void lock_device(thiết bị cấu trúc * dev);

void unlock_device(thiết bị cấu trúc * dev);

Thuộc tính

cấu trúc thiết bị_thuộc tính {

thuộc tính cấu trúc attr; ssize_t (*show)(struct device *dev, struct device_attribute *attr,

char *buf);

ssize_t (*store)(struct device *dev, struct device_attribute *attr,

const char *buf, size_t count);

};

Các thuộc tính của thiết bị có thể được trình điều khiển thiết bị xuất thông qua sysfs.

Vui lòng xem Tài liệu/filesystems/sysfs.rst để biết thêm thông tin về cách hoạt động của sysfs.

Như đã giải thích trong Tài liệu/core-api/kobject.rst, thuộc tính thiết bị phải là được tạo trước khi sự kiện KOBJ_ADD được tạo. Cách duy nhất để nhận ra đó là bằng cách xác định một nhóm thuộc tính.

Các thuộc tính được khai báo bằng macro có tên DEVICE_ATTR:

#define DEVICE_ATTR (tên, chế độ, hiển thị, cửa hàng)

Ví dụ::

DEVICE_ATTR tĩnh (loại, 0444, type_show, NULL);

DEVICE_ATTR tĩnh (nguồn, 0644, power_show, power_store);

Các macro trợ giúp có sẵn cho các giá trị chung của chế độ, vì vậy các ví dụ trên có thể được đơn giản hóa thành ::

DEVICE_ATTR_RO tĩnh (loại);

tĩnh DEVICE_ATTR_RW(nguồn);

Điều này khai báo hai cấu trúc kiểu struct device_attribute với tương ứng đặt tên ‘dev_attr_type’ và ‘dev_attr_power’. Hai thuộc tính này có thể được tổ chức như sau thành một nhóm:

thuộc tính cấu trúc tĩnh *dev_attrs[] = {

&dev_attr_type.attr, &dev_attr_power.attr, NULL,

};

cấu trúc tĩnh thuộc tính_group dev_group = {

.attrs = dev_attrs,

};

const tĩnh struct attribute_group *dev_groups[] = {

&dev_group, NULL,

};

Macro trợ giúp có sẵn cho trường hợp chung của một nhóm, vì vậy Hai cấu trúc trên có thể được khai báo bằng ::

ATTRIBUTE_GROUPS(nhà phát triển);

Mảng nhóm này sau đó có thể được liên kết với một thiết bị bằng cách đặt con trỏ nhóm trong thiết bị struct trước khi device_register() được gọi:

dev->groups = dev_groups;

device_register(dev);

Hàm device_register() sẽ sử dụng con trỏ ‘groups’ để tạo thuộc tính thiết bị và hàm device_unregister() sẽ sử dụng con trỏ này để loại bỏ các thuộc tính của thiết bị.

Lời cảnh báo: Trong khi kernel cho phép device_create_file() và device_remove_file() được gọi trên thiết bị bất cứ lúc nào, không gian người dùng có những kỳ vọng nghiêm ngặt về thời điểm các thuộc tính được tạo. Khi có một thiết bị mới được đăng ký trong kernel, một sự kiện được tạo để thông báo cho không gian người dùng (như udev) rằng có thiết bị mới. Nếu các thuộc tính được thêm vào sau thiết bị đã được đăng ký thì vùng người dùng sẽ không nhận được thông báo và vùng người dùng sẽ không biết về các thuộc tính mới.

Điều này rất quan trọng đối với trình điều khiển thiết bị cần xuất bản bổ sung thuộc tính cho thiết bị tại thời điểm thăm dò trình điều khiển. Nếu trình điều khiển thiết bị chỉ đơn giản là gọi device_create_file() trên cấu trúc thiết bị được truyền cho nó, sau đó không gian người dùng sẽ không bao giờ được thông báo về các thuộc tính mới.