[EN] TMA‐2 Client Usage Guide
This is a web client to monitor the real-time data TMA-1 transmitted.
The service is provided at https://monolith.luftaquila.io/live/.
TMA-2 web client is not translated into English yet. But there are only a few Koreans that can easily translated by Chrome's Website Translator.
Press the Set Car ID and put the car information you set on the user registration.
Car ID and key are for distinguishing each team on the crowded TMA-2 server.
If you press the confirm button, the page will be reloaded and the setting will be applied.
- The car ID and key you set will be stored in the browser. If you access the client using a different browser, you will need to set it again.
Press Set UI to show up the UI configuration popup.
UI consists of a datagroup, which is a set of data.
Press Add Datagroup to add a new datagroup.
Datagroup consists of a name, icon, and data included.
Set name and icon. You can search the available icons by pressing the search button.
Add Data button will add a new data to the datagroup.
A data has following properties:
- name
- icon
- display type
- data source
- scale
- unit
Set the name and icon, and select the display type.
TMA-2 client supports 4 display types.
This is the most simple display that shows OFF if the value of the data source is 0, and ON if non-zero.
This display does not support data scale and unit configurations.
This is a display that shows the value of the data source.
It will show the data source value multiplied by the scale. The unit will be displayed next to the value.
This display shows the graph of the recent 1 minute, in addition to the data source value.
This display shows the real-time location of the car on the map.
This display does not support data source, scale and unit configuration. It will automatically use GPS / lat and GPS / lon to display the car location.
There are two options in the data source: standard and CAN.
All data sources except the CAN traffic are categorized as standard data sources.
Select standard in the configuration and select the source in the dropdown menu.
CAN messages consist of 8 bytes and usually contain multiple information like the following example:
You can specify a part of the CAN message to be shown as the data.
- CAN ID: CAN message ID
-
Data Unit: Select a part of the CAN message will be bytewise or bitwise.
- Bytewise
- Endian: An endianness of the data to show stored in the data bytes.
- Byte #: A start and end number of the bytes that store the data to show.
- Bitwise
- Bit #: A start and end number of the bits that store the data to show.
- Bytewise
Bitwise method is not supported yet. (#7)
UI configuration is also stored in the browser. If you access the client using a different browser, you will need to set it again.
The client supports UI export and import features to avoid setting the UI every time manually.
The current UI configurations will be downloaded as ui_config.json file if you press the export UI button.
The file upload popup will be shown if you press the import UI button.
Select ui_config.json file downloaded and press confirm to apply the previous UI configuration.
You can apply the sample UI by copying the configuration below and saving it as ui_config.json and importing it.
sample ui_config.json
[
{
"name": "디지털",
"icon": "wand-magic-sparkles",
"data": [
{
"name": "DIN0",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN0"
},
{
"name": "DIN1",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN1"
},
{
"name": "DIN2",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN2"
},
{
"name": "DIN3",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN3"
},
{
"name": "DIN4",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN4"
},
{
"name": "DIN5",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN5"
},
{
"name": "DIN6",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN6"
},
{
"name": "DIN7",
"icon": "database",
"display": "digital",
"type": "standard",
"source": "DIGITAL / DIN7"
},
{
"name": "PIN0",
"icon": "wave-square",
"display": "value",
"type": "standard",
"source": "PULSE / PIN0",
"scale": 1,
"unit": ""
},
{
"name": "PIN1",
"icon": "wave-square",
"display": "value",
"type": "standard",
"source": "PULSE / PIN1",
"scale": 1,
"unit": ""
},
{
"name": "PIN2",
"icon": "wave-square",
"display": "value",
"type": "standard",
"source": "PULSE / PIN2",
"scale": 1,
"unit": ""
},
{
"name": "PIN3",
"icon": "wave-square",
"display": "value",
"type": "standard",
"source": "PULSE / PIN3",
"scale": 1,
"unit": ""
}
]
},
{
"name": "아날로그",
"icon": "gauge-simple-high",
"data": [
{
"name": "AIN0",
"icon": "0",
"display": "value",
"type": "standard",
"source": "ANALOG / AIN0",
"scale": 5,
"unit": "V"
},
{
"name": "AIN1",
"icon": "1",
"display": "value",
"type": "standard",
"source": "ANALOG / AIN1",
"scale": 5,
"unit": "V"
},
{
"name": "AIN2",
"icon": "2",
"display": "value",
"type": "standard",
"source": "ANALOG / AIN2",
"scale": 5,
"unit": "V"
},
{
"name": "AIN3",
"icon": "3",
"display": "value",
"type": "standard",
"source": "ANALOG / AIN3",
"scale": 5,
"unit": "V"
},
{
"name": "CPU 온도",
"icon": "temperature-three-quarters",
"display": "graph",
"type": "standard",
"source": "ANALOG / CPU_TEMP",
"scale": 1,
"unit": "°C"
},
{
"name": "LV 전압",
"icon": "bolt",
"display": "graph",
"type": "standard",
"source": "ANALOG / INPUT_VOLTAGE",
"scale": 1,
"unit": "V"
}
]
},
{
"name": "가속도",
"icon": "car-on",
"data": [
{
"name": "X-axis",
"icon": "x",
"display": "graph",
"type": "standard",
"source": "ACCELEROMETER / x",
"scale": 1,
"unit": "G"
},
{
"name": "Y-axis",
"icon": "y",
"display": "graph",
"type": "standard",
"source": "ACCELEROMETER / y",
"scale": 1,
"unit": "G"
},
{
"name": "Z-axis",
"icon": "z",
"display": "graph",
"type": "standard",
"source": "ACCELEROMETER / z",
"scale": 1,
"unit": "G"
}
]
},
{
"name": "GPS",
"icon": "satellite",
"data": [
{
"name": "map",
"icon": "map-location-dot",
"display": "gps"
},
{
"name": "위도",
"icon": "map-location-dot",
"display": "value",
"type": "standard",
"source": "GPS / lat",
"scale": 1,
"unit": "°"
},
{
"name": "경도",
"icon": "map-location-dot",
"display": "value",
"type": "standard",
"source": "GPS / lon",
"scale": 1,
"unit": "°"
},
{
"name": "GPS 속도",
"icon": "plane",
"display": "graph",
"type": "standard",
"source": "GPS / speed",
"scale": 1,
"unit": "km/h"
},
{
"name": "진행 방향",
"icon": "location-arrow",
"display": "value",
"type": "standard",
"source": "GPS / speed",
"scale": 1,
"unit": "°"
}
]
}
]