This repository contains programming samples for Sick Visionary-T Mini CX (V3S105-1AAAAAA) and Sick Visionary-S CX (V3S102-1AAAAAA and V3S102-1AABAAB).
The entry point for our camera programming samples is the Python Welcome Demo and the Cpp Welcome Demo. These welcome demos provide an overview to the functionalities offered by the Visionary Python and C++ API. They cover aspects such as device connection, user authentication (login and logout), parameter adjustments, along with the streaming and storage of images and point clouds.
For new users we recommended to follow the samples in the following order:
The source code is released under The Unlicense.
The samples in this repository have been tested with the following platforms:
| Platform | Compiler | Version | Notes |
|---|---|---|---|
Windows |
Visual Studio / Build Tools |
2022 (MSVC = 14.x) |
|
Windows |
gcc (mingw64) |
13.2.0 (>= 8.1) |
|
Linux inside WSL2 |
gcc |
11.4.0 (>= 8.1) |
finding_and_connecting_devices (AutoIP) and image_streaming_and_storing (UDP) will not work with default WSL2 configuration (NAT) |
Linux |
gcc |
>= 8.1 |
Ensure you have a recent version of cmake [1] and a compiler available on your machine’s system. If you are working on windows with a recent version of VisualStudio[2], take care to have a CMake version supporting your version of Visual Studio.
After cloning this repository, open a Command Prompt window and navigate to sick_visionary_samples directory. Run these additional git commands to have the correct submodules in place
[3]:
-
git submodule update --init --recursive
Before you begin, ensure you have met the following requirements:
-
You have installed
pip, which is a package manager for Python. If not, you can install it using the following command:
$ sudo apt install python3-pip-
You have installed the following Python libraries:
OpenCV,NumPy, andCryptodomeX. If not, you can install them using pip:
$ pip3 install opencv-python
$ pip3 install numpy
$ pip3 install pycryptodomex|
Note
|
Please replace the installation commands with the appropriate ones for your operating system or Python environment if necessary. |
To run the Python welcome demo, execute the following command from the top-level directory:
python3 -m visionary_welcome.python.welcome -i192.168.1.10 -dVisionary-SDepending on your environment, you may need to use python or python3. Remember to adjust the IP address (-i) and device type (-d) to match your specific device.
To build the C++ samples, it is suggested to proceed like this [4]:
-
cmake -B buildoptionally also specify other options like -G for custom generator
Now you can build the files with the chosen build-system you’ve generated them for, for instance, open the solution in VisualStudio or run make/ninja.
-
cmake --build build
To run the C++ welcome demo, follow these steps:
-
Navigate to the
build/directory from the top-level directory:
$ cd build/-
Execute the
welcomedemo with the specified IP address and device:
$ ./welcome -i127.0.0.1 -dVisionary-SRemember to adjust the IP address (-i) and device type (-d) to match your specific device.
Depending on the nature of your question, there are two support channels:
-
For questions regarding the code shared in this repo please check the FAQ first and search if an issue already exists. If a related issue doesn’t exist, you can open a new issue using the issue form.
-
For application or device specific questions look for common solutions and knowledge articles on the Sick Support Portal. If your question is not answered there, open a ticket on the Sick Support Portal.