Edgertronic configuration files

From edgertronic high speed video camera
Jump to navigation Jump to search

Background

The information below documents all the configuration files you can add to the camera. You can configure the camera two ways, depending on what is being configured. All video capture related parameters are configured using CAMAPI; specifically configure_camera() and run(). The Web UI invokes configure_camera() and run() when you exit the settings modal. All other camera configuration is done by saving a file on removable media (SD card or USB storage device), inserting removable storage device into the camera, and powering on the camera. The following information applies to camera configuration done using configuration files stored on a removable storage device.

The majority of the camera software consists of Open Source packages, such as ntp for Network Time Protocol, where the packages are commonly used in many computing environments. Configuration of these packages is done as defined by the package. For example ntp configuration is done via the /etc/ntp.conf configuration file. Refer to the package documentation (such as ntp.config configuration file documentation) for a description of the configuration file format. If the configuration is unique to edgertronic software, such as the GStreamer pipeline video encode configuration file, then the configuration file follows the python configuration file format.

Supported configuration files

First
supported
in version
File camera storage location File format definition Usage
2.2 interfaces /static/etc/network interfaces file man page Configure Ethernet to use a specific fixed IP address or to get an address from a DHCP server. One non-standard line can be added to the interfaces file to force the camera to disable the DHCP client and thus use the fixed IP address specified in the interfaces file. Add the following string as the first line in the interfaces file:
#enable-dhcp no
Note the pound sign symbol (#) is required as the first character on the line.
2.1.5 ntp.conf /static/etc Network Time Protocol project Configure the DNS name or IP address of the NTP time server.
2.1.5 resolv.conf /static/etc Most any Unix like O.S. documentation Configure DNS nameserver IP address.
2.2 inetd.conf /static/etc Most any Unix like O.S. documentation Configure Internet daemon server which supports telnet and ftp.
2.2 passwd /static/etc Most any Unix like O.S. documentation Configure user names and passwords. Used by telnet and ftp.
2.2 pipelines_*.txt /static/etc/pipelines Pipeline support Adding custom GStreamer video encoding pipelines.
2.2 app_ext_*.py /static/sdk/app_ext edgertronic adding URLs Adding python code and URLs to the camera's code base.
2.1.5 multicast-trigger.conf /static/etc edgertronic multicast network trigger Enabling the camera to be triggered via a network multicast UDP packet.
2.2 camera_settings.txt /static/etc Metadata file This file is overwritten each time CAMAPI run() method is called. It is included in this table of configuration files for completeness.
2.2 camera_settings??.txt /etc/camera_settings Metadata file
Favorite Settings
These files are generated by calls to CAMAPI save_settings() method. They are included in this table of configuration files for completeness.
2.2.1 logo.png /static/etc/logos PNG Custom logo file used when overlay is enabled. If there is not custom logo available, the edgertronic logo is used.
2.5.1 lighttpd.conf /static/etc/lighttpd Light HTTPD web server documentation Lighttpd embedded web server configuration file.

Installing or modifying configuration files

Installing a configuration file into the camera is easy. Just put the file on an SD card or USB storage device, install the removable storage device into the camera, and power up the camera. If you have multiple cameras to configure, repeat the process for each camera.

The file name must match one listed in the table above. You need to store the file in the root (top level) directory of the removable storage device. The camera will install the file into the right location in the camera's /etc directory. The installation process also moves the configuration file on the SD card into a directory called installed. If you create a file named multi-camera-install in the top level directory on the removable storage device, then the camera will leave the file on the SD card (in the top level directory), so you can use the same SD card or USB storage device in multiple cameras if you need to configure more than one camera.

Deleting configuration files

You need to do a camera factory reset to delete the configuration files.

Configuration files are also deleted when you upgrade the camera's software.

Verifying camera configuration

You can view the contents of the configuration files by browsing to the camera's URL http://10.11.12.13/static/etc and clicking on the file of interest.

replacing 10.11.12.13 with your camera's IP address as necessary.

Updating a camera configuration file

Simply store the updated configuration file on the removable storage device and power on the camera. The camera will detect the file has changed and again copy the file to the correct location in the /etc directory.