xref: /OK3568_Linux_fs/kernel/Documentation/hwmon/vexpress.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunKernel driver vexpress
2*4882a593Smuzhiyun======================
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunSupported systems:
5*4882a593Smuzhiyun
6*4882a593Smuzhiyun  * ARM Ltd. Versatile Express platform
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun    Prefix: 'vexpress'
9*4882a593Smuzhiyun
10*4882a593Smuzhiyun    Datasheets:
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun      * "Hardware Description" sections of the Technical Reference Manuals
13*4882a593Smuzhiyun	for the Versatile Express boards:
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun      * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
20*4882a593Smuzhiyun
21*4882a593SmuzhiyunAuthor: Pawel Moll
22*4882a593Smuzhiyun
23*4882a593SmuzhiyunDescription
24*4882a593Smuzhiyun-----------
25*4882a593Smuzhiyun
26*4882a593SmuzhiyunVersatile Express platform (http://www.arm.com/versatileexpress/) is a
27*4882a593Smuzhiyunreference & prototyping system for ARM Ltd. processors. It can be set up
28*4882a593Smuzhiyunfrom a wide range of boards, each of them containing (apart of the main
29*4882a593Smuzhiyunchip/FPGA) a number of microcontrollers responsible for platform
30*4882a593Smuzhiyunconfiguration and control. Theses microcontrollers can also monitor the
31*4882a593Smuzhiyunboard and its environment by a number of internal and external sensors,
32*4882a593Smuzhiyunproviding information about power lines voltages and currents, board
33*4882a593Smuzhiyuntemperature and power usage. Some of them also calculate consumed energy
34*4882a593Smuzhiyunand provide a cumulative use counter.
35*4882a593Smuzhiyun
36*4882a593SmuzhiyunThe configuration devices are _not_ memory mapped and must be accessed
37*4882a593Smuzhiyunvia a custom interface, abstracted by the "vexpress_config" API.
38*4882a593Smuzhiyun
39*4882a593SmuzhiyunAs these devices are non-discoverable, they must be described in a Device
40*4882a593SmuzhiyunTree passed to the kernel. Details of the DT binding for them can be found
41*4882a593Smuzhiyunin Documentation/devicetree/bindings/hwmon/vexpress.txt.
42