doc: posix: add visualization diagram for aep, si, pse51-pse53

Add a diagram that was first created for eoss 2024 to help
visualize the relation between the different application
environment profiles of IEEE 1003.13-2003.

Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
This commit is contained in:
Chris Friedt 2024-04-24 17:35:26 -04:00 committed by Carles Cufí
parent c0dc8d1426
commit 35429debb6
7 changed files with 120 additions and 0 deletions

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" width="225.805" height="225.805" viewBox="-112.9025 -112.9025 225.805 225.805" xmlns="http://www.w3.org/2000/svg">
<circle cx="0" fill="#e6e5e3" opacity="0.5" r="100"/>
<circle cx="25" fill="#e6e5e3" opacity="0.5" r="75"/>
<circle cx="50" fill="#d9913c" r="50"/>
<circle cx="75" fill="#e6e5e3" opacity="0.5" r="25"/>
/* TODO: Change color based on dark / light modes */
<g font-family="Arial" font-size="10" text-anchor="middle">
<text y="8">
<tspan x="75" dy="-1.2em">System</tspan>
<tspan x="75" dy="1.2em">Interfaces</tspan>
</text>
<text x="25">PSE51</text>
<text x="-25">PSE52</text>
<text x="-75">PSE53</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 732 B

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" width="225.805" height="225.805" viewBox="-112.9025 -112.9025 225.805 225.805" xmlns="http://www.w3.org/2000/svg">
<circle cx="0" fill="#e6e5e3" opacity="0.5" r="100"/>
<circle cx="25" fill="#f04f5e" r="75"/>
<circle cx="50" fill="#e6e5e3" opacity="0.5" r="50"/>
<circle cx="75" fill="#e6e5e3" opacity="0.5" r="25"/>
/* TODO: Change color based on dark / light modes */
<g font-family="Arial" font-size="10" text-anchor="middle">
<text y="8">
<tspan x="75" dy="-1.2em">System</tspan>
<tspan x="75" dy="1.2em">Interfaces</tspan>
</text>
<text x="25">PSE51</text>
<text x="-25">PSE52</text>
<text x="-75">PSE53</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 732 B

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" width="225.805" height="225.805" viewBox="-112.9025 -112.9025 225.805 225.805" xmlns="http://www.w3.org/2000/svg">
<circle cx="0" fill="#786bb0" r="100"/>
<circle cx="25" fill="#e6e5e3" opacity="0.5" r="75"/>
<circle cx="50" fill="#e6e5e3" opacity="0.5" r="50"/>
<circle cx="75" fill="#e6e5e3" opacity="0.5" r="25"/>
/* TODO: Change color based on dark / light modes */
<g font-family="Arial" font-size="10" text-anchor="middle">
<text y="8">
<tspan x="75" dy="-1.2em">System</tspan>
<tspan x="75" dy="1.2em">Interfaces</tspan>
</text>
<text x="25">PSE51</text>
<text x="-25">PSE52</text>
<text x="-75">PSE53</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 732 B

View file

@ -14,6 +14,13 @@ System Interfaces
The required POSIX :ref:`System Interfaces<posix_system_interfaces_required>` are supported for
each Application Environment Profile.
.. figure:: si.svg
:align: center
:scale: 150%
:alt: Required System Interfaces
System Interfaces
.. _posix_aep_pse51:
Minimal Realtime System Profile (PSE51)
@ -22,6 +29,13 @@ Minimal Realtime System Profile (PSE51)
The *Minimal Realtime System Profile* (PSE51) includes all of the
:ref:`System Interfaces<posix_system_interfaces_required>` along with several additional features.
.. figure:: aep-pse51.svg
:align: center
:scale: 150%
:alt: Minimal Realtime System Profile (PSE51)
Minimal Realtime System Profile (PSE51)
.. Conforming implementations shall define _POSIX_AEP_REALTIME_MINIMAL to the value 200312L
.. csv-table:: PSE51 System Interfaces
@ -68,6 +82,13 @@ Realtime Controller System Profile (PSE52)
The *Realtime Controller System Profile* (PSE52) includes all features from PSE51 and the
:ref:`System Interfaces<posix_system_interfaces_required>`.
.. figure:: aep-pse52.svg
:align: center
:scale: 150%
:alt: Realtime Controller System Profile (PSE52)
Realtime Controller System Profile (PSE52)
.. Conforming implementations shall define _POSIX_AEP_REALTIME_CONTROLLER to the value 200312L
.. csv-table:: PSE52 System Interfaces
@ -101,6 +122,13 @@ Dedicated Realtime System Profile (PSE53)
The *Dedicated Realtime System Profile* (PSE53) includes all features from PSE52, PSE51, and the
:ref:`System Interfaces<posix_system_interfaces_required>`.
.. figure:: aep-pse53.svg
:align: center
:scale: 150%
:alt: Dedicated Realtime System Profile (PSE53)
Dedicated Realtime System Profile (PSE53)
.. Conforming implementations shall define _POSIX_AEP_REALTIME_DEDICATED to the value 200312L
.. csv-table:: PSE53 System Interfaces

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" width="225.805" height="225.805" viewBox="-112.9025 -112.9025 225.805 225.805" xmlns="http://www.w3.org/2000/svg">
<circle cx="0" fill="#e6e5e3" opacity="0.5" r="100"/>
<circle cx="25" fill="#e6e5e3" opacity="0.5" r="75"/>
<circle cx="50" fill="#e6e5e3" opacity="0.5" r="50"/>
<circle cx="75" fill="#19c3ea" r="25"/>
/* TODO: Change color based on dark / light modes */
<g font-family="Arial" font-size="10" text-anchor="middle">
<text y="8">
<tspan x="75" dy="-1.2em">System</tspan>
<tspan x="75" dy="1.2em">Interfaces</tspan>
</text>
<text x="25">PSE51</text>
<text x="-25">PSE52</text>
<text x="-75">PSE53</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 732 B

View file

@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" width="225.805" height="225.805" viewBox="-112.9025 -112.9025 225.805 225.805" xmlns="http://www.w3.org/2000/svg">
<circle cx="0" fill="#786bb0" r="100"/>
<circle cx="25" fill="#f04f5e" r="75"/>
<circle cx="50" fill="#d9913c" r="50"/>
<circle cx="75" fill="#19c3ea" r="25"/>
/* TODO: Change color based on dark / light modes */
<g font-family="Arial" font-size="10" text-anchor="middle">
<text y="8">
<tspan x="75" dy="-1.2em">System</tspan>
<tspan x="75" dy="1.2em">Interfaces</tspan>
</text>
<text x="25">PSE51</text>
<text x="-25">PSE52</text>
<text x="-75">PSE53</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 690 B

View file

@ -54,6 +54,13 @@ For that reason, POSIX defined the following :ref:`Application Environment Profi
as part of `IEEE 1003.13-2003`_ (also known as POSIX.13-2003). Each AEP adds incrementally more
features over the required :ref:`POSIX System Interfaces <posix_system_interfaces>`.
.. figure:: aep.svg
:align: center
:scale: 150%
:alt: POSIX Application Environment Profiles (AEP)
POSIX Application Environment Profiles (AEP)
* Minimal Realtime System Profile (:ref:`PSE51 <posix_aep_pse51>`)
* Realtime Controller System Profile (:ref:`PSE52 <posix_aep_pse52>`)
* Dedicated Realtime System Profile (:ref:`PSE53 <posix_aep_pse53>`)