Vietnamese (machine translation)

English

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:: User-Space DTX (Clipboard Detachment System) Interface
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/.

Giao diện DTX (Hệ thống tách bảng tạm) không gian người dùng ¶

Trình điều khiển ZZ0000ZZ chịu trách nhiệm tách clipboard thích hợp và xử lý việc đính kèm lại. Để đạt được mục đích này, nó cung cấp ZZ0001ZZ tệp thiết bị, qua đó nó có thể giao tiếp với daemon không gian người dùng. Cái này daemon sau đó chịu trách nhiệm cuối cùng trong việc xác định và thực hiện các biện pháp cần thiết các hành động, chẳng hạn như tháo các thiết bị gắn vào đế, dỡ/tải lại trình điều khiển đồ họa, thông báo người dùng, v.v.

Có hai nguyên tắc giao tiếp cơ bản được sử dụng trong trình điều khiển này: Lệnh (trong các phần khác của tài liệu còn được gọi là yêu cầu) và sự kiện. Các lệnh được gửi đến EC và có thể có ý nghĩa khác trong bối cảnh khác nhau. Các sự kiện được EC gửi theo một số trạng thái nội bộ thay đổi. Các lệnh luôn được khởi tạo bởi trình điều khiển, trong khi các sự kiện luôn được thực hiện do EC khởi xướng.

Danh pháp ¶

ZZ0000ZZ Phần trên có thể tháo rời của Surface Book, chứa màn hình và CPU.
ZZ0000ZZ Phần dưới của Surface Book nơi có thể lấy bảng nhớ tạm tách rời, tùy chọn (tùy theo kiểu máy) chứa GPU (dGPU) riêng biệt.
ZZ0000ZZ Cơ chế giữ clipboard gắn vào đế bình thường hoạt động và cho phép nó được tách ra khi được yêu cầu.
ZZ0000ZZ Lệnh được EC chấp nhận là lệnh hợp lệ và được xác nhận (tuân theo giao thức truyền thông tiêu chuẩn), nhưng EC không hoạt động trên đó, tức là bỏ qua nó.e phần trên của

Quá trình tách rời ¶

Cảnh báo: Phần tài liệu này dựa trên kỹ thuật đảo ngược và kiểm tra và do đó có thể có lỗi hoặc không đầy đủ.

Trạng thái chốt ¶

Cơ chế chốt có hai trạng thái chính: ZZ0000ZZ và ZZ0001ZZ. trong Trạng thái ZZ0002ZZ (mặc định), bảng tạm được cố định vào đế, trong khi ở trạng thái trạng thái ZZ0003ZZ, người dùng có thể xóa bảng nhớ tạm.

Ngoài ra, chốt có thể được khóa và mở khóa tương ứng, điều này có thể ảnh hưởng đến quá trình tách. Cụ thể, cơ chế khóa này nhằm ngăn chặn dGPU, được đặt ở đế của thiết bị, khỏi bị rút phích cắm nóng trong khi sử dụng. Thông tin chi tiết có thể được tìm thấy trong tài liệu về thủ tục tách ra dưới đây. Theo mặc định, chốt là đã được mở khóa.

Thủ tục tách ra ¶

Lưu ý rằng quá trình tách ra được điều chỉnh hoàn toàn bởi EC. các Trình điều khiển ZZ0000ZZ chỉ chuyển tiếp các sự kiện từ EC sang không gian người dùng và các lệnh từ không gian người dùng đến EC, tức là nó không ảnh hưởng đến quá trình này.

Quá trình tách được bắt đầu bằng việc người dùng nhấn nút ZZ0001ZZ trên đế của thiết bị hoặc thực thi ZZ0000ZZ IOCTL. Tiếp theo đó:

EC bật đèn chỉ báo trên nút tháo, gửi một tín hiệu Sự kiện ZZ0001ZZ (ZZ0000ZZ) và đang chờ đợi thêm hướng dẫn/lệnh. Trong trường hợp chốt được mở khóa, đèn led sẽ nhấp nháy màu xanh lá cây. Nếu chốt đã bị khóa thì led sẽ có màu đỏ đặc
Sự kiện này, thông qua trình điều khiển ZZ0000ZZ, được chuyển tiếp đến không gian người dùng, trong đó một daemon không gian người dùng thích hợp có thể xử lý nó và gửi lại hướng dẫn tới EC thông qua IOCTL do trình điều khiển này cung cấp.
EC chờ hướng dẫn từ không gian người dùng và hành động theo hướng dẫn đó. Nếu EC không nhận được bất kỳ hướng dẫn nào trong một khoảng thời gian nhất định, nó sẽ hết thời gian và tiếp tục như sau:

Nếu chốt không khóa thì EC sẽ mở chốt và clipboard
có thể tách rời khỏi đế. Đây là hành vi chính xác như không có trình điều khiển này hoặc bất kỳ daemon không gian người dùng nào. Xem ZZ0000ZZ mô tả bên dưới để biết thêm chi tiết về hoạt động tiếp theo của EC.
Nếu chốt bị khóa thì EC sẽ ZZ0003ZZ mở chốt, nghĩa là
clipboard không thể tách rời khỏi đế. Hơn nữa, EC gửi một sự kiện hủy bỏ (ZZ0001ZZ) nêu chi tiết điều này với sự kiện hủy bỏ lý do ZZ0002ZZ (xem ZZ0000ZZ để biết chi tiết).

Phản hồi hợp lệ của daemon không gian người dùng đối với sự kiện yêu cầu tách là:

Chạy ZZ0000ZZ. Điều này sẽ ngay lập tức hủy bỏ quá trình tách rời. Hơn nữa, EC sẽ gửi một sự kiện yêu cầu tách ra, tương tự như việc người dùng nhấn nút tách để hủy quá trình đã nói (xem bên dưới).
Chạy ZZ0000ZZ. Điều này sẽ khiến EC mở chốt, sau đó người dùng có thể tách bảng tạm và đế.

Khi điều này thay đổi trạng thái chốt, một sự kiện ZZ0002ZZ: (ZZ0000ZZ) sẽ được gửi sau khi chốt được mở thành công. Nếu EC không mở được chốt, ví dụ: do phần cứng lỗi hoặc pin yếu, sự kiện hủy chốt (ZZ0001ZZ) sẽ xảy ra được gửi với lý do hủy cho biết lỗi cụ thể.
Nếu chốt hiện đang bị khóa, chốt sẽ tự động được khóa.: đã được mở khóa trước khi mở.

Chạy ZZ0000ZZ. Điều này sẽ thiết lập lại thời gian chờ nội bộ. Sẽ không có hành động nào khác được thực hiện, tức là quá trình tách sẽ không được hoàn thành hay bị hủy bỏ và EC vẫn sẽ chờ đợi thêm những phản hồi.
Thực hiện ZZ0000ZZ. Điều này sẽ hủy bỏ quá trình tách ra, tương tự như ZZ0001ZZ, được mô tả ở trên hoặc nút nhấn, được mô tả dưới đây. Sự kiện ZZ0003ZZ (ZZ0002ZZ) được gửi để đáp lại điều này. Tuy nhiên, trái ngược với những điều đó, lệnh này không kích hoạt một quy trình tách mới nếu hiện tại không có quy trình nào trong tiến bộ.
Không làm gì cả. Quá trình tách cuối cùng hết thời gian như được mô tả trong điểm 3.

Xem ZZ0000ZZ để biết thêm chi tiết về những phản hồi này.

Điều quan trọng cần lưu ý là, nếu người dùng nhấn nút tháo bất kỳ lúc nào điểm khi một hoạt động tách đang được tiến hành (tức là sau khi EC đã gửi sự kiện ZZ0001ZZ ban đầu (ZZ0000ZZ) và trước đó nhận được phản hồi tương ứng kết thúc quá trình), nhóm tách ra quá trình bị hủy ở cấp EC và một sự kiện giống hệt đang được gửi. Do đó, bản thân sự kiện ZZ0002ZZ không báo hiệu sự bắt đầu của quá trình tách rời.

Quá trình tách rời có thể bị EC hủy bỏ thêm do phần cứng lỗi hoặc pin clipboard yếu. Việc này được thực hiện thông qua sự kiện hủy (ZZ0000ZZ) với lý do hủy tương ứng.

Tài liệu về giao diện không gian người dùng ¶

Mã lỗi và giá trị trạng thái ¶

Mã lỗi và trạng thái được chia thành các loại khác nhau, có thể được sử dụng để xác định xem mã trạng thái có bị lỗi hay không và nếu có thì mức độ nghiêm trọng và loại lỗi đó. Các loại hiện tại là:

Overview of Status/Error Categories.¶
Name	Value	Short Description
`STATUS`	`0x0000`	Non-error status codes.
`RUNTIME_ERROR`	`0x1000`	Non-critical runtime errors.
`HARDWARE_ERROR`	`0x2000`	Critical hardware failures.
`UNKNOWN`	`0xF000`	Unknown error codes.

Các danh mục khác được dành riêng để sử dụng trong tương lai. Macro ZZ0000ZZ có thể được sử dụng để xác định danh mục của bất kỳ giá trị trạng thái nào. các Macro ZZ0001ZZ có thể được sử dụng để kiểm tra xem giá trị trạng thái có phải là giá trị thành công (ZZ0002ZZ) hoặc nếu nó báo lỗi.

Trạng thái không xác định hoặc mã lỗi do EC gửi được gán cho ZZ0000ZZ được người lái xe phân loại và có thể được triển khai thông qua mã riêng của họ trong tương lai.

Mã lỗi hiện đang được sử dụng là:

Overview of Error Codes.¶
Name	Category	Value	Short Description
`SDTX_DETACH_NOT_FEASIBLE`	`RUNTIME`	`0x1001`	Detachment not feasible due to low clipboard battery.
`SDTX_DETACH_TIMEDOUT`	`RUNTIME`	`0x1002`	Detachment process timed out while the latch was locked.
`SDTX_ERR_FAILED_TO_OPEN`	`HARDWARE`	`0x2001`	Failed to open latch.
`SDTX_ERR_FAILED_TO_REMAIN_OPEN`	`HARDWARE`	`0x2002`	Failed to keep latch open.
`SDTX_ERR_FAILED_TO_CLOSE`	`HARDWARE`	`0x2003`	Failed to close latch.

Các mã lỗi khác được dành riêng để sử dụng trong tương lai. Mã trạng thái không có lỗi có thể chồng chéo và thường chỉ duy nhất trong trường hợp sử dụng của chúng:

Latch Status Codes.¶
Name	Category	Value	Short Description
`SDTX_LATCH_CLOSED`	`STATUS`	`0x0000`	Latch is closed/has been closed.
`SDTX_LATCH_OPENED`	`STATUS`	`0x0001`	Latch is open/has been opened.

Base State Codes.¶
Name	Category	Value	Short Description
`SDTX_BASE_DETACHED`	`STATUS`	`0x0000`	Base has been detached/is not present.
`SDTX_BASE_ATTACHED`	`STATUS`	`0x0001`	Base has been attached/is present.

Một lần nữa, các mã khác được dành riêng để sử dụng trong tương lai.

Sự kiện ¶

Sự kiện có thể được nhận bằng cách đọc từ tập tin thiết bị. Họ bị vô hiệu hóa bởi mặc định và phải được kích hoạt bằng cách thực thi ZZ0000ZZ đầu tiên. Tất cả các sự kiện đều tuân theo bố cục do ZZ0001ZZ quy định. Cụ thể các loại sự kiện có thể được xác định bằng mã sự kiện của chúng, được mô tả trong ZZ0002ZZ. Lưu ý rằng các mã sự kiện khác được dành riêng để sử dụng trong tương lai, do đó, trình phân tích sự kiện phải có khả năng xử lý mọi sự kiện không xác định/không được hỗ trợ các loại một cách duyên dáng, bằng cách dựa vào độ dài tải trọng được cung cấp trong tiêu đề sự kiện.

Các loại sự kiện hiện được cung cấp là:

Overview of DTX events.¶
Name	Code	Payload	Short Description
`SDTX_EVENT_REQUEST`	`1`	`0` bytes	Detachment process initiated/aborted.
`SDTX_EVENT_CANCEL`	`2`	`2` bytes	EC canceled detachment process.
`SDTX_EVENT_BASE_CONNECTION`	`3`	`4` bytes	Base connection state changed.
`SDTX_EVENT_LATCH_STATUS`	`4`	`2` bytes	Latch status changed.
`SDTX_EVENT_DEVICE_MODE`	`5`	`2` bytes	Device mode changed.

Các sự kiện riêng lẻ chi tiết hơn:

Field	Type	Description
`state`	`__u16`	Base connection state.
`base_id`	`__u16`	Type of base connected (zero if none).

Type	Number	Direction	Name	Description
`0xA5`	`0x21`	`-`	`EVENTS_ENABLE`	Enable events for the current file descriptor.
`0xA5`	`0x22`	`-`	`EVENTS_DISABLE`	Disable events for the current file descriptor.
`0xA5`	`0x23`	`-`	`LATCH_LOCK`	Lock the latch.
`0xA5`	`0x24`	`-`	`LATCH_UNLOCK`	Unlock the latch.
`0xA5`	`0x25`	`-`	`LATCH_REQUEST`	Request clipboard detachment.
`0xA5`	`0x26`	`-`	`LATCH_CONFIRM`	Confirm clipboard detachment request.
`0xA5`	`0x27`	`-`	`LATCH_HEARTBEAT`	Send heartbeat signal to EC.
`0xA5`	`0x28`	`-`	`LATCH_CANCEL`	Cancel detachment process.
`0xA5`	`0x29`	`R`	`GET_BASE_INFO`	Get current base/connection information.
`0xA5`	`0x2A`	`R`	`GET_DEVICE_MODE`	Get current device operation mode.
`0xA5`	`0x2B`	`R`	`GET_LATCH_STATUS`	Get current device latch status.