Skip to content

Configuration GUI

nurazur edited this page Dec 3, 2025 · 17 revisions

The GUI makes configuring and setting up a TiNo2 significantly easier, more understandable, clearer, and faster.

image

On the left side of the panel is a terminal-like window that shows the outputs from the TiNo2. On the right side is the list of all configuration parameters. Most paramters can be edited, a few are read-only. When a TiNo2 is connected in configuration mode, the configuration is automatically loaded from EEprom, decrypted and output to the GUI.

In addition to editing individual parameters, the configuration can also be loaded from a file or transferred from the GUI to a file.

Connecting

image
  • Port: select the port
  • Config/Monitor: Config= Calibration Mode, Monitor= operate, show node output in terminal window
  • Connect/Disconnect
  • Baud: select Baud rate. For convenience, 'Receiver' and 'Sender' select standard TiNo2 Baud rates.

EEPROM Commands

image
  • Load<-Eeprom: corresponds to command a, get all configuration parameters from the node and list them on the right side of the window.
  • Save Eeprom: corresponds to command x, save parameters to Eeprom and continue with normal operation
  • Checksum: corresponds to command s, calculate checksum
  • Copy->Eeprom: copy all configuration parameters from GUI to device. This overwrites all existing data on the device.

Battery Voltage Calibration

for precise Battery Voltage measureements during operation, the supply voltage must be known at the time of calibration. This voltage must be stored, in mV units, in the field VCCatCAL. Then, The reference ADC value must be measured and stored in the field VCCADC_CAL

image
  • Vbatt Cal. : Measure Vbatt ADC and store in device
  • Vbatt Measure: Test Battery Voltage. The resolution of the measurement is approximately 10mV

Raw Commands

image

under certain circumstances it may be useful to send raw commands directly to the device. The command set is relatively small. Some commands work with arguments, where <addr> is the raw address of the item in the Configuration (RAM or EEPROM) and <value> is the value of that RAM or EEPROM cell. Arguments follow comma separated the command, no white space is accepted.

Command Remark
c measure ADC and store in VCCADC_CAL parameter on device
cs verify checksum.
a List all configuration parameters. Output is diverted to the right GUI panel
m measure the battery voltage (considers calibration data)
r read from device. Syntax: r,<addr>
ri read 16 bit integer from device. Syntax: ri,<addr>
rf read float from device. Syntax: rf,<addr>
s request checksum update and store in CHECKSUM parameter.
t send a test RF packet
to start sending radio OOK signal
ts put radio into sleep mode
w write value to to device. Syntax: w,<addr>,<value>
wf write float value to device. Syntax: wf,<addr>,<value>
wi write 16-bit integer value to to device. Syntax: wi,<addr>,<value>, value format can be hex
x exit calibration mode, data are copied into Eeprom and continue with loop()

Load and Save Files

image

Configuration files are plain text files with very simple syntax PARAMETER = <value> as shown in the picture below.

image

When opening a file, its content is not automatically transferred to the device. To transfer these data, the button Copy->EEPROM must be clicked.

Sensorconfig

Click on the Label SENSORCONFIG opens a new Window as shown below. Since TiNo2 detects I2C Sensors automatically, the first 8 placeholders are ignored by the device. Keep them unchecked. Check those sensors that are physucally attached to the TiNo device to activate them.

image
Sensor Remark
I2C_x ignored. Keep unchecked
DS18B20 popular, ubiquitous Temperature Sensor. Its use is dicouraged, use a PT100 instead
MAX6675 popular yet obsolete K-type Thermocouple IC
MAX31855 Thermocouple IC, successor of MAX6675
MAX31856 versatile Thermocouple IC. Requires supply voltages at or above 3.0V
MAX31865 PT100/PT1000 IC
ADS1120 versatile ADC, currently implemented as a PT100
BRIGHTNESS refers to a LDR (Light Dependent Resistor)
RESERVED ignored. Keep unchecked

Pin Change Interrupts (PCI)

image

Pin Change Interrupts are external events that wake up the microprocessor and trigger a RF packet to be sent. Clicking on one of the PCIx labels opens a dialog window. Here the Pin number itself, its port configuration and its trigger condition are defined.

  • Checkbox enable PCIx:
  • GPIO Pin: the GPIO Pin number (Arduino numbering)
  • Mode: the Mode. External events are inputs, optionally can be pulled up by the MCP (approximately 30 kOhms)
  • Trigger: the trigger condition. This can be a FALLING edge from HIGH to LOW, a RISING edge from Low to HIGH or both, called CHANGE.
  • GatewayID: the target receiver to which the event packet will be sent. This is useful for remote controls using TiNo2.

Flash Firmware

This button opens a simple Dialog window and allows to flash TiNo2 with a binary file. From the client side of view, this should only be required for critical updates. From the developper/maker point of view, it allows to easily flash multiple devices with a pre-compiled firmware.

prerequisites:

  • The device to be flashed must have a bootloader.
  • if avrdude is installed on the system, its version must be greater or equal to 7.3. If it is not installed system-wide, it must be in the same directory as the GUI.
  • the configuration file must be in the same directory as the GUI.
image
  • Processor: Select the processor of the TiNo2 Board. Standard TiNo2's have a ATmega4808 populated. There exist also versions with AVR64DD32 and AVR64DD28 MCU's.
  • Datei: Select the binary file. It must be in Intel-Hex Format and usually has the extension .hex
  • Start: To start the flash procedure, click this button.
  • Exit: Exit the flash procedure.

Help

right mouse click on a Label opens a box with help text. Currently only German.

image

Clone this wiki locally