ayatec logo
Home Store Blog Contact
unicontrol user guide by ayatec
Home Store Blog Contact

Topics

  1. Welcome
  2. Getting started
    1. What is unicontrol
    2. How it works
    3. Connectivity
    4. Integration options
    5. Default hardware
    6. Hardware extensions
    7. Special sensors
    8. RGB driver
    9. Audio driver
    10. Network API - HTTP
    11. Network API - MQTT
    12. Network security
    13. Downloads
  3. Web Interface
    1. Processes
      1. Process
      2. Name
      3. Main state
      4. Initial state
      5. Display
      6. Constraints
        1. Process timer
        2. Variable contraints
        3. Force output
      7. Input
        1. Input source
        2. Channel
        3. Control period
        4. Value
        5. Publish
        6. Frequency
        7. Subtopic
      8. Events
        1. On/Off event
        2. Condition
        3. Idle/running time
        4. Delay on/off
        5. Fade in/out
        6. High/low input
        7. Mid point/Tolerance
        8. Out on when
      9. Output
        1. Primary output
        2. Action
        3. Type
        4. Invert
        5. Duty cycle
        6. Mem value
        7. High/low output
        8. Folder/Track
        9. RGB mode
        10. RGB color
        11. RGB brightness
        12. RGB speed
        13. Publish
        14. Subtopic
        15. Secondary outputs
      10. Cycle
        1. Cycles
        2. High/Low phase
      11. On/Off button
    2. Peripheral
      1. Hardware
      2. Type
      3. Calibration
      4. Mapping (edit)
      5. IR remote (edit)
      6. Impulse_counter (edit)
      7. RGB driver (edit)
      8. DS18B20 (edit)
    3. Device
    4. Network
    5. System
    6. License
  4. Tutorials
    1. First boot
    2. First process
    3. Connect to MQTT
    4. Process sequencing
    5. DIY Project: Bath Fan

In this article

  • Introduction
advert
unicontrol > Web interface > Network

Network

In the Network (formerly Wireless) menu you may set-up the network connection to your Wi-Fi access point and to your preferred MQTT broker. Although neither is essential for operation, both greatly contribute to the user experience and overall capabilities of the unicontrol. Also do not forget to learn about unicontrol internet security.

Wi-Fi settings

Connecting your device to a Wi-Fi network allows remote access via the web interface or use the HTTP API. Learn about the STA mode Wi-Fi connection options below. Please note that these options do not apply in the AP mode.

Wi-Fi settings menu section
Parameter
([API name])		 Default value [VALUE] Description
Default mode
(wifimode)		STA0 for STA
or
1 for AP
or
2 for Off		Determines the default Wi-Fi mode in which the device begins following the boot. In the STA mode the device will try to maintain a connection to one of the saved wireless networks. In the AP mode the device will serve as an independent Access Point, allowing other wireless devices to connect to it. In the Off mode the Wi-Fi is disabled, but the device will only boot into this mode if the System button is defined on I8. The three modes can be arbitrarily switched during runtime.

(Introduced in version 1.15, option Off added in version 1.16)
IP [SSID 1]
(wifiauto)		DHCP0 for Manual/Static IP
or
1 for DHCP/Dynamic IP		 Enables or disables dynamic assignment of local network IP address, Gateway, Subnet mask and DNS by the router. Manual/Static implies that user-provided values are prioritized.

(Since version 1.17, this option is configured separately for SSID 1 and SSID 2.)
IP [SSID 2](1.17)
(wifiauto2)
SSID 1
(ssid1)		aya_ssidString of up to 25 charactersSSID names of the primary and secondary 2.4GHz Wi-Fi access points to connect to. Connection to the secondary network is only attempted if the primary network is not accessible and uses parameters automatically assigned by the router. Please note that 5G bandwidth networks not supported.
SSID 2
(ssid2)		empty String
Password 1
(pass1)		aya_passWi-Fi Password to the SSID 1 / SSID 2 network.
Password 2
(pass2)		empty String
Static IP
(localip)		192.168.1.255IPv4 address in the standard decimal format x.x.x.xDevice's local network IP address. Only applicable if Static IP Mode is selected and only used if the provided address is available.
Gateway
(gateway)		192.168.1.1Local network gateway. Only applicable if Static IP Mode is selected.
Subnet mask
(mask)		255.255.255.0Local network subnet mask. Only applicable if Static IP Mode is selected.
DNS
(dns)		8.8.8.8IP address of the preferred DNS server. Only applicable if Static IP Mode is selected and an internet connection is available.
External IP-
(passive information)		Passive information about external IP address as identified by the device. Only available in case of active internet connection.

MQTT settings

Connecting your device to an MQTT broker allows remote access via the MQTT API. Learn about the MQTT connection options below.

MQTT settings menu section
Parameter
([API name])		 Default value [VALUE] Description
Connection
(mqttallow)		Disabled0 for Disabled
or
1 for Enabled
or
2 for Minimal		 Allow or disable connection to the MQTT broker for publishing sensor readings, output state changes or remote control. Choose the Minimal option to avoid sending unnecessary messages and minimize the bandwidth. Learn more...

(Option Minimal added in version 1.16)
Subscription
(suballow)		Enabled0 for Disabled
or
1 for Enabled		Allow or disable subscribing to and receiving MQTT messages for remote control via MQTT
Broker address:
(mqttip)		192.168.1.200IPv4 address in the standard decimal format x.x.x.x
or
String of up to 25 characters		Web or IP address of the MQTT broker.


(Option to provide the broker address in the form of a web URL added in version 1.07)
Port
(mqttport)		1883integer between
0 and 65535		Listener port of the MQTT broker. Only non-SSL listeners are supported.
User
(mqttuser)		mqtt_userString of up to 25 charactersSSID name of the selected 2.4GHz Wi-Fi access point to connect to. Please note that 5G bandwidth networks not supported.
Password
(mqttpass)		mqtt_passClient password to the MQTT broker.
Topic L1
(topicL1)		my_uniDefines up to first 3 subtopics of the topic strings used for communication with the device via MQTT protocol. While the 1st level is mandatory, 2nd and 3rd are optional and are used for a unique identification of the user. Should not contain special characters. Learn more...
Topic L2
(topicL2)		empty String
Topic L3
(topicL3)

HTTP

The device will accept HTTP requests at the following URLs:

(POST) http://[IPv4]/var_set?param=[API name]&val=[VALUE]
(GET) http://[IPv4]/var_request?param=[API name]



POST: http://192.168.1.255/var_set?param=localip&val=192.168.1.222

will set the preferred static IP of the device to 192.168.1.222.

Learn more in HTTP API.

MQTT

This parameter cannot be accessed via MQTT. Learn more in MQTT API.

© 2024 ayatec.eu • Found a mistake?  Let us know!