Edgertronic configuration files
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 uses 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. 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
|File||camera storage location||File format definition||Usage|
|2.2||interfaces||/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: |
Note the pound sign symbol (#) is required as the first character on the line.
|2.1.5||ntp.conf||/etc||Network Time Protocol project||Configure the DNS name or IP address of the NTP time server.|
|2.1.5||resolv.conf||/etc||Most any Unix like O.S. documentation||Configure DNS nameserver IP address.|
|2.2||inetd.conf||/etc||Most any Unix like O.S. documentation||Configure Internet daemon server which supports telnet and ftp.|
|2.2||passwd||/etc||Most any Unix like O.S. documentation||Configure user names and passwords. Used by telnet and ftp.|
|2.2||pipelines_*.txt||/etc/pipelines||Pipeline support||Adding custom GStreamer video encoding pipelines.|
|2.2||app_ext_*.py||/etc/app_ext||edgertronic adding URLs||Adding python code and URLs to the camera's code base.|
|2.1.5||multicast-trigger.conf||/etc||edgertronic multicast network trigger||Enabling the camera to be triggered via a network multicast UDP packet.|
|2.2||camera_settings.txt||/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.|
|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||/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||lighttpd.conf||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 jumpdrive, 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 copy the file into the right location in the /etc directory.
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.