xref: /linux/Documentation/ABI/testing/debugfs-wilco-ec (revision b787bb126cbcd73754bcbc055ae9f804ac576e4a)
1*b787bb12SNick CrewsWhat:		/sys/kernel/debug/wilco_ec/raw
2*b787bb12SNick CrewsDate:		January 2019
3*b787bb12SNick CrewsKernelVersion:	5.1
4*b787bb12SNick CrewsDescription:
5*b787bb12SNick Crews		Write and read raw mailbox commands to the EC.
6*b787bb12SNick Crews
7*b787bb12SNick Crews		For writing:
8*b787bb12SNick Crews		Bytes 0-1 indicate the message type:
9*b787bb12SNick Crews			00 F0 = Execute Legacy Command
10*b787bb12SNick Crews			00 F2 = Read/Write NVRAM Property
11*b787bb12SNick Crews		Byte 2 provides the command code
12*b787bb12SNick Crews		Bytes 3+ consist of the data passed in the request
13*b787bb12SNick Crews
14*b787bb12SNick Crews		At least three bytes are required, for the msg type and command,
15*b787bb12SNick Crews		with additional bytes optional for additional data.
16*b787bb12SNick Crews
17*b787bb12SNick Crews		Example:
18*b787bb12SNick Crews		// Request EC info type 3 (EC firmware build date)
19*b787bb12SNick Crews		$ echo 00 f0 38 00 03 00 > raw
20*b787bb12SNick Crews		// View the result. The decoded ASCII result "12/21/18" is
21*b787bb12SNick Crews		// included after the raw hex.
22*b787bb12SNick Crews		$ cat raw
23*b787bb12SNick Crews		00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  .12/21/18.8...
24