xref: /linux/Documentation/ABI/testing/sysfs-devices-platform-docg3 (revision cdd38c5f1ce4398ec58fec95904b75824daab7b5)
11f9327fcSRobert JarzmikWhat:		/sys/devices/platform/docg3/f[0-3]_dps[01]_is_keylocked
21f9327fcSRobert JarzmikDate:		November 2011
31f9327fcSRobert JarzmikKernelVersion:	3.3
41f9327fcSRobert JarzmikContact:	Robert Jarzmik <robert.jarzmik@free.fr>
51f9327fcSRobert JarzmikDescription:
61f9327fcSRobert Jarzmik		Show whether the floor (0 to 4), protection area (0 or 1) is
71f9327fcSRobert Jarzmik		keylocked. Each docg3 chip (or floor) has 2 protection areas,
81f9327fcSRobert Jarzmik		which can cover any part of it, block aligned, called DPS.
91f9327fcSRobert Jarzmik		The protection has information embedded whether it blocks reads,
101f9327fcSRobert Jarzmik		writes or both.
111f9327fcSRobert Jarzmik		The result is:
12*34433332SMauro Carvalho Chehab
13*34433332SMauro Carvalho Chehab		- 0 -> the DPS is not keylocked
14*34433332SMauro Carvalho Chehab		- 1 -> the DPS is keylocked
15*34433332SMauro Carvalho Chehab
161f9327fcSRobert JarzmikUsers:		None identified so far.
171f9327fcSRobert Jarzmik
181f9327fcSRobert JarzmikWhat:		/sys/devices/platform/docg3/f[0-3]_dps[01]_protection_key
191f9327fcSRobert JarzmikDate:		November 2011
201f9327fcSRobert JarzmikKernelVersion:	3.3
211f9327fcSRobert JarzmikContact:	Robert Jarzmik <robert.jarzmik@free.fr>
221f9327fcSRobert JarzmikDescription:
231f9327fcSRobert Jarzmik		Enter the protection key for the floor (0 to 4), protection area
241f9327fcSRobert Jarzmik		(0 or 1). Each docg3 chip (or floor) has 2 protection areas,
251f9327fcSRobert Jarzmik		which can cover any part of it, block aligned, called DPS.
261f9327fcSRobert Jarzmik		The protection has information embedded whether it blocks reads,
271f9327fcSRobert Jarzmik		writes or both.
281f9327fcSRobert Jarzmik		The protection key is a string of 8 bytes (value 0-255).
291f9327fcSRobert Jarzmik		Entering the correct value toggle the lock, and can be observed
301f9327fcSRobert Jarzmik		through f[0-3]_dps[01]_is_keylocked.
311f9327fcSRobert Jarzmik		Possible values are:
32*34433332SMauro Carvalho Chehab
331f9327fcSRobert Jarzmik			- 8 bytes
34*34433332SMauro Carvalho Chehab
351f9327fcSRobert Jarzmik		Typical values are:
36*34433332SMauro Carvalho Chehab
371f9327fcSRobert Jarzmik			- "00000000"
381f9327fcSRobert Jarzmik			- "12345678"
39*34433332SMauro Carvalho Chehab
401f9327fcSRobert JarzmikUsers:		None identified so far.
41