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