ABI: sysfs-platform-dell-privacy-wmi: correct ABI entries
[sfrench/cifs-2.6.git] / Documentation / ABI / testing / sysfs-platform-dell-privacy-wmi
1 What:           /sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type
2 Date:           Apr 2021
3 KernelVersion:  5.13
4 Contact:        "<perry.yuan@dell.com>"
5 Description:
6                 Display which dell hardware level privacy devices are supported
7                 “Dell Privacy” is a set of HW, FW, and SW features to enhance
8                 Dell’s commitment to platform privacy for MIC, Camera, and
9                 ePrivacy screens.
10                 The supported hardware privacy devices are:
11
12                 Attributes:
13                         Microphone Mute:
14                                 Identifies the local microphone can be muted by hardware, no applications
15                                 is available to capture system mic sound
16
17                         Camera Shutter:
18                                 Identifies camera shutter controlled by hardware, which is a micromechanical
19                                 shutter assembly that is built onto the camera module to block capturing images
20                                 from outside the laptop
21
22                 Values:
23
24                         supported:
25                                 The privacy device is supported by this system
26
27                         unsupported:
28                                 The privacy device is not supported on this system
29
30                 For example to check which privacy devices are supported::
31
32                     # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type
33                     [Microphone Mute] [supported]
34                     [Camera Shutter] [supported]
35                     [ePrivacy Screen] [unsupported]
36
37 What:           /sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state
38 Date:           Apr 2021
39 KernelVersion:  5.13
40 Contact:        "<perry.yuan@dell.com>"
41 Description:
42                 Allow user space to check current dell privacy device state.
43                 Describes the Device State class exposed by BIOS which can be
44                 consumed by various applications interested in knowing the Privacy
45                 feature capabilities
46
47                 Attributes:
48                         Microphone:
49                                 Identifies the local microphone can be muted by hardware, no applications
50                                 is available to capture system mic sound
51
52                         Camera Shutter:
53                                 Identifies camera shutter controlled by hardware, which is a micromechanical
54                                 shutter assembly that is built onto the camera module to block capturing images
55                                 from outside the laptop
56
57                 Values:
58                         muted:
59                                 Identifies the privacy device is turned off
60                                 and cannot send stream to OS applications
61
62                         unmuted:
63                                 Identifies the privacy device is turned on,
64                                 audio or camera driver can get stream from mic
65                                 and camera module to OS applications
66
67                 For example to check all supported current privacy device states::
68
69                     # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state
70                     [Microphone] [unmuted]
71                     [Camera Shutter] [unmuted]