[mirror_ubuntu-eoan-kernel.git] / Documentation / ABI / testing / sysfs-driver-sunxi-sid

What:		/sys/devices/*/<our-device>/eeprom
Date:		August 2013
Contact:	Oliver Schinagl <oliver@schinagl.nl>
Description:	read-only access to the SID (Security-ID) on current
		A-series SoC's from Allwinner. Currently supports A10, A10s, A13
		and A20 CPU's. The earlier A1x series of SoCs exports 16 bytes,
		whereas the newer A20 SoC exposes 512 bytes split into sections.
		Besides the 16 bytes of SID, there's also an SJTAG area,
		HDMI-HDCP key and some custom keys. Below a quick overview, for
		details see the user manual:
		0x000  128 bit root-key (sun[457]i)
		0x010  128 bit boot-key (sun7i)
		0x020   64 bit security-jtag-key (sun7i)
		0x028   16 bit key configuration (sun7i)
		0x02b   16 bit custom-vendor-key (sun7i)
		0x02c  320 bit low general key (sun7i)
		0x040   32 bit read-control access (sun7i)
		0x064  224 bit low general key (sun7i)
		0x080 2304 bit HDCP-key (sun7i)
		0x1a0  768 bit high general key (sun7i)
Users:		any user space application which wants to read the SID on
		Allwinner's A-series of CPU's.
Commit	Line	Data
9fd379e9 OS	1	What: /sys/devices/*/<our-device>/eeprom
	2	Date: August 2013
	3	Contact: Oliver Schinagl <oliver@schinagl.nl>
	4	Description: read-only access to the SID (Security-ID) on current
	5	A-series SoC's from Allwinner. Currently supports A10, A10s, A13
	6	and A20 CPU's. The earlier A1x series of SoCs exports 16 bytes,
	7	whereas the newer A20 SoC exposes 512 bytes split into sections.
	8	Besides the 16 bytes of SID, there's also an SJTAG area,
	9	HDMI-HDCP key and some custom keys. Below a quick overview, for
	10	details see the user manual:
	11	0x000 128 bit root-key (sun[457]i)
	12	0x010 128 bit boot-key (sun7i)
	13	0x020 64 bit security-jtag-key (sun7i)
	14	0x028 16 bit key configuration (sun7i)
	15	0x02b 16 bit custom-vendor-key (sun7i)
	16	0x02c 320 bit low general key (sun7i)
	17	0x040 32 bit read-control access (sun7i)
	18	0x064 224 bit low general key (sun7i)
	19	0x080 2304 bit HDCP-key (sun7i)
	20	0x1a0 768 bit high general key (sun7i)
	21	Users: any user space application which wants to read the SID on
	22	Allwinner's A-series of CPU's.