5.5.6 Auto Provisioning



The 2N LTE intercoms help you update firmware and configuration manually, or automatically from a storage on a TFTP/HTTP server selected by you according to predefined rules. 

You can configure the TFTP and HTTP server address manually. The 2N LTE intercoms support automatic identification of the local DHCP server address (Option 66). 

Caution

  • The login password is saved in the configuration file. If the password is 2n (default), the valid configuration part is only uploaded. This means that the configuration is uploaded, but the password remains the same, not assuming the value included in the file.

My2N



  • Serial Number – display the serial number of the device to which the valid My2N code applies.
  • My2N Security Code – display the full application activating code.
  • GENERATE NEW – the active My2N Security Code will be invalidated and a new one will be generated.


It displays information on the state of the device connection to My2N.


  • My2N ID – unique identifier of the company created via the My2N portal.

Firmware

Use the Firmware tab to set automatic firmware download from a server defined by you. The intercom compares the server file with its current firmware file periodically and, if the server file is later, automatically updates firmware and gets restarted (approx. 30 s). Hence, we recommend you to update when the intercom traffic is very low (at night, e.g.).


2N LTE intercom expects the following files:

  1. hipMODEL-firmware.bin – intercom firmware
  2. hipMODEL-common.xml – common configuration for all intercoms of one model
  3. hipMODEL-MACADDR.xml – specific configuration for one intercom

MACADDR is the MAC address of the intercom in the 00-00-00-00-00-00 format. Find the MAC address on the intercom production plate or in the Intercom Status tab via the web interface. 

Example:

2N® LTE Verso with MAC address 00-87-12-AA-00-11 downloads the following files from the TFTP server:

    • hipve-firmware.bin
    • hipve-common.xml
    • hipve-00-87-12-aa-00-11.xml

List of Parameters



  • Firmware update enabled – enable automatic firmware/configuration updating from the TFTP/HTTP server.



  • Address retrieval mode – select whether the TFTP/HTTP server address shall be entered manually or a value retrieved automatically from the DHCP server using Option 66 shall be used.
  • Server address – enter the TFTP (tftp://ip_address), HTTP (http://ip_address) or HTTPS (https://ip_address) server address manually.
  • DHCP (Option 66/150) address – check the server address retrieved via the DHCP Option 66 or 150.
  • File path – set the firmware/configuration filename directory or prefix on the server. The intercom expects the XhipY_firmware.bin, XhipY-common.xml and XhipY-MACADDR.xml files, where X is the prefix specified herein and Y specifies the intercom model.
  • Use authentication  enable authentication for HTTP server access.
  • Username  enter the user name for server authentication.
  • Password – enter the password for server authentication.
  • Verify Server Certificate – set the set of CA certificates for validation of the ACS public certificate.
  • Client Certificate – specify the client certificate and private key to validate the intercom right to communicate with the ACS.

Info

  • The intercom contains the Factory Cert, a signed certificate used for British Telecom integration, for example.



  • At boot time – enable check and, if possible, update execution upon every intercom start.
  • Update period – set the update period. Set an automatic update to take place hourly/daily/weekly/monthly, or set the period manually.
  • Update at – set the update time in the HH:MM format for periodical updating at a low-traffic time. The parameter is not applied if the update period is set to a value shorter than 1 day.
  • Next update at – set the next update time.



  • Last Update At – last update time.
  • Update Result – last update result. The following options are available: DHCP option 66 failed, Firmware is up to date, Server connection failed, Running..., File not found. 

  • Communication Result Detail  – server communication error code or TFTP/HTTP status code.
ResultDescription
Invalid server address

The server address is invalid. 

Unsupported protocolThe protocol is not supported. HTTP(s) and TFTP are supported only.
Invalid file pathThe provisioning file location is invalid.
DHCP option 66 failedThe server address loading via DHCP Option 66 or 150 has failed.
Invalid domain nameThe server domain name is invalid due to wrong configuration or unavailability of the DNS server.
Server not foundThe requested HTTP/TFTP server fails to reply.
Authentication failedThe HTTP credentials are invalid.
File not foundThe file has not been found on the server.
Request waiting in queue...The provisioning request is queuing...
In progress...Update is in progress.
File is invalidThe file to be downloaded is corrupted or of a wrong type.
Firmware is up to dateThe firmware update attempt reveals that the latest firmware version has been loaded.
Update SucceededThe configuration/firmware update has been successful. With firmware update, the device will be restarted in a few seconds.

Internal error

An unspecified error occurred during file download.

Configuration

Use the Configuration tab to set automatic configuration download from the server defined by you. The intercom periodically downloads a file from the server and gets reconfigured without getting restarted.


  • Firmware update enabled – enable automatic firmware/configuration updating from the TFTP/HTTP server.



  • Address Retrieval Mode – select whether the TFTP/HTTP server address shall be entered manually or a value retrieved automatically from the DHCP server using Option 66 shall be used.
  • Server Address – enter the TFTP (tftp://ip_address), HTTP (http://ip_address) or HTTPS (https://ip_address) server address manually.
  • DHCP (Option 66/150) Address – check the server address retrieved via the DHCP Option 66 or 150.
  • File Path – set the firmware/configuration filename directory or prefix on the server. The intercom expects the XhipY_firmware.bin, XhipY-common.xml and XhipY-MACADDR.xml files, where X is the prefix specified herein and Y specifies the intercom model.
  • Use Authentication – enable authentication for HTTP server access.
  • Username – enter the user name for server authentication.
  • Password – enter the password for server authentication.
  • Verify Server Certificate – set the set of CA certificates for validation of the ACS public certificate.
  • Client Certificate – specify the client certificate and private key to validate the intercom right to communicate with the ACS. 

Info

  • The intercom contains the Factory Cert, a signed certificate used for British Telecom integration, for example.

 


  • At Boot Time – enable check and, if possible, update execution upon every intercom start.
  • Update Period – set the update period. Set an automatic update to take place hourly/daily/weekly/monthly, or set the period manually.
  • Update At – set the update time in the HH:MM format for periodical updating at a low-traffic time. The parameter is not applied if the update period is set to a value shorter than 1 day.
  • Next Update At – set the next update time.



  • Last Update At – last update time.
  • Update Result (Common Config) – last update result. The following options are available: DHCP option 66 failed, Firmware is up to date, Server connection failed, Running..., File not found. 

  • Communication Result Detail(Common Config) – server communication error code or TFTP/HTTP status code.
  • Update Result (Private Config) –  private configuration follows the common configuration update. The device with private configuration is identified by its MAC address. The following options are available: DHCP option 66 failed, Firmware is up to date, Server connection failed, Running..., File not found. 
  • Communication Result Detail (Private Config) – server communication error code or TFTP/HTTP status code.

My2N / TR069

Use this tab to enable and configure remote intercom management via the TR-069 protocol. TR-069 helps you reliably configure intercom parameters, update and back up configuration and/or upgrade device firmware.

The TR-069 protocol is utilised by the My2N cloud service. Make sure that TR-069 is enabled and Active profile set to My2N to make your intercom log in to My2N periodically for configuration.

This function helps you connect the intercom to your ACS (Auto Configuration Server). In this case, the connection to My2N will be disabled in the intercom.


  • My2N / TR069 Enabled – enable connection to My2N or another ACS server. 




  • Active profile – select one of the pre-defined profiles (ACS), or choose a setting of your own and configure the ACS connection manually.
  • Next synchronisation in – display the time period in which the intercom shall contact a remote ACS.
  • Connection status – display the current ACS connection state or error state description if necessary.
  • Communication Status Detail – server communication error code or HTTP status code.
  • Connection test – test the TR069 connection according to the set profile, see the Active profile. The test result is displayed in the Connection status.



  • My2N ID – unique identifier of the company created via the My2N portal.
  • My2N Security Code – display the full application activating code.



  • ACS Address – set the ACS address in the following format: ipaddress[: port], 192.168.1.1:7547, for example.
  • Username – set the user name for intercom authentication while connecting to the ACS server.
  • Password – set the user password for intercom authentication while connecting to the ACS server.
  • Verify Server Certificate – set the set of CA certificates for validation of the ACS public certificate. Choose one of three sets, see the Certificates subsection. If none is selected, the ACS public certificate is not validated.
  • Client Certificate – specify the user certificate and private key to validate the intercom right to communicate with the ACS. Choose one of three sets, refer to the Certificates subsection.
  • Periodic inform enabled – enable periodical logging of the intercom to the ACS.
  • Periodic inform interval – set the interval of periodical logging of the intercom to the ACS if enabled by the Periodic inform enabled parameter.