~aleteoryx/muditaos

ref: d0200de5d5d456b09310a95bf53bc804c6a0c23c muditaos/module-apps/application-desktop/doc/README.md -rw-r--r-- 2.0 KiB
d0200de5 — Przemyslaw Brudny [EGD-5398] Added onBoarding application first version 5 years ago

#SIM PIN flow

The PIN/PUK-related flow between SIM card and PurePhone User is directed by three main entities:

  1. Service Cellular that is responsible for handling modem interactions in this context
  2. ApplicationsManager that is responsible for ApplicationDesktop management and reliable messaging in the Service->Application direction in this context.
  3. ApplicationDesktop that is responsible for PurePhone<->User interactions in this context

Following document focus mainly on (above listed) entities interactions and flow. Occasionally minimal interaction with other entities (such as User or modem) is outlined.

#Functional Decomposition

Basic interactions can be captured by following interfaces:

  1. Service Cellular realizes
    • SrvCellularMessageHandler
  2. ApplicationsManager realizes
    • APMActions
  3. ApplicationDesktop realizes
    • AppDesktopActionHandler

#General flow overview

Each flow in this context consists of single action originating in ServiceCellular send with ApplicationsManager being middle-party that is responsible for appropriate action setup and optional feedback message sent directly from ApplicationDesktop to ServiceCellular via sys::Bus service.

#PIN flow

#PIN required basic flow:

#PIN flow with multiple failures leading to PUK

#PUK flow

#PUK required basic flow:

#PUK flow with multiple failures leading to PUK

#Unhandled CME Errors

#Other flow cases to further analysis

#Flow with user abort

#Flow with hot-swap

#Flow with potential race