Advantech ICAM-540

Advantech ICAM-540 series is a highly integrated Industrial AI Camera equipped with SONY IMX334 industrial grade image sensor, based on NVIDIA Orin NX SoM with support for C-mount lens. Featuring CAMNavi SDK, Google Chromium web browser utility and NVIDIA Deepstream SDK, ICAM-540 series accelerates the development and deployment of cloud-to-edge vision AI applications.

The CAMNavi SDK uses Python language by default and is better adapted to image acquisition and AI algorithm integration. Meanwhile the HTML 5 web based utility can be used to setup the cameras and network configuration to lower the installation effort.

The preloaded, optimized Jetpack board support package allows to seamlessly connect to AI cloud services. Advantech ICAM-540 series is an all-in-one, compact and rugged industrial AI camera and is ideal for a variety of Edge AI vision applications.

1. Setting up your Advantech ICAM-540

Follow Advantech's setup instructions to power on and setup ICAM-540. You may also need to purchase a camera lens that is appropriate for you application. You will need to connect power, keyboard, mouse, HDMI monitor, and the Ethernet connector. Please log into the Ubuntu desktop that is preinstalled on the device.

Camera sensor setup

At fresh start the camera sensor initializes with default image parameters (e.g., gain, exposure, etc.). Most of the times the default parameters will not be suitable for the setting that you want to observe. One solution is to set up a camera with Basler Pylon Viewer visual tool, and save the camera sensor parameters for further use. Pylon Viewer comes preinstalled on ICAM-540.

First, launch the pylon Viewer tool from Basler:

$ /opt/pylon/bin/pylonviewer

Turn on the camera in the GUI application by flipping the trigger and starting a continuous stream.

Now, adjust the camera sensor configurations to ensure the images coming from the sensor are of desired quality and lighting.

If you don't know where to start, the initial suggestions are to set Exposure Auto to Once and Gain Auto to Once. This way the sensor will adjust to the current frame conditions. Setting these to Continuous will make the sensor adjust these parameters dynamically as the frame changes.

After you are satisfied with the configuration it needs to be saved in the filesystem in .pfs format for further reuse.

To do that:

  • Pause the stream by clicking on the "stop" icon

  • Open "Camera" menu on the top menu and click "Save Features"

  • Save the file in a filesystem path. It is recommended to create a directory for these configurations, e.g., /home/icam-540/basler-configs

Refer to Basler pylon Viewer documentation for more settings and usage tips

2. Installing dependencies

Running the setup script

To set this device up in Edge Impulse, run the following command (from any folder). When prompted, enter the password you created for the user on your ICAM-540 in step 1. The entire script takes a few minutes to run (using a fast microSD card).

wget -q -O - https://cdn.edgeimpulse.com/firmware/linux/jetson.sh | bash

3. Connecting to Edge Impulse

With camera settings configured and assuming they are saved in e.g., /home/icam-540/basler-configs/config-1.pfs, run the following command:

edge-impulse-linux --gst-launch-args "pylonsrc pfs-location=/home/icam-540/basler-configs/config-1.pfs ! video/x-raw,width=3840,height=2160,format=BGR ! videoconvert ! jpegenc"

This will start a wizard which will ask you to log in, and choose an Edge Impulse project. In the Data Acquisition tab of Edge Impulse Studio you may take images directly from the camera with those settings for use in developing your machine learning dataset.

Next steps: building a machine learning model

With everything set up you can now build your first machine learning model with these tutorials:

Looking to connect different sensors? Our Linux SDK lets you easily send data from any sensor and any programming language (with examples in Node.js, Python, Go and C++) into Edge Impulse.

Deploying back to device

To run your impulse locally stop any previous Edge Impulse commands (CTRL+C) and run the following with the camera configurations you prefer (see above for info on camera configuration).

edge-impulse-linux-runner --gst-launch-args "pylonsrc pfs-location=/home/icam-540/basler-configs/config-1.pfs ! video/x-raw,width=3840,height=2160,format=BGR ! videoconvert ! jpegenc"

This will automatically compile your model with GPU and hardware acceleration, download the model to your device, and then start the inference, capturing the input with previously configured camera parameters. Our Linux SDK has examples on how to integrate the model with your favourite programming language.

Alternatively, you may download your model from the Deployment section of Edge Impulse Studio. Be sure to chose the Advantech ICAM-540 option to get the best acceleration possible.

Copy the downloaded .eim file to the device's file system and run this command on the device

edge-impulse-linux-runner --model-file path/to/file.eim --gst-launch-args <gstreamer-and-camera-configuration-override>

View Running Inference in Web Browser

If you have an image model then you can get a peek of what your device sees by being on the same network as your device, and finding the 'Want to see a feed of the camera and live classification in your browser' message in the console. Open the URL in a browser and both the camera feed and the classification are shown:

Troubleshooting

edge-impulse-linux reports "OOM killed!"

Using make -j without specifying job limits can overtax system resources, causing "OOM killed" errors, especially on resource-constrained devices this has been observed on many of our supported Linux based SBCs.

Avoid using make -j without limits. If you experience OOM errors, limit concurrent jobs. A safe practice is:

make -j`nproc`

This sets the number of jobs to your machine's available cores, balancing performance and system load.

edge-impulse-linux reports "[Error: Input buffer contains unsupported image format]"

This is probably caused by a missing dependency on libjpeg. If you run:

vips --vips-config

The end of the output should show support for file import/export with libjpeg, like so:

file import/export with libjpeg: yes (pkg-config)
image pyramid export: no
use libexif to load/save JPEG metadata: no
alex@jetson1:~$

If you don't see jpeg support as "yes", rerun the setup script and take note of any errors.

edge-impulse-linux reports "Failed to start device monitor!"

If you encounter this error, ensure that your entire home directory is owned by you (especially the .config folder):

sudo chown -R $(whoami) $HOME

Long warm-up time and under-performance

By default, the Jetson Orin enabled devices use a number of aggressive power saving features to disable and slow down hardware that is detected to be not in use. Experience indicates that sometimes the GPU cannot power up fast enough, nor stay on long enough, to enjoy best performance. You can adjust your power settings in the menu bar of the Ubuntu desktop.

Additionally, due to NVIDIA GPU internal architecture, running small models on it is less efficient than running larger models. E.g. the continuous gesture recognition model runs faster on NVIDIA CPU than on GPU with TensorRT acceleration.

According to our benchmarks, running vision models and larger keyword spotting models on GPU will result in faster inference, while smaller keyword spotting models and gesture recognition models (that also includes simple fully connected NN, that can be used for analyzing other time-series data) will perform better on CPU.

Last updated