Blame view

kernel/linux-imx6_3.14.28/Documentation/ABI/testing/sysfs-class-mic.txt 6.07 KB
6b13f685e   김민수   BSP 최초 추가
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
  What:		/sys/class/mic/
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		The mic class directory belongs to Intel MIC devices and
  		provides information per MIC device. An Intel MIC device is a
  		PCIe form factor add-in Coprocessor card based on the Intel Many
  		Integrated Core (MIC) architecture that runs a Linux OS.
  
  What:		/sys/class/mic/mic(x)
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		The directories /sys/class/mic/mic0, /sys/class/mic/mic1 etc.,
  		represent MIC devices (0,1,..etc). Each directory has
  		information specific to that MIC device.
  
  What:		/sys/class/mic/mic(x)/family
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		Provides information about the Coprocessor family for an Intel
  		MIC device. For example - "x100"
  
  What:		/sys/class/mic/mic(x)/stepping
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		Provides information about the silicon stepping for an Intel
  		MIC device. For example - "A0" or "B0"
  
  What:		/sys/class/mic/mic(x)/state
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		When read, this entry provides the current state of an Intel
  		MIC device in the context of the card OS. Possible values that
  		will be read are:
  		"offline" - The MIC device is ready to boot the card OS. On
  		reading this entry after an OSPM resume, a "boot" has to be
  		written to this entry if the card was previously shutdown
  		during OSPM suspend.
  		"online" - The MIC device has initiated booting a card OS.
  		"shutting_down" - The card OS is shutting down.
  		"reset_failed" - The MIC device has failed to reset.
  		"suspending" - The MIC device is currently being prepared for
  		suspend. On reading this entry, a "suspend" has to be written
  		to the state sysfs entry to ensure the card is shutdown during
  		OSPM suspend.
  		"suspended" - The MIC device has been suspended.
  
  		When written, this sysfs entry triggers different state change
  		operations depending upon the current state of the card OS.
  		Acceptable values are:
  		"boot" - Boot the card OS image specified by the combination
  			 of firmware, ramdisk, cmdline and bootmode
  			sysfs entries.
  		"reset" - Initiates device reset.
  		"shutdown" - Initiates card OS shutdown.
  		"suspend" - Initiates card OS shutdown and also marks the card
  		as suspended.
  
  What:		/sys/class/mic/mic(x)/shutdown_status
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		An Intel MIC device runs a Linux OS during its operation. This
  		OS can shutdown because of various reasons. When read, this
  		entry provides the status on why the card OS was shutdown.
  		Possible values are:
  		"nop" -  shutdown status is not applicable, when the card OS is
  			"online"
  		"crashed" - Shutdown because of a HW or SW crash.
  		"halted" - Shutdown because of a halt command.
  		"poweroff" - Shutdown because of a poweroff command.
  		"restart" - Shutdown because of a restart command.
  
  What:		/sys/class/mic/mic(x)/cmdline
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		An Intel MIC device runs a Linux OS during its operation. Before
  		booting this card OS, it is possible to pass kernel command line
  		options to configure various features in it, similar to
  		self-bootable machines. When read, this entry provides
  		information about the current kernel command line options set to
  		boot the card OS. This entry can be written to change the
  		existing kernel command line options. Typically, the user would
  		want to read the current command line options, append new ones
  		or modify existing ones and then write the whole kernel command
  		line back to this entry.
  
  What:		/sys/class/mic/mic(x)/firmware
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		When read, this sysfs entry provides the path name under
  		/lib/firmware/ where the firmware image to be booted on the
  		card can be found. The entry can be written to change the
  		firmware image location under /lib/firmware/.
  
  What:		/sys/class/mic/mic(x)/ramdisk
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		When read, this sysfs entry provides the path name under
  		/lib/firmware/ where the ramdisk image to be used during card
  		OS boot can be found. The entry can be written to change
  		the ramdisk image location under /lib/firmware/.
  
  What:		/sys/class/mic/mic(x)/bootmode
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		When read, this sysfs entry provides the current bootmode for
  		the card. This sysfs entry can be written with the following
  		valid strings:
  		a) linux - Boot a Linux image.
  		b) elf - Boot an elf image for flash updates.
  
  What:		/sys/class/mic/mic(x)/log_buf_addr
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		An Intel MIC device runs a Linux OS during its operation. For
  		debugging purpose and early kernel boot messages, the user can
  		access the card OS log buffer via debugfs. When read, this entry
  		provides the kernel virtual address of the buffer where the card
  		OS log buffer can be read. This entry is written by the host
  		configuration daemon to set the log buffer address. The correct
  		log buffer address to be written can be found in the System.map
  		file of the card OS.
  
  What:		/sys/class/mic/mic(x)/log_buf_len
  Date:		October 2013
  KernelVersion:	3.13
  Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
  Description:
  		An Intel MIC device runs a Linux OS during its operation. For
  		debugging purpose and early kernel boot messages, the user can
  		access the card OS log buffer via debugfs. When read, this entry
  		provides the kernel virtual address where the card OS log buffer
  		length can be read. This entry is written by host configuration
  		daemon to set the log buffer length address. The correct log
  		buffer length address to be written can be found in the
  		System.map file of the card OS.