INOGENI U-CAM USB 3.0 Camera to HDMI Converter User Guide

IMOGENE U-CAM

User guide Version 1.2
7/12/22

VERSION HISTORY

Adding RS232 API.
Adding REST API.
1.2| 12-Jul-22| Update image to support new hardware revision.
Change REST API functions to have the same name as RS232 API.
Add HTTP to HTTP redirection for the webpage.

TYPICAL APPLICATION

Here is a typical connection diagram used for the U-CAM device in a videoconferencing setup.

INOGENI U-CAM USB Camera + USB Micro to HDMI 4K

DEVICE INTERFACES

Here are the device’s interfaces.

1. USB input #1
2. USB input #2
3. LAN port
4. USB 2.0 output
5. HDMI output
6. RS232 port
7. +12V power input
8. USB devise detection LEDs
9. Factory upgrade switch
10. System activity led

LEDS BEHAVIOR

Here is the LEDs behavior:

USB input

System activity led

SPECIFICATIONS

Here is the complete specification.

Physical details

1 x terminal block connection.
1 x 12V power supply.
Operating temperature| 0° to 45° C (32° to 113° F)
Storage temperature| -40° to 105° C (-40° to 221° F)
Origin| Canada
Warranty| 2 years

USB inputs

2x USB 3.0 inputs| Capture video and audio from USB 3.0 and 2.0 cameras
Capture is done from a single camera at a time
---|---
Video capabilities| MJPEG: Up to 1080p30 using USB 2.0/3.0
YUYV: Up to 1080p60 using USB 3.0, 1080p10 using USB 2.0
Audio capabilities| The device will capture embedded audio from a USB camera or external USB device
and will output through HDMI.

HDMI output

USB output

USB-B connector| The device will expose a UVC interface over USB 2.0 up to 720p30 MJPEG
---|---

Compatibility

Operating system| NO driver installation is necessary
Windows 7 and above (32/64-bit)  macOS 10.10 and above,
---|---
Cameras Supported| Cameras (or video Source) with a USB output
Software Compatibility| UVC-compliant. Runs with all software compatible to
DirectShow/MediaFoundation, V4L2, QuickTime, and AVFoundation.

SERIAL COMMUNICATION PROTOCOL

Here is the complete list of commands provided through the serial connection. The pinout is indicated on the enclosure.
Typically, commands will return ACK in case of success and NACK in case of failure.
Note that if the serial interface was disabled using REST API, commands will not be parsed, and no response will be provided.
Baud rate: 9600 // Data bits: 8 // Stop bits: 1 // Parity: None // Flow control: None

The sign specifies the direction.
We multiply the argument by the camera
smallest step, and if the speed is too fast, we go
as fast as the camera allows. We recommend
using values between -10 and 10.| Relative pan
TILT| 1 argument (integer)
The sign specifies the direction.
We multiply the argument by the camera
smallest step, and if the speed is too fast, we go
as fast as the camera allows. We recommend
using values between -10 and 10.| Relative tilt
ZOOM| 1 argument (integer)
The sign specifies the direction.
We multiply the argument by the camera
smallest step, and if the speed is too fast, we go
as fast as the camera allows. We recommend
using values between -10 and 10.| Relative zoom
SETHDMI| 1 argument (integer)
0 => 1080P60
1 => 1080P50
2 => 720P60
3 => 720P50
4 => 4K24
5 => 4K25
6 => 4K30| Set HDMI output mode
SETVIDEOFORMAT| 1 argument (integer)
0 => 1st preferred format
1 => 2nd preferred format
2 => 3rd preferred format
3 => 4th preferred format| Set USB video input format

LAN COMMUNICATION PROTOCOL

You can access the device settings through its LAN interface. The LAN interface uses DHCP. You can obtain the IP from the Inogeni Control App or from the serial port IP command.

CDC-NCM COMMUNICATION PROTOCOL

The device can also be controlled through the CDC-NCM interface exposed on the USB2.0 device port.
This interface has the same functions as the LAN interface, except the requests are done through USB in order to ease configuration.
CDC-NCM IP address: 169.254.10.10

WEBPAGE

Here is the webpage that can be used to configure and upgrade the device.
The username is “admin” and the default password is “admin”.

The first time you access the webpage, your web browser is likely to complain that the connection is insecure. The reason for this is that we are using a self-signed HTTPS certificate because certificate providers will not provide certificates for addresses that are not globally accessible.
The webpage can set HDMI resolution, USB video input format, webpage password, or the REST API access token. Please note that in the case of the REST API token, we can only ask for the device to generate a new randomly generated token. It can also be used to upgrade the device firmware.

REST API

The REST API needs to have Authorization: Bearer in the HTTP header. The response will be JSON formatted with a “message” field containing a JSON string explaining the cause of the error if any. Note that we are using a self-signed certificate.
Here is the complete list of commands supported through the REST API

GET
https:///api/v1/status.| | 200 => success
401 => authorization error| A JSON object with multiple
fields
POST
https:///api/v1/setHdmi| mode=< hdmiModeIndex >
0 => 1080P60
1 => 1080P50
2 => 720P60
3 => 720P50
4 => 4K24
5 => 4K25
6 => 4K30| 200 => success
400 => error
401 => authorization error| A JSON object with a message field explaining error if any
POST
https:///api/v1/setVideoFormat| format=
0 => 1st preferred format
1 => 2nd preferred format
2 => 3rd preferred format
3 => 4th preferred format| 200 => success
400 => error
401 => authorization error| A JSON object with a message
field explaining error if any
POST
https:///api/v1/
disableSerialInterface|
If an integer is 0, will disable
serial interface, otherwise
will enable it.| 200 => success
400 => error
401 => authorization error| A JSON object with a message
field explaining error if any
GET
https:///api/v1/serial read| | 200 => success
400 => error
401 => authorization error| JSON object
with message field containing
characters read from the serial port
POST
https:///api/v1/serialWrite| | 200 => success
400 => error
401 => authorization error| A JSON object with a message field explaining error if any
POST
https:///api/v1/pan|
The sign specifies the direction.
We multiply the argument by
the camera’s smallest step,
and if the speed is too fast,
we go as fast as the camera
allow. We recommend using
values between -10 and 10.| 200 => success
400 => error
401 => authorization error| A JSON object with a message field explaining error if any
POST
https:///api/v1/tilt|
The sign specifies the direction.
We multiply the argument by
the camera’s smallest step,
and if the speed is too fast, we go as fast as the camera
allow. We recommend using
values between -10 and 10.| 200 => success
400 => error
401 => authorization error| A JSON object with a message field explaining error if any
POST
https:///api/v1/zoom|
The sign specifies the direction.
We multiply the argument by
the camera’s smallest step,
and if the speed is too fast,
we go as fast as the camera
allow. We recommend using
values between -10 and 10.| 200 => success
400 => error
401 => authorization error| A JSON object with a message field explaining error if any

INOGENI CONTROL APP

You can use our Control App to monitor firmware information, and upgrade and configure your unit.

NOTE: You need to use the USB-B to USB-A cable provided with the box for the Control App to detect the unit.

SUPPORT

Engineered by video professionals, for video professionals, it is your most compatible USB 3.0 device. INOGENI expertise at your fingertips:

• Expert Technical Support team at support@inogeni.com for immediate help or if you have any technical questions about our products.
• Extensive Knowledge Base to learn from other customers’ experiences.

© Copyright 2022 by INOGENI INC. All Rights Reserved.
INOGENI name and logo are trademarks or registered trademarks of INOGENI. Use of this product is subject to the terms and conditions of the license and limited warranty in effect at the time of purchase. Product specifications can change without notice.

INOGENI, Inc.
979 de Bourgogne avenue, suite 530
Québec
G1W 2L4 (QC) Canada

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>