SENSBLUE ATLAS/Datasheet: Difference between revisions

Line 568:

=== Pinouts ===

=== 21. Pinouts ===

==== Top View ====

[[File:Atlas topview.png|center|frameless|688x688px]]

=== 21. System Type ===

=== 22. System Type ===

'''Raspian'''

Line 580:

Debian 1 :6.12.47-1 +rpt1 (2025-09-16) aarch64 GNU/Linux.

=== 22. Network Information ===

=== 23. Network Information ===

There is three ways to connect to the device. IP and state of the connection be checked on the LCD Network Interface.

==== 22.1 Eth1 (ethO) ====

==== 23.1 Eth1 (ethO) ====

Client dynamic IP obtained by DHCP server.

==== 22.2 Eth2 (eth1) ====

==== 23.2 Eth2 (eth1) ====

Static IP: '''93.48.86.253'''

==== 22.3 Access Point (wlanO) ====

==== 23.3 Access Point (wlanO) ====

IP: '''192.168.30.1'''

=== 23. Software Information ===

=== 24. Software Information ===

{| class="wikitable"

|

Line 625:

|}

=== 24. MQTT Broker ===

=== 25. MQTT Broker ===

port: 1883

Line 636:

login <not needed>

=== 25. Relay Outputs Actor ===

=== 26. Relay Outputs Actor ===

==== 25.1 App Interfacing ====

==== 26.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credentials.

===== 25.1.1 Set/reset digital output pin/pins state =====

===== 26.1.1 Set/reset digital output pin/pins state =====

Both relays '''default''' state is '''open'''.

Line 680:

}</syntaxhighlight>

===== 25.1.2 Get all relays state =====

===== 26.1.2 Get all relays state =====

Req-Topic: relayOutputs/runtime/in<syntaxhighlight lang="json">

{

Line 708:

</syntaxhighlight>

===== 25.1.3 Set all relays state =====

===== 26.1.3 Set all relays state =====

Req-Topic: relayOutputs/runtime/in<syntaxhighlight lang="json">

{

Line 744:

</syntaxhighlight>

=== 26. RTC Actor ===

=== 27. RTC Actor ===

==== 26.1 App Interfacing ====

==== 27.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credencials.

===== 26.1.1 Set timer/alarm interruption =====

===== 27.1.1 Set timer/alarm interruption =====

'''mode:''' Timer, alarm or none.

Line 787:

</syntaxhighlight>

===== 26.1.2 Toggle RTC sync logic (described below) =====

===== 27.1.2 Toggle RTC sync logic (described below) =====

'''tcState:''' State of the synchronization logic of the RTC, this value is '''non-persistent''' so every-time a reboot happens the value return to default (by default the value is '''ON''')

Line 812:

</syntaxhighlight>

===== 26.1.3 Read clock configs =====

===== 27.1.3 Read clock configs =====

'''mode:''' Timer, alarm or none.

Line 849:

</syntaxhighlight>

===== 26.1.4 Read clock =====

===== 27.1.4 Read clock =====

Req-Topic: clock/runtime/in <syntaxhighlight lang="json">

{

Line 864:

</syntaxhighlight>

==== 26.2 Synchronization loop flowchart (every 30 seconds) ====

==== 27.2 Synchronization loop flowchart (every 30 seconds) ====

Line 870:

[[File:RTCActor Overview.svg|center|frameless|774x774px]]

=== 27. Core System Health Actor ===

=== 28. Core System Health Actor ===

==== 27.1 App Interfacing ====

==== 28.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker.

This interface allows any external App to receive system-level metrics such as CPU load, RAM usage, disk usage, temperature, core frequency, system throttle status and uptime. No credentials are required to subscribe to this topic. The System Health Actor does not receive commands. It is fully autonomous and publishes its metrics every 1 second.

==== 27.2 Runtime Data ====

==== 28.2 Runtime Data ====

'''Topic: systemHea l th/runtime/ out'''

Publish rate: '''1 Hz''' (one message per second, clock-jump safe)

===== 27.2.1 Metrics Provided =====

===== 28.2.1 Metrics Provided =====

{| class="wikitable tech-table"

!'''Key'''

Line 950:

</syntaxhighlight>

==== 27.3 Peripherals health ====

==== 28.3 Peripherals health ====

In order get the peripherals health we had to implement a SystemHealth actor in each bus manager (busi2cO, busi2c-1, etc. ... ).

Line 956:

[[File:Peripherals health.svg|center|frameless|792x792px]]

===== 27.3.1 Example =====

===== 28.3.1 Example =====

'''For busi2c-0:'''

Line 1,163:

</syntaxhighlight>

=== 28. TempSensor Actor ===

=== 29. TempSensor Actor ===

==== 28.1 App Interfacing ====

==== 29.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credencials.

===== 28.1.1 Set temperature sensor configurations =====

===== 29.1.1 Set temperature sensor configurations =====

Req-Topic: tempSensor/config/in

Line 1,208:

</syntaxhighlight>

===== 28.1.2 Read temperature sensor configurations =====

===== 29.1.2 Read temperature sensor configurations =====

Req-Topic: tempSensor/config/in

Line 1,246:

</syntaxhighlight>

===== 28.1.3 Read temperature and alert status =====

===== 29.1.3 Read temperature and alert status =====

* unit: Temperature unit of measure

Line 1,278:

</syntaxhighlight>

=== 29. TFT Actor ===

=== 30. TFT Actor ===

==== 29.1 App Interfacing ====

==== 30.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to control and interact with the TFT display, or frontal panel LCD screen. Connecting to the broker for this Area requires no credentials.

==== 29.2 TFT Display Actor ====

==== 30.2 TFT Display Actor ====

The TFT Actor is responsible for:

Line 1,291:

* Providing feedback to the application via MQTT

===== 29.2.1 Screen Carousel Concept =====

===== 30.2.1 Screen Carousel Concept =====

The TFT actor maintains an '''ordered list of screens''' (carousel).

Line 1,306:

- RIGHT on last screen --> first screen

===== 29.2.2 Screen Types =====

===== 30.2.2 Screen Types =====

The TFT actor supports the following screen types:

Line 1,321:

* No user interaction required

===== 29.2.3 Joystick Navigation Logic =====

===== 30.2.3 Joystick Navigation Logic =====

'''Carousel Navigation:'''

{| class="wikitable"

Line 1,337:

|}

===== 29.2.4 Boot Behavior =====

===== 30.2.4 Boot Behavior =====

At system boot:

Line 1,346:

# Actor waits for runtime commands

===== 29.2.5 Design Notes & Constraints =====

===== 30.2.5 Design Notes & Constraints =====

* TFT actor does not expose joystick state

Line 1,355:

* Confirmation screens always require explicit CENTER press

==== 29.3 User interaction through MQTT ====

==== 30.3 User interaction through MQTT ====

Enabling interaction with the carousel using the topic tft/runtime/in . Actions available will be public to the user.

Line 1,442:

</syntaxhighlight>

=== 30. Analoglnputs Actor ===

=== 31. Analoglnputs Actor ===

==== 30.1 App Interfacing ====

==== 31.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credencials.

===== 30.1.1 Configurations =====

===== 31.1.1 Configurations =====

''' Topic: analoglnputs/config/in - Set ADC channels configurations'''

Line 1,509:

</syntaxhighlight>

===== 30.1.2 Runtime Data =====

===== 31.1.2 Runtime Data =====

'''Topic: analoglnputs/runtime/in.'''

Line 1,567:

</syntaxhighlight>

=== 31. Analog Outputs Actor ===

=== 32. Analog Outputs Actor ===

==== 31.1 App Interfacing ====

==== 32.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credencials.

===== 31.1.1 Set analog outputs signal =====

===== 32.1.1 Set analog outputs signal =====

Req-Topic: analogOutputs/config/in

Line 1,615:

</syntaxhighlight>

===== 31.1.2 Set analog outputs =====

===== 32.1.2 Set analog outputs =====

Req-Topic: analogOutputs/runtime/in

Line 1,656:

</syntaxhighlight>

===== 31.1.3 Read analog outputs settings =====

===== 32.1.3 Read analog outputs settings =====

Req-Topic: analogOutputs/runtime/in

Line 1,695:

</syntaxhighlight>

=== 32. Digital lnputs Actor ===

=== 33. Digital lnputs Actor ===

==== 32.1 App Interfacing ====

==== 33.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credentials.

===== 32.1.1 Set digital input pin/pins speed fast/slow =====

===== 33.1.1 Set digital input pin/pins speed fast/slow =====

The '''fast''' speed setting supports edge detection speed up to 100 Hz and the '''slow''' speed settings supports up to 10 Hz.

Line 1,753:

</syntaxhighlight>

===== 32.1.2 Get all digital input pins state =====

===== 33.1.2 Get all digital input pins state =====

Req-Topic: digitallnputs/runtime/in<syntaxhighlight lang="json">

{

Line 1,793:

</syntaxhighlight>

=== 33. Digital Outputs Actor ===

=== 34. Digital Outputs Actor ===

==== 33.1 App Interfacing ====

==== 34.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this area requires no credencials.

===== 33.1.1 Get all digital output pins state =====

===== 34.1.1 Get all digital output pins state =====

Req-Topic: digitalOutputs/runtime/in<syntaxhighlight lang="json">

{

Line 1,851:

</syntaxhighlight>

===== 33.1.2 Set all digital output pins state =====

===== 34.1.2 Set all digital output pins state =====

Req-Topic: digitalOutputs/runtime/in<syntaxhighlight lang="json">

{

Line 1,937:

</syntaxhighlight>

==== 33.2 Notes ====

==== 34.2 Notes ====

If the busi2c-3 is not powered, we will get this:

Line 1,984:

</syntaxhighlight>

=== 34. Joystick Actor ===

=== 35. Joystick Actor ===

==== 34.1 App Interfacing ====

==== 35.1 App Interfacing ====

User App interface and functionalities exposed to the open part of the MQTT broker. Simplified interface to configure and obtain peripherals data. Connecting to the broker for this Area requires no credencials.

===== 34.1.1 Get all joystick pins state =====

===== 35.1.1 Get all joystick pins state =====

Req-Topic: joystick/runtime/in<syntaxhighlight lang="json">

{

Line 2,033:

</syntaxhighlight>

=== 35. Included Software Stack ===

=== 36. Included Software Stack ===

[[File:AtlasCode.svg|center|frameless|583x583px]]

=== 36. Hardware Libraries ===

=== 37. Hardware Libraries ===

[IMAGE PLACEHOLDER]

=== 37. Related Products ===

=== 38. Related Products ===

{| class="wikitable"

|'''PA'''

Line 2,072:

|}

=== 38. Accessories ===

=== 39. Accessories ===

{| class="wikitable"

|'''PA'''

Line 2,099:

|}

=== 39. Document History ===

=== 40. Document History ===

{| class="wikitable"

|'''Version'''

Line 2,118:

|}

=== 40. SENSBLUE ATLAS in-the-field ===

=== 41. SENSBLUE ATLAS in-the-field ===

[IMAGE PLACEHOLDER]