Skip to content

Commit bee44cc

Browse files
authored
Update doc plantuml (#35)
* Update cellular library to MIT license * Update doc plantuml * Remove unused images in doc
1 parent 195e640 commit bee44cc

12 files changed

+119
-105
lines changed

doc/plantuml/cellular_URC_handler_implementation.txt renamed to doc/plantuml/cellular_URC_handler_implementation.pn

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
@startuml
2+
13
Title FreeRTOS Cellular Library URC handler implementation
24

35
participant Application
@@ -16,3 +18,5 @@ Cellular_modules_porting ->Application : Call the callback function registered i
1618
Cellular_modem ->Cellular_common : "+CREG: 2,0"
1719
Cellular_common -> Cellular_common : Call the callback function\nCellular_CommonUrcProcessCreg( pContext, "+CREG: 2,0" )
1820
Cellular_common->Application : callback function registered in\nCellular_RegisterUrcNetworkRegistrationEventCallback()
21+
22+
@enduml

doc/plantuml/cellular_api_implementation.txt renamed to doc/plantuml/cellular_api_implementation.pu

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
1+
@startuml
2+
13
Title FreeRTOS Cellular Library API implementation
24

35
participant Application
4-
participant FreeRTOS Cellular Library
6+
participant "FreeRTOS Cellular Library"
57
participant Cellular_modules_porting
68
participant Cellular_common
79
participant Cellular_modem
810

9-
Application ->FreeRTOS Cellular Library : Cellular_GetSimCardStatus()
11+
Application ->"FreeRTOS Cellular Library" : Cellular_GetSimCardStatus()
1012

11-
FreeRTOS Cellular Library->Cellular_modules_porting :Cellular_GetSimCardStatus()
13+
"FreeRTOS Cellular Library"->Cellular_modules_porting :Cellular_GetSimCardStatus()
1214

1315
Cellular_modules_porting->Cellular_common:Get module context passed in Cellular_ModuleInt() :\n_Cellular_GetModuleContext()
1416

@@ -26,4 +28,4 @@ Cellular_common ->Cellular_modules_porting : Call the callback function with cor
2628

2729
Cellular_modules_porting ->Application : Return parsing status and data
2830

29-
31+
@enduml
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
@startuml
2+
3+
Title FreeRTOS Cellular Library interaction with cellular module porting APIs
4+
5+
participant Application
6+
participant "FreeRTOS Cellular Library"
7+
participant Cellular_common
8+
participant Cellular_modules_porting
9+
10+
Application ->"FreeRTOS Cellular Library" : Cellular_Init()
11+
12+
"FreeRTOS Cellular Library" -> Cellular_common : Cellular_CommonInit()
13+
14+
Cellular_common -> Cellular_modules_porting : Cellular_moduleInit()
15+
16+
Cellular_common -> Cellular_modules_porting : Cellular_moduleEnableUE()
17+
18+
Cellular_common -> Cellular_modules_porting : Cellular_moduleEnableUrc
19+
20+
Cellular_common --> "FreeRTOS Cellular Library" :
21+
22+
"FreeRTOS Cellular Library" --> Application :
23+
24+
25+
Application ->"FreeRTOS Cellular Library" : Cellular_CleanUp()
26+
27+
"FreeRTOS Cellular Library" -> Cellular_common : Cellular_CommonCleanUp()
28+
29+
Cellular_common -> Cellular_modules_porting : Cellular_moduleCleanUp()
30+
31+
Cellular_common --> "FreeRTOS Cellular Library" :
32+
33+
"FreeRTOS Cellular Library" --> Application :
34+
35+
@enduml

doc/plantuml/cellular_module_porting_functions.txt

Lines changed: 0 additions & 31 deletions
This file was deleted.

doc/plantuml/comm_interaction.pu

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
@startuml
2+
3+
Title FreeRTOS Cellular Library interaction with com interface
4+
5+
participant Application
6+
participant "FreeRTOS Cellular Library"
7+
participant cellular_comm_interface
8+
participant cellular_modem
9+
10+
note over Application : Application needs cellular connecitvity.\nCellular_Init() is called to open FreeRTOS \nCellular Library. Communication interface\n, pCommInterface, is provided by\napplication to "FreeRTOS Cellular Library".
11+
12+
Application -> "FreeRTOS Cellular Library" : Cellular_Init( pCommInterface )
13+
14+
activate Application
15+
16+
"FreeRTOS Cellular Library" ->cellular_comm_interface : pCommInterface->Open( receiveCallback )
17+
18+
cellular_comm_interface->cellular_modem : Register receive callback\nOpen and setup communication device driver\nPower on and enable device
19+
20+
cellular_comm_interface-->"FreeRTOS Cellular Library":
21+
22+
"FreeRTOS Cellular Library"-->Application:
23+
24+
deactivate Application
25+
26+
note over Application : "FreeRTOS Cellular Library" APIs ready.\nApplication get network time with\nCellular_GetNetworkTime() function
27+
28+
Application -> "FreeRTOS Cellular Library" : Cellular_GetNetworkTime()
29+
30+
activate Application
31+
32+
"FreeRTOS Cellular Library"->cellular_comm_interface : pCommInterface->Send()
33+
34+
cellular_comm_interface->cellular_modem : AT+CCLK?
35+
36+
cellular_modem->cellular_comm_interface : +CCLK: "20/06/09,12:06:33+32"
37+
38+
cellular_comm_interface->cellular_comm_interface : Store `+CCLK: "20/06/09,12:06:33+32"` in buffer
39+
40+
cellular_comm_interface->"FreeRTOS Cellular Library" : receiveCallback
41+
42+
"FreeRTOS Cellular Library"->cellular_comm_interface : pCommInterface->recv()
43+
44+
cellular_comm_interface-->"FreeRTOS Cellular Library" : Return data in buffer
45+
46+
cellular_modem->cellular_comm_interface : OK
47+
48+
cellular_comm_interface->cellular_comm_interface : Store `OK` in buffer
49+
50+
cellular_comm_interface->"FreeRTOS Cellular Library" : receiveCallback
51+
52+
cellular_comm_interface-->"FreeRTOS Cellular Library" : Return data in buffer
53+
54+
"FreeRTOS Cellular Library"->Application : Return network time
55+
56+
deactivate Application
57+
58+
note over Application : Applicaton no longer need cellular\nconnectivity. Cellular_Cleanup() is \ncalled to close FreeRTOS Cellular Library.
59+
60+
Application -> "FreeRTOS Cellular Library" : Cellular_Cleanup()
61+
62+
activate Application
63+
64+
"FreeRTOS Cellular Library"->cellular_comm_interface : pCommInterface->Close()
65+
66+
cellular_comm_interface->cellular_modem : Power off device\nClose communication device driver\n
67+
68+
cellular_comm_interface-->"FreeRTOS Cellular Library":
69+
70+
"FreeRTOS Cellular Library"-->Application:
71+
72+
deactivate Application
73+
74+
@enduml

doc/plantuml/comm_interaction.txt

Lines changed: 0 additions & 70 deletions
This file was deleted.
Loading
Binary file not shown.
Binary file not shown.
Loading
Loading
-6.05 KB
Loading

0 commit comments

Comments
 (0)