xref: /OK3568_Linux_fs/kernel/Documentation/ABI/testing/sysfs-devices-platform-docg3 (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunWhat:		/sys/devices/platform/docg3/f[0-3]_dps[01]_is_keylocked
2*4882a593SmuzhiyunDate:		November 2011
3*4882a593SmuzhiyunKernelVersion:	3.3
4*4882a593SmuzhiyunContact:	Robert Jarzmik <robert.jarzmik@free.fr>
5*4882a593SmuzhiyunDescription:
6*4882a593Smuzhiyun		Show whether the floor (0 to 4), protection area (0 or 1) is
7*4882a593Smuzhiyun		keylocked. Each docg3 chip (or floor) has 2 protection areas,
8*4882a593Smuzhiyun		which can cover any part of it, block aligned, called DPS.
9*4882a593Smuzhiyun		The protection has information embedded whether it blocks reads,
10*4882a593Smuzhiyun		writes or both.
11*4882a593Smuzhiyun		The result is:
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun		- 0 -> the DPS is not keylocked
14*4882a593Smuzhiyun		- 1 -> the DPS is keylocked
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunUsers:		None identified so far.
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunWhat:		/sys/devices/platform/docg3/f[0-3]_dps[01]_protection_key
19*4882a593SmuzhiyunDate:		November 2011
20*4882a593SmuzhiyunKernelVersion:	3.3
21*4882a593SmuzhiyunContact:	Robert Jarzmik <robert.jarzmik@free.fr>
22*4882a593SmuzhiyunDescription:
23*4882a593Smuzhiyun		Enter the protection key for the floor (0 to 4), protection area
24*4882a593Smuzhiyun		(0 or 1). Each docg3 chip (or floor) has 2 protection areas,
25*4882a593Smuzhiyun		which can cover any part of it, block aligned, called DPS.
26*4882a593Smuzhiyun		The protection has information embedded whether it blocks reads,
27*4882a593Smuzhiyun		writes or both.
28*4882a593Smuzhiyun		The protection key is a string of 8 bytes (value 0-255).
29*4882a593Smuzhiyun		Entering the correct value toggle the lock, and can be observed
30*4882a593Smuzhiyun		through f[0-3]_dps[01]_is_keylocked.
31*4882a593Smuzhiyun		Possible values are:
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun			- 8 bytes
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun		Typical values are:
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun			- "00000000"
38*4882a593Smuzhiyun			- "12345678"
39*4882a593Smuzhiyun
40*4882a593SmuzhiyunUsers:		None identified so far.
41