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
|
.. _OPAL_XSCOM_READ:
OPAL_XSCOM_READ
===============
.. code-block:: c
#define OPAL_XSCOM_READ 65
int xscom_read(uint32_t partid, uint64_t pcb_addr, uint64_t *val);
This low level call will read XSCOM values directly.
They should only be used by low level manufacturing/debug tools.
"Normal" host OS kernel code should not know about XSCOM.
This is also needed by HBRT/`opal-prd`.
Returns
-------
:ref:`OPAL_SUCCESS`
Success!
:ref:`OPAL_HARDWARE`
if operation failed
:ref:`OPAL_WRONG_STATE`
if CPU is asleep
:ref:`OPAL_XSCOM_BUSY`
Alias for :ref:`OPAL_BUSY`.
:ref:`OPAL_XSCOM_CHIPLET_OFF`
Alias for :ref:`OPAL_WRONG_STATE`
:ref:`OPAL_XSCOM_PARTIAL_GOOD`
XSCOM Partial Good
:ref:`OPAL_XSCOM_ADDR_ERROR`
XSCOM Address Error
:ref:`OPAL_XSCOM_CLOCK_ERROR`
XSCOM Clock Error
:ref:`OPAL_XSCOM_PARITY_ERROR`
XSCOM Parity Error
:ref:`OPAL_XSCOM_TIMEOUT`
XSCOM Timeout
:ref:`OPAL_XSCOM_CTR_OFFLINED`
XSCOM Controller Offlined due to too many errors.
.. _OPAL_XSCOM_WRITE:
OPAL_XSCOM_WRITE
================
.. code-block:: c
#define OPAL_XSCOM_WRITE 66
int xscom_write(uint32_t partid, uint64_t pcb_addr, uint64_t val);
This low level call will write an XSCOM value directly.
They should only be used by low level manufacturing/debug tools.
"Normal" host OS kernel code should not know about XSCOM.
This is also needed by HBRT/`opal-prd`.
Returns
-------
:ref:`OPAL_SUCCESS`
Success!
:ref:`OPAL_HARDWARE`
if operation failed
:ref:`OPAL_WRONG_STATE`
if CPU is asleep
:ref:`OPAL_XSCOM_BUSY`
Alias for :ref:`OPAL_BUSY`.
:ref:`OPAL_XSCOM_CHIPLET_OFF`
Alias for :ref:`OPAL_WRONG_STATE`
:ref:`OPAL_XSCOM_PARTIAL_GOOD`
XSCOM Partial Good
:ref:`OPAL_XSCOM_ADDR_ERROR`
XSCOM Address Error
:ref:`OPAL_XSCOM_CLOCK_ERROR`
XSCOM Clock Error
:ref:`OPAL_XSCOM_PARITY_ERROR`
XSCOM Parity Error
:ref:`OPAL_XSCOM_TIMEOUT`
XSCOM Timeout
:ref:`OPAL_XSCOM_CTR_OFFLINED`
XSCOM Controller Offlined due to too many errors.
|
