Wi-Fi Connection Flow

This section explains where the way Boards attempt to connect to a Wi-Fi network, through different Wi-Fi configurations.

1. Default Wi-Fi

Default Wi-Fi Credentials are informed in First Steps section. These credentials are stored in a specific memory in the Board. They cannot be erased.

When ordering boards, you can request another default password for your Boards!

The default SSID will always be CentiWifi.

2. Connection Flow

After having changed Wi-Fi credentials, the Board contains then 2 Wi-Fi information: default Wi-Fi, and custom Wi-Fi.

The Board believes it is correctly connected when:

it has found the SSID

it has successfully authenticated to the network

it has collected an IP Address

There is no verification over internet connection

Here is how it attempts connect:

2.1. v4 and before

This only regards Boards in v4- delivered before April 2023

flowchart TD

classDef class_blue fill:#00aec2,color:#fff,stroke-width:0px;
classDef class_start fill:#00aec2,color:#fff,stroke:#4a4a49,stroke-width:2px;
classDef class_error fill:#b51f1f,color:#fff,stroke:#4a4a49,stroke-width:2px;
classDef class_success fill:#a2c617,color:#fff,stroke:#4a4a49,stroke-width:2px;

Z("Board boots"):::class_start
Z --> A("look for custom SSID"):::class_blue ---> |Found|AConnect("attempt to connect
to custom"):::class_blue 
AConnect --> |Success|AConnectOK("running on custom"):::class_success
AConnect ---> |Failure|AConnectFail("Board enters recovery mode"):::class_error

A --> |Not Found|B("look for default SSID"):::class_blue --> |Found|BConnect("attempt to connect
to default"):::class_blue 
BConnect ---> |Failure|AConnectFail
BConnect --> |Success|BConnectOK("running on default"):::class_success

B --> |Not Found|A

2.2. v5 and later

This only regards Boards in v5+ delivered after April 2023

Here, a third configuration appears: the saved configuration. This corresponds to the last working Wi-Fi configuration used.

flowchart TD

classDef class_blue fill:#00aec2,color:#fff,stroke-width:0px;
classDef class_start fill:#00aec2,color:#fff,stroke:#4a4a49,stroke-width:2px;
classDef class_error fill:#b51f1f,color:#fff,stroke:#4a4a49,stroke-width:2px;
classDef class_success fill:#a2c617,color:#fff,stroke:#4a4a49,stroke-width:2px;

Z("Board boots"):::class_start

subgraph gcustomer[attempt on custom]
    A("look for custom SSID"):::class_blue
    AConnect("attempt to connect
to custom"):::class_blue
    AConnectOK("save custom
saved=custom"):::class_success
    AConnectOKK("running on custom"):::class_success
end

subgraph "attempt on saved"
    B("look for saved SSID"):::class_blue
    BConnect("attempt to connect
to saved"):::class_blue
    BConnectOK("running on saved"):::class_success
end

subgraph "attempt on default"
    C("look for default SSID"):::class_blue
    CConnect("attempt to connect
to default"):::class_blue
    CConnectOK("save custom
saved=default"):::class_success
    CConnectOKK("running on default"):::class_success 
end

Recovery("Board enters recovery mode"):::class_error

Z --> A
A --> |Found|AConnect
A -----> |Not Found|B

AConnect --> |Success|AConnectOK --> AConnectOKK
AConnect ----> |Failure|B

B --> |Found|BConnect
B --> |Not Found|C

BConnect --> |Success|BConnectOK
BConnect ---> |Failure|C

C --> |Found|CConnect
C -----> |Not Found|Recovery

CConnect --> |Success|CConnectOK --> CConnectOKK
CConnect ---> |Failure|Recovery