logo logo

Install on Camera

This chapter guides you through the installation process of the SmartFace Embedded on Hanwha Cameras and the configuration of the Edge stream in SmartFace Station.

Video Tutorial

If you prefer a video step by step guide please watch the prepared tutorial video. If you prefer to read a step by step guide, please skip this section and navigate to the General requirements section.

General requirements

A Smart Camera with Ambarella SoC (CV28, CV25, CV22 or CV2) is required to install and run the SmartFace Embedded Stream Processor.

We are focusing on Hanwha P series cameras with AMbarella CV2 SoC on this page.

All supported Smart cameras and Edge devices are documented in the Required Hardware section

Download the SFE Stream Processor plugin

All of the Installation Files are available at our Customer Portal, you can log in with your credentials.

ℹ️ Your sales representative will provide you the credentials for the Customer Portal login.
  1. At the Customer Portal access Products on the top menu bar or through Home > Products & Licenses > Products

  1. Click on the name of the SmartFace Embedded product and then on the SmartFace Embedded page choose the current release version - major version first, then the release itself.

  1. Under the Downloads section, you can download the SFE Stream Processor packages for various cameras. The packages have a version number in the file name, such as SFE Stream Processor X.Y.Z (X.Y.Z. is the version number). Please use the version recommended for the version of SF Platform you are using according to the Table of Releases.

Install the SFE Stream Processor Hanwha camera plugin

  1. Extract the downloaded package.
  2. Access the camera at the camera’s IP address/URL and log in.

  1. Go to Settings->Open platform->Open platform and click … to choose SmartFaceEmbedded.cap file from your file system. Click Install to upload and install the application.

  1. When the application is installed you will see the new application SmartFaceEmbedded installed. To run the application click the Start button. When the application is running the Status changes to Running....

  1. When the application is running you can also check the CPU and memory utilization as well as the run time of the application by clicking on the Health button.
  2. To stop the application uncheck the checkbox. When the application is not running the Status changes to Stopped.
  3. When the application is started you can also click on the Go App button to open the SFE Stream Processor configuration page.
  4. In the SFE Stream Processor configuration page, you need to configure the MQTT connection properly

If you are not using a Hanwha camera please follow the installation guides for other supported cameras and devices

Configure SFE Stream Processor

Click on the Go App button to open the SFE Stream Processor configuration page.

Configure MQTT connection

Configure the MQTT connection on the SFE Stream Processor configuration page

  • Set BROKER ADDRESS to IP address where SmartFace Platform is running
  • Set BROKER PORT to 1883 (default MQTT port)
  • Set CLIENT ID to the unique identifier of the camera
  • Set TOPIC to edge-stream
  • Set USERNAME to guest (default in RabbitMQ)
  • Set PASSWORD to guest (default in RabbitMQ)
  • Optionally, you can enable TLS to encrypt communication between MQTT clients.

Scroll down and click the SAVE CHANGES button to save changes in configuration.

Refer to SFE Stream Processor configuration documentation for more information.

Run SFE Stream Processor

Click the LAUNCH button to start the SFE Stream Processor.

Apply License

Once the SFE Stream Processor is installed and running we set the license for each camera.

Navigate to your SmartFace installation’s SmartFace Station available at the port 8000. Open the Cameras tab. Open the installed camera.

Enable the camera using the toggle button. Newly added Camera will have License not provided status.

Scroll down to the bottom of the camera’s properties to the license section. You can drag’n’drop or upload your license. Save the changes.

After a successful update of the license you will see License Valid with a green icon.

If everything is set correctly you will see Healthy status with a green dot.

Validate installation

Check the logs of the SFE Stream Processor on the SFE Stream Processor Log page if there is no error.

You can also use the SFE Client GUI Application to validate that the SFE Stream Processor is running and detecting faces.

After Installation

Once your installation is done and your SmartFace is up and running, you can follow an additional tutorial guiding you through your first steps after installation of the SmartFace - registering a Watchlist Member, adding an edge stream and getting you first identification.