pespin has submitted this change. (
https://gerrit.osmocom.org/c/osmo-pcu/+/36555?usp=email )
Change subject: doc: Introduce code architecture section with main class diagram
......................................................................
doc: Introduce code architecture section with main class diagram
This is useful to understand the data model in a quick gasp.
Change-Id: Ibf6dd6f7e4d6370ad40733820faa70f9e5bc0e7d
---
A doc/manuals/chapters/code-architecture.adoc
M doc/manuals/osmopcu-usermanual.adoc
2 files changed, 84 insertions(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
pespin: Looks good to me, approved
osmith: Looks good to me, but someone else must approve
laforge: Looks good to me, but someone else must approve
diff --git a/doc/manuals/chapters/code-architecture.adoc
b/doc/manuals/chapters/code-architecture.adoc
new file mode 100644
index 0000000..c3c0c70
--- /dev/null
+++ b/doc/manuals/chapters/code-architecture.adoc
@@ -0,0 +1,71 @@
+[[code_architecture]]
+== Code Architecture
+
+[[fig-code-architecture-general]]
+.General overview of main OsmoTRX components
+[graphviz]
+----
+digraph hierarchy {
+node[shape=record,style=filled,fillcolor=gray95]
+edge[dir=back, arrowtail=empty]
+
+PCU[label = "{gprs_pcu|+ pcu_sock_state\l+ bssgp\l+ bts_list[]\l}"]
+BTS[label = "{gprs_rlcmac_bts|+ gsm_sysinfo\l+ trx_list[]\l+ ms_list[]\l}"]
+TRX[label = "{gprs_rlcmac_bts_trx|+ul_tbfs[]\l+dl_tbfs[]\l}"]
+PDCH[label = "{gprs_rlcmac_pdch|+ is_enabled\l+ pdch_ulc\l+
assigned_usf_mask\l+ assigned_tfi_mask_(dl,ul)\l+ tbfs_dl[]\l+ tbfs_ul[]\l+
pagings[]\l}"]
+ULC[label = "{pdch_ulc|+ registered_polls[]\l}"]
+ULC_NODE[label = "{pdch_ulc_node|+ fn\l+ type\l}"]
+ULC_NODE_TBF_USF[label = "{pdch_ulc_node_tbf_usf|+ ul_tbf\l}"]
+ULC_NODE_TBF_POLL[label = "{pdch_ulc_node_tbf_poll|+ poll_tbf (UL/DL)\l+
reason\l}"]
+ULC_NODE_SBA[label = "{pdch_ulc_node_sba|+ sba\l}"]
+MS[label = "{GprsMs|+ imsi, tlli, ta...\l+ refcount\l+ current_trx\l+
first_common_ts\l+ llc_queue\l}"]
+TBF[label = "{gprs_rlcmac_tbf|+ tfi\l+ egprs_enabled\l+ control_ts\l+
pdch[]\l+ ul_ass_fsm\l+ dl_ass_fsm\l+ window\l+ llc_frame\l+ rlc_blocks\l}"]
+UL_TBF[label = "{gprs_rlcmac_ul_tbf|+ state_fsm\l+ ul_ack_fsm\l+ usf[]\l}"]
+DL_TBF[label = "{gprs_rlcmac_dl_tbf|+ state_fsm\l}"]
+SBA[label = "{gprs_rlcmac_sba|+ pdch\l+ fn\l+ ta\l}"]
+RLC_WINDOW[label = "{gprs_rlcmac_window|+ sns\l+ ws\l}"]
+RLC_WINDOW_UL[label = "{gprs_rlcmac_window_ul|+ v_r\l+ v_q\l+ v_n[]\l}"]
+RLC_WINDOW_DL[label = "{gprs_rlcmac_window_dl|+ v_s\l+ v_a\l+ v_b[]\l}"]
+LLC_QUEUE[label = "{gprs_llc_queue|+ prio_queues[]\l}"]
+LLC_PRIO_QUEUE[label = "{gprs_llc_prio_queue|+ codel_state\l+ priority\l+
frames[]\l}"]
+LLC_FRAME[label = "{gprs_llc_frame|+ payload[]\l+ priority\l}"]
+RLC_BLOCK[label = "{gprs_rlcmac_rlc_block|...}"]
+
+PCU -> BTS [headlabel="*", taillabel="1"]
+BTS -> TRX [headlabel="0..8", taillabel="1"]
+BTS -> MS [headlabel="*", taillabel="1"]
+TRX -> PDCH [headlabel="0..8", taillabel="1"]
+
+PDCH -> ULC [headlabel="1", taillabel="0..1"]
+ULC -> ULC_NODE [headlabel="*", taillabel="1"]
+ULC_NODE -> ULC_NODE_TBF_USF [arrowtail=odiamond]
+ULC_NODE -> ULC_NODE_TBF_POLL [arrowtail=odiamond]
+ULC_NODE -> ULC_NODE_SBA [arrowtail=odiamond]
+ULC_NODE_SBA -> SBA[headlabel="1", taillabel="1"]
+
+TBF -> UL_TBF [arrowtail=odiamond]
+TBF -> DL_TBF [arrowtail=odiamond]
+
+RLC_WINDOW -> RLC_WINDOW_UL [arrowtail=odiamond]
+RLC_WINDOW -> RLC_WINDOW_DL [arrowtail=odiamond]
+
+MS -> TBF [headlabel="*", taillabel="1"]
+
+MS -> LLC_QUEUE [headlabel="1", taillabel="1"]
+LLC_QUEUE -> LLC_PRIO_QUEUE [headlabel="*", taillabel="1"]
+LLC_PRIO_QUEUE -> LLC_FRAME [headlabel="*", taillabel="1"]
+
+TBF -> RLC_WINDOW [headlabel="*", taillabel="1"]
+TBF -> LLC_FRAME [headlabel="0..1", taillabel="1"]
+TBF -> RLC_BLOCK [headlabel="*", taillabel="1"]
+
+TRX -> MS [headlabel="*", taillabel="1", style=dashed, arrowtail=none,
label="assigned"]
+TBF -> PDCH [headlabel="0..8", taillabel="1", style=dashed, arrowtail=none,
label="assigned"]
+
+UL_TBF -> ULC_NODE_TBF_USF [style=dashed, arrowtail=none, label="registered"]
+TBF -> ULC_NODE_TBF_POLL [style=dashed, arrowtail=none, label="registered"]
+
+TRX -> UL_TBF [headlabel="*", taillabel="1", style=dashed, label="assigned"]
+TRX -> DL_TBF [headlabel="*", taillabel="1", style=dashed, label="assigned"]
+}
+----
diff --git a/doc/manuals/osmopcu-usermanual.adoc
b/doc/manuals/osmopcu-usermanual.adoc
index 0fae72a..3a63ac3 100644
--- a/doc/manuals/osmopcu-usermanual.adoc
+++ b/doc/manuals/osmopcu-usermanual.adoc
@@ -19,6 +19,8 @@
include::{srcdir}/chapters/counters.adoc[]
+include::{srcdir}/chapters/code-architecture.adoc[]
+
include::./common/chapters/gb.adoc[]
include::./common/chapters/qos-dscp-pcp.adoc[]
--
To view, visit https://gerrit.osmocom.org/c/osmo-pcu/+/36555?usp=email
To unsubscribe, or for help writing mail filters, visit
https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-pcu
Gerrit-Branch: master
Gerrit-Change-Id: Ibf6dd6f7e4d6370ad40733820faa70f9e5bc0e7d
Gerrit-Change-Number: 36555
Gerrit-PatchSet: 2
Gerrit-Owner: pespin <pes...@sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: fixeria <vyanits...@sysmocom.de>
Gerrit-Reviewer: jolly <andr...@eversberg.eu>
Gerrit-Reviewer: laforge <lafo...@osmocom.org>
Gerrit-Reviewer: osmith <osm...@sysmocom.de>
Gerrit-Reviewer: pespin <pes...@sysmocom.de>
Gerrit-MessageType: merged
