Skip to content

Commit 314dace

Browse files
committed
[ot] docs/opentitan: ot_eg_pad_ring.md: Add docs
Add initial pad ring documentation (only for the PoR signal, and how to use it, for now). Signed-off-by: Alex Jones <[email protected]>
1 parent 4ab62be commit 314dace

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

docs/opentitan/ot_eg_pad_ring.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# OpenTitan Earl Grey Pad Ring
2+
3+
## Power-on Reset (POR)
4+
5+
The Earl Grey Pad Ring currently only supports the negated Power-on Reset (PoR) pad, which can
6+
be signalled by setting the `por_n` property and resetting the VM to perform a Power-on Reset.
7+
This can for example be done with the QEMU Monitor via the following command sequence:
8+
```
9+
> qom-set ot-eg-pad-ring.0 por_n low
10+
> system_reset
11+
> qom-set ot-eg-pad-ring.0 por_n high
12+
```
13+
14+
Equivalent QMP JSON commands can also be used.
15+
16+
Note that the current implementation directly invokes a reset request on any reset where a falling
17+
edge is detected (i.e. the reset strapping is asserted), and it is not well supported to "hold" the
18+
device in reset. If it is desired to emulate this time, you should stop and resume the VM for
19+
for the duration of the reset, e.g.:
20+
```
21+
/* Asserting the POR signal */
22+
> stop
23+
> qom-set ot-eg-pad-ring.0 por_n low
24+
> system_reset
25+
/* ... wait for the duration of the reset ... */
26+
/* De-asserting the POR signal */
27+
> qom-set ot-eg-pad-ring.0 por_n high
28+
> cont
29+
```
30+
31+
## MIO Pads
32+
33+
Currently, Earl Grey's MIO pads are not connected in the Pad Ring / Pinmux.

0 commit comments

Comments
 (0)