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
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<title>XSCOM Bindings — skiboot 09fb954
documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="_static/classic.css" />
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="P9 XIVE Exploitation" href="xive.html" />
<link rel="prev" title="PCI Slots" href="pci-slot.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="xive.html" title="P9 XIVE Exploitation"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="pci-slot.html" title="PCI Slots"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">skiboot 09fb954
documentation</a> »</li>
<li class="nav-item nav-item-this"><a href="">XSCOM Bindings</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="xscom-bindings">
<h1>XSCOM Bindings<a class="headerlink" href="#xscom-bindings" title="Permalink to this headline">¶</a></h1>
<section id="xscom-regions">
<h2>XSCOM regions<a class="headerlink" href="#xscom-regions" title="Permalink to this headline">¶</a></h2>
<p>The top-level xscom nodes specify the mapping range from the 64-bit address
space into the PCB address space.</p>
<p>There’s one mapping range per chip xscom, therefore one node per mapping range.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>/
/xscom@<chip-base-address-0>/
/xscom@<chip-base-address-1>/
…
/xscom@<chip-base-address-n>/
</pre></div>
</div>
<ul class="simple">
<li><p>where <chip-base-address-n> is the xscom base address with the gcid-specific
bits (for chip n) OR-ed in.</p></li>
</ul>
<p>Each xscom node has the following properties:</p>
<blockquote>
<div><ul class="simple">
<li><p>#address-cells = 1</p></li>
<li><p>#size-cells = 1</p></li>
<li><p>reg = <base-address[#parent-address-cells] size[#parent-size-cells]></p></li>
<li><p>ibm,chip-id = gcid</p></li>
<li><p>compatible = “ibm,xscom”, “ibm,power8-scom” / “ibm,power7-xscom”</p></li>
<li><p>ecid = <Electronic Chip ID, applicable for POWER9 onwards></p></li>
<li><p>wafer-id = <wafer ID, applicable for POWER9 onwards></p></li>
<li><p>wafer-location = <wafer location, applicable for POWER9 onwards></p></li>
</ul>
</div></blockquote>
</section>
<section id="ecid">
<h2>ECID<a class="headerlink" href="#ecid" title="Permalink to this headline">¶</a></h2>
<p>Electronic Chip ID (ECID) is a process by which the wafer number, chip location
(i.e. X,Y) and other optional data items are electrically encoded directly on
the chip. wafer-id property represents wafer number and wafer-location property
represents chip location (both X and Y location).</p>
</section>
<section id="chiplet-endpoints">
<h2>Chiplet endpoints<a class="headerlink" href="#chiplet-endpoints" title="Permalink to this headline">¶</a></h2>
<p>One sub-node per endpoint. Endpoints are defined by their (port,
endpoint-address) data on the PCB, and are named according to their endpoint
types:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">/</span><span class="n">xscom</span><span class="o">@<</span><span class="n">chip</span><span class="o">-</span><span class="n">base</span><span class="o">-</span><span class="n">address</span><span class="o">>/</span>
<span class="o">/</span><span class="n">xscom</span><span class="o">@<</span><span class="n">chip</span><span class="o">-</span><span class="n">base</span><span class="o">-</span><span class="n">address</span><span class="o">>/</span><span class="n">chiptod</span><span class="o">@<</span><span class="n">endpoint</span><span class="o">-</span><span class="n">addr</span><span class="o">></span>
<span class="o">/</span><span class="n">xscom</span><span class="o">@<</span><span class="n">chip</span><span class="o">-</span><span class="n">base</span><span class="o">-</span><span class="n">address</span><span class="o">>/</span><span class="n">lpc</span><span class="o">@<</span><span class="n">endpoint</span><span class="o">-</span><span class="n">addr</span><span class="o">></span>
</pre></div>
</div>
<ul class="simple">
<li><p>where the <endpoint-addr> is a single address (as distinct from the current
(gcid,base) format), consisting of the SCOM port and SCOM endpoint bits in
their 31-bit address format.</p></li>
</ul>
<p>Each endpoint node has the following properties:</p>
<blockquote>
<div><ul class="simple">
<li><p>reg = <endpoint-address[#parent-address-cells] size[#parent-size-cells]></p></li>
<li><p>compatible - depends on endpoint type, eg “ibm,power8-chiptod”</p></li>
</ul>
</div></blockquote>
<p>The endpoint address specifies the address on the PCB. So, to calculate the
MMIO address for a PCB register:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">mmio_addr</span> <span class="o">=</span> <span class="o"><</span><span class="n">xscom</span><span class="o">-</span><span class="n">base</span><span class="o">-</span><span class="n">addr</span><span class="o">></span> <span class="o">|</span> <span class="p">(</span><span class="n">pcb_addr</span><span class="p">[</span><span class="mi">1</span><span class="p">:</span><span class="mi">27</span><span class="p">]</span> <span class="o"><<</span> <span class="mi">4</span><span class="p">)</span>
<span class="o">|</span> <span class="p">(</span><span class="n">pcb_addr</span><span class="p">[</span><span class="mi">28</span><span class="p">:</span><span class="mi">31</span><span class="p">]</span> <span class="o"><<</span> <span class="mi">3</span><span class="p">)</span>
</pre></div>
</div>
<p>Where:</p>
<blockquote>
<div><ul class="simple">
<li><p>xscom-base-addr is the address from the first two cells of the parent
node’s reg property</p></li>
<li><p>pcb_addr is the first cell of the endpoint’s reg property</p></li>
</ul>
</div></blockquote>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">XSCOM Bindings</a><ul>
<li><a class="reference internal" href="#xscom-regions">XSCOM regions</a></li>
<li><a class="reference internal" href="#ecid">ECID</a></li>
<li><a class="reference internal" href="#chiplet-endpoints">Chiplet endpoints</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="pci-slot.html"
title="previous chapter">PCI Slots</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="xive.html"
title="next chapter">P9 XIVE Exploitation</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/xscom-node-bindings.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="xive.html" title="P9 XIVE Exploitation"
>next</a> |</li>
<li class="right" >
<a href="pci-slot.html" title="PCI Slots"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">skiboot 09fb954
documentation</a> »</li>
<li class="nav-item nav-item-this"><a href="">XSCOM Bindings</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2016-2017, IBM, others.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.3.2.
</div>
</body>
</html>
|
