This service is deprecated as of August 2022 with the Kamakura release and now has been Archived.
Be advised that this service is no longer going to be updated or supported. Two new device services have been created to address camera needs:
Please upgrade to either of these device services depending on your needs.
The EdgeX Camera Device Service is developed to control/communicate ONVIF-compliant cameras accessible via http in an EdgeX deployment
The following devices have been tested in a development environment with EdgeX. Only those ONVIF-compliant cameras which support the "onvif_snapshot" method are fully compliant with the EdgeX Camera device service:
The following cameras are non-compliant:
This component is packaged as docker image and snap.
For docker, please refer to the Dockerfile and Docker Compose Builder scripts.
For the snap, refer to the snap directory.
This device service is built using the onvif4go library. It provides a developer-friendly ONVIF client to use with ONVIF-compliant cameras.
Clone the device-camera-go repo with the following command:
git clone https://github.com/edgexfoundry/device-camera-go.git
Build a docker image by using the following command:
docker build . -t device-camera-go
Alternatively the device service can be run natively with make build
and the ./run.sh
script.
By default, the configuration and profile files used by the service are available in the 'cmd/res' folder. Notably, the configuration.toml file cmd/res should be changed to reflect the correct device profile and host/IP address for the camera(s). The configuration-drive.toml file in the same directory should be updated with the camera's access credentials.
EdgeX Put commands (as-of writing) take a single parameter. For commands like "create a user" or "set the device system time", this is problematic. To workaround this limitation, the device service expects the parameters for several of the PUT commands to be a single string value containing string-escaped JSON. Some examples:
{"OnvifDateTime":
"{
\"Hour\":21,
\"Minute\":35,
\"Second\":6,
\"Year\":2019,
\"Month\":10,
\"Day\":4
}"
}
{"OnvifUser":
"{
\"Username\":\"newadmin2\",
\"Password\":\"newadmin234\",
\"UserLevel\":\"Operator\"
}"
}
During the course of testing or deployment you may end up with EdgeX devices in the system that you want to remove. With this device service potentially starting listener goroutines for its devices, this becomes more relevant.
To remove devices from EdgeX:
Issue a request to the EdgeX core metadata service to get the Names for all devices.
GET http://edgex-core-metadata:59881/api/v2/device/all
Issue a request to the EdgeX core metadata service to delete a device by ID.
DELETE http://edgex-core-metadata:59881/api/v2/device/name/{{device_name_here}}
This will remove the device from EdgeX and, as long as it does not remain in the device list inside this device service's configuration.toml file, will prevent this device service from attempting to initialize the device at startup.
There are many ways to interact with this device service. This example shows how to emit a snapshot image from your camera at regular intervals by leveraging EdgeX device service auto events.
For this example we will run this in a docker container, so modify the pre-defined devices found here to add your IP camera device. Note that at a minimum you must populate the Address value using the correct IP address for your device.
# Pre-defined Camera Device(s)
[[DeviceList]]
# Unique device name
Name = "CasualWatcher001"
# Using default ONVIF camera profile
Profile = "camera"
# Human friendly description
Description = "Camera on east wall facing the loading dock."
[DeviceList.Protocols]
[DeviceList.Protocols.HTTP]
Address = "10.22.34.144"
# Emit a CBOR-encoded image from this camera, as an EdgeX event, every 30 seconds
[[DeviceList.AutoEvents]]
Interval = "30s"
OnChange = false
SourceName = "OnvifSnapshot"
Build docker image named edgexfoundry/device-camera-go:0.0.0-dev.
make docker
Generate compose file with device-camera added by running following commands:
git clone https://github.com/edgexfoundry/edgex-compose.git
git checkout <release-branch> # i.e. hanoi
cd compose-builder/
make gen no-secty ds-camera
Launch the service using docker-compose up device-camera
. You should see informational log entries of CBOR events being emitted after 30 seconds, and each 30 seconds thereafter.
device-camera | level=INFO msg="Device Service device-camera-go exists"
device-camera | level=INFO msg="*Service Start() called, name=device-camera-go, version=1.0.0"
device-camera | level=INFO msg="Listening on port: 59985"
device-camera | level=INFO msg="Service started in: 65.358268ms"
device-camera | level=INFO Content-Type=application/cbor correlation-id=a452e6b5-75b0-46c5-8558-a1c07269bf42 msg="SendEvent: Pushed event to core data"
device-camera | level=INFO Content-Type=application/cbor correlation-id=45e53484-6a7e-41e6-9fd5-794f8a002819 msg="SendEvent: Pushed event to core data"
Refer to simple-cbor-filter,
update the ValueDescriptors
in res/configuration.toml
and run the example:
[ApplicationSettings]
ValueDescriptors = "onvif_snapshot"
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. Open source ecosystem
2. Collaboration, People, Software
3. Evaluation model