Firmware & Files
Firmware refers to the software, that runs on the device.
The file that contains the firmware is refered to a Firmware Image and has the file extension .bin.
Download a Firmware Image
egnite will regulary provide updates to the firmware in form of firmware image files on this website:
https://www.egnite.de/support/firmware/
The firmware image will be a file with a .bin extension.
After downloading a firmware image you can upload it to the device as described below.
Upload Firmware
Screenshot
- Click on Choose file and select the firmware image file (.bin) from your local file system.
Alternatively drag the image file from your file manager into the area with a dashed border.
The filename should now be displayed in the section.
- Click the button.
The device will install the provided firmware and reboot.
On the left hand side of the Upload panel, details about the currently active firmware are displayed.
You can use this information (e.g. Version) to verify a firmware update.
Alternative Firmware
The device stores the previous firmware, that was installed before an update.
If you are having issues after a firmware update, click on the rollback button, to activate that stored firmware version.
Switching firmware is also possible by means of the on-device reset button. This can be helpful, if the web interface is not reachable.
Files & Templates
The Files & Templates section provides a list of files (template files, as of this writing), that are stored on the device.
Refer to the Templates docs page for further information on the templates feature itself. Managing template files is described in the following sections, because that takes place on the Firmware & Files configuration page.
Template categories
The template files are organized into categories, which are displayed in a dedicated column of the list.
These categories control in which context the template files can be used. For example, a template file with the category email can be used with the email feature of the device, but not with the webhook feature.
Currently the following template categories exist:
email: Templates for the email feature.webhook: Templates for the webhook feature.general: Templates for general purpose, e.g. those that expose peripheral data in CSV format to be queried via HTTP API.
Template types
There are two types of template files that can exist here:
- Default template files, which are preinstalled on the device and cannot be deleted or modified.
They are displayed in gray text in the list with a lock symbol in the first column.
The device ships with default templates for the email and webhook features, as well as for printing out historical peripheral data in CSV format. - User owned or custom template files, which can be created, modified and deleted by the user.
They are displayed in black text in the list with a delete button in the first column.
Editing templates
Custom template files can be edited by
- clicking the edit button in the first column of the list, or
- clicking on the edit button next to the template selection dropdown on an interface configuration page.
Default template files cannot be edited.
However, they can be used as a base for creating a new custom template file by cloning them.
Cloning default templates
Default template files can be cloned to create a new custom template file.
This is useful if you want to use a default template file as a base for your own custom template file, while customizing it. The default template file will remain unchanged and can still be used as a base for other custom template files.
First, decide for which category you want to create a new custom template file. Then, find a default template file of that category in the list and clone it.
The category of the new custom template file will be the same as the default template file that was cloned. You cannot change the category of a template file.
To clone a default template file,
- click the clone button in the first column of the list, or
- click on the clone button next to the template selection dropdown on an interface configuration page.
A template editor will open with the content of the default template file preloaded.
Important: Set the Filename field to a unique name for the new custom template file. It is not possible to overwrite an existing template file, whether it is a default or custom template file.
You can now modify the content to your liking and save it as a new custom template file. Either alter the prefilled content or delete it and replace it with your own content. The latter is effectively the procedure to create a new custom template file from scratch.
Creating custom template files
Adding new user owned or custom template files is essentially cloning a default template file (which is assigned to the category you want your new template to belong to) and setting it's content to something unrelated, instead of just modifying it.
As cloning a default template file prepopulates the content of that file into the editor, to add a fresh template, simply delete the prefilled template content and replace it with the content of the new template.
Deleting custom template files
Custom template files can be deleted by clicking the delete button in the first column of the list.
Default template files cannot be deleted.