xref: /linux/Documentation/ABI/testing/sysfs-platform-dell-privacy-wmi (revision 03ab8e6297acd1bc0eedaa050e2a1635c576fd11)
18af9fa37SPerry YuanWhat:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type
28af9fa37SPerry YuanDate:		Apr 2021
38af9fa37SPerry YuanKernelVersion:	5.13
4*2166cc26SMauro Carvalho ChehabContact:	"<perry.yuan@dell.com>"
58af9fa37SPerry YuanDescription:
68af9fa37SPerry Yuan		Display which dell hardware level privacy devices are supported
78af9fa37SPerry Yuan		“Dell Privacy” is a set of HW, FW, and SW features to enhance
88af9fa37SPerry Yuan		Dell’s commitment to platform privacy for MIC, Camera, and
98af9fa37SPerry Yuan		ePrivacy screens.
108af9fa37SPerry Yuan		The supported hardware privacy devices are:
11*2166cc26SMauro Carvalho Chehab
128af9fa37SPerry Yuan		Attributes:
138af9fa37SPerry Yuan			Microphone Mute:
148af9fa37SPerry Yuan				Identifies the local microphone can be muted by hardware, no applications
158af9fa37SPerry Yuan				is available to capture system mic sound
168af9fa37SPerry Yuan
178af9fa37SPerry Yuan			Camera Shutter:
188af9fa37SPerry Yuan				Identifies camera shutter controlled by hardware, which is a micromechanical
198af9fa37SPerry Yuan				shutter assembly that is built onto the camera module to block capturing images
208af9fa37SPerry Yuan				from outside the laptop
218af9fa37SPerry Yuan
22*2166cc26SMauro Carvalho Chehab		Values:
23*2166cc26SMauro Carvalho Chehab
248af9fa37SPerry Yuan			supported:
258af9fa37SPerry Yuan				The privacy device is supported by this system
268af9fa37SPerry Yuan
278af9fa37SPerry Yuan			unsupported:
288af9fa37SPerry Yuan				The privacy device is not supported on this system
298af9fa37SPerry Yuan
30*2166cc26SMauro Carvalho Chehab		For example to check which privacy devices are supported::
318af9fa37SPerry Yuan
328af9fa37SPerry Yuan		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type
338af9fa37SPerry Yuan		    [Microphone Mute] [supported]
348af9fa37SPerry Yuan		    [Camera Shutter] [supported]
358af9fa37SPerry Yuan		    [ePrivacy Screen] [unsupported]
368af9fa37SPerry Yuan
378af9fa37SPerry YuanWhat:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state
388af9fa37SPerry YuanDate:		Apr 2021
398af9fa37SPerry YuanKernelVersion:	5.13
40*2166cc26SMauro Carvalho ChehabContact:	"<perry.yuan@dell.com>"
418af9fa37SPerry YuanDescription:
428af9fa37SPerry Yuan		Allow user space to check current dell privacy device state.
438af9fa37SPerry Yuan		Describes the Device State class exposed by BIOS which can be
448af9fa37SPerry Yuan		consumed by various applications interested in knowing the Privacy
458af9fa37SPerry Yuan		feature capabilities
46*2166cc26SMauro Carvalho Chehab
478af9fa37SPerry Yuan		Attributes:
48*2166cc26SMauro Carvalho Chehab			Microphone:
49*2166cc26SMauro Carvalho Chehab				Identifies the local microphone can be muted by hardware, no applications
50*2166cc26SMauro Carvalho Chehab				is available to capture system mic sound
51*2166cc26SMauro Carvalho Chehab
52*2166cc26SMauro Carvalho Chehab			Camera Shutter:
53*2166cc26SMauro Carvalho Chehab				Identifies camera shutter controlled by hardware, which is a micromechanical
54*2166cc26SMauro Carvalho Chehab				shutter assembly that is built onto the camera module to block capturing images
55*2166cc26SMauro Carvalho Chehab				from outside the laptop
56*2166cc26SMauro Carvalho Chehab
57*2166cc26SMauro Carvalho Chehab		Values:
588af9fa37SPerry Yuan			muted:
59*2166cc26SMauro Carvalho Chehab				Identifies the privacy device is turned off
60*2166cc26SMauro Carvalho Chehab				and cannot send stream to OS applications
618af9fa37SPerry Yuan
628af9fa37SPerry Yuan			unmuted:
63*2166cc26SMauro Carvalho Chehab				Identifies the privacy device is turned on,
64*2166cc26SMauro Carvalho Chehab				audio or camera driver can get stream from mic
65*2166cc26SMauro Carvalho Chehab				and camera module to OS applications
668af9fa37SPerry Yuan
67*2166cc26SMauro Carvalho Chehab		For example to check all supported current privacy device states::
688af9fa37SPerry Yuan
698af9fa37SPerry Yuan		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state
708af9fa37SPerry Yuan		    [Microphone] [unmuted]
718af9fa37SPerry Yuan		    [Camera Shutter] [unmuted]
72