INOGENI CAM230

User guide
Version 1.1
June 2, 2023

VERSION HISTORY

– Added power consumption limit for USB cameras.
– Added RCM statement.
– Added minor modifications to RESTAPI.
– Added firmware update procedure.

TYPICAL APPLICATION

BLOCK DIAGRAM

Here is a simple block diagram to better understand the usage of the product. The device embeds a video switch that can connect to USB3.0/2.0 and HDMI cameras. The device will output video content from the selected source over HDMI and USB2.0 outputs simultaneously.
This can give you a great asset to your videoconferencing equipment to switch camera interface easily without going into your UC settings.

AUDIO ROUTING

The device can connect to USB microphones/speakerphones and on a HDMI feed that includes audio. These sources can be sent over the HDMI output and to the USB2.0 output.
The USB2.0 interface embeds a digital audio interface which implements a microphone and a speaker device. Ultimately, the UC software connected to the USB2.0 camera interface can receive and transmit audio from/to the connected USB videobar.

DEVICE INTERFACES

Here are the devices interfaces.

1. Input selection buttons| 4. USB2.0 camera output| 7. RS232 and remote interface
---|---|---
2. Input status LEDs| 5. USB3.0 camera inputs| 8. LAN/PoE interface
3. HDMI output| 6. HDMI camera input| 9. +12VDC power input

LEDS BEHAVIOR

Here are the LEDs behavior:

Power input

OFF| No power.
SOLID| Device is powered up.
PoE
OFF| Not powered from PoE.
SOLID| Powered from PoE.
Input led
OFF| Input not detected and not selected.
LOW| Input detected and not selected.
FLASH-LOW| Input not detected and selected.
HIGH| Input detected and selected.

SPECIFICATIONS

Here is the complete specification.

Physical details|
---|---
Dimensions (W x L x H)| 17.33 cm x 11.57 cm x 3.26 cm 6.82” x 4.55” x 1.28”
Power supply| 12V (100-240 VAC 50/60Hz to 12V/1.2A DC) – or – PoE source compliant with IEEE 802.3af (802.3at Type 1)
Weight| 606 g
Package content| 1 x USB 2.0 Type-B to Type-A cable (3ft).
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)
Relative humidity| 0% to 90% non-condensing
UPC code| 51497302825
Origin| Canada
Warranty| 2 years
USB inputs|
---|---
2x USB 3.0 inputs| 1x USB 3.0/2.0 camera
Uncompressed, YUYV/NV12/I420 – 1080p30
MJPEG – 1080p30
USB Power| Up to 1.2A shared between the USB ports
HDMI input|
---|---
Resolution| 1080p50/60 fps, 720p50/60 fps
Connector| HDMI
HDMI output|
---|---
Resolution| 3840x2160p23.98/24/25/29.97/30 fps, 1080p50/60 fps, 720p50/60 fps
Connector| HDMI
USB 2.0 output|
---|---
USB-B Type-B connector| Device will expose a UVC interface over USB 2.0 up to 1080p30 MJPEG with a
digital audio input and output interfaces
Audio|
---|---
Digital audio I/O| Embedded in HDMI or USB
Control|
---|---
Control options| Front buttons
RS-232
LAN
USB
IP interface| 100 Mbps half-duplex (autonegotiation not supported)
Supports DHCP or static IP addressing
RS232 interface| Baud rate: 9600
Data bits: 8
Stop bits: 1
Parity: None
Flow control: None
Certifications|
---|---
HDCP compliant| The device does not decrypt BD/DVD movies, satellite/cable receivers or other
encrypted sources.
Certifications| Cameras (or video Source) with a HDMI or USB outputs
TAA-compliant| 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.
As written on the back of the device, here is the pinout of the terminal block.

| Pin 1: Receive
Pin 2: GND
Pin 3: Transmit
Pin 4: 5V supply (for INOGENI Remote)
---|---

Typically, commands will return ACK in case of success and NACK in case of failure.
Note that if 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

password and rest api token)
RESET| None| Reset/reboot the device
IP| None| Returns IP address
VERSION| None| Returns firmware version
STATUS| None| Return devices, video/audio inputs and
HDMI output status
PAN| 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 asthe camera allow. We recommend using values between -10 and 10.| Relative pan of the selected camera
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 allow. We  recommend using values between -10 and 10.| Relative tilt of the selected camera
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 allow. We  recommend using values between -10 and 10.| Relative zoom of the selected camera
SETHDMI| 1 argument (integer)
Possible parameters:
0 => 1080P60
1 => 1080P50
2 => 720P60
3 => 720P50
4 => 4K24
5 => 4K25
6 => 4K30| Set HDMI output mode
SETVIDEOFORMAT| 2 arguments (integer)
1st arg:
1 => USB input #1
2 => USB input #2
4 => Test pattern
2nd arg: | Set video input format
GETVIDEOFORMATS| 1 argument (integer)| Get video input format
| The argument specifies the port of the video input for which  we want to get the available formats.
1 => USB input #1
2 => USB input #2
3 => HDMI input
4 => Test pattern|
SETAUDIOINPUT| 1 argument (integer)
The argument specifies the index (start at 0) of theaudio input.
To see available inputs, use STATUS command.| Set audio input
SETVIDEOINPUT| 1 argument (integer)
The argument specifies the port of the video input.1 => USB input #1
2 => USB input #2
3 => HDMI input
4 => Test pattern
To see available inputs, use STATUS command.| Set video input
SETVIDEOINPUTMODE| 1 argument (integer)
The argument specifies if we want manualautomatic switching.
0 => automatic switching
1 => manual switching| Set video input switching mode

INOGENI REMOTE

The INOGENI Remote needs to be connected to the terminal block port in order to operate. Apply wiring accordingly. This remote is sending serial commands to the device. Make sure to set the DIP SW6 below the device to ON in order to apply power to the remote before going further. See “DIP SWITCHES” section and user manual of the INOGENI REMOTE for more details.

Do not plug a RJ45 cable between the INOGENI device and the REMOTE.

Terminal block:
Pin 1 : Receive
Pin 2 : GND
Pin 3 : Transmit
Pin 4: 5V supply RJ45:
Pin 1: 5V supply
Pin 2,3,4,5: NC
Pin 6: GND
Pin 7: RX
Pin 8: TX|
---|---

LAN COMMUNICATION PROTOCOL

You can access the device settings through its LAN interface. The LAN interface use DHCP and static IP addressing. You can obtain the IP from the Inogeni Control App or from the serial port IP command. Note that LAN is set to  100Mbps halfduplex.

CDC-NCM COMMUNICATION PROTOCOL

The device can also be controlled through 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 to ease configuration.
CDC-NCM IP address: 169.254.10.10

POE

The device can be powered from a 12V power supply or from a PoE compliant source. If the 12V power supply is connectedthis one is taken in priority.

WEBPAGE

Here is the webpage that can be used to configure and upgrade the device. This webpage is accessible through IP or
through the CDC-NCM interface over USB2.0.
The username is “admin”, and the default password is “admin”. The STATUS page will give you information about the firmware installed. video and audio devices that you can monitor. The CONFIGURATION tab will allow you to :

• Set the HDMI resolution over HDMI

• Set the selected camera source

• Set the video input switching mode
  o AUTO : Device will switch to newly detected video source
  o MANUAL : Device will only switch when we get the control to do it.

• Set the audio input from USB sources or HDMI input.

The SYSTEM tab will allow you to :

• Change the current password for accessing device settings.
• Get/Set REST API access token needed using REST API interface.
• Change network settings of your device.
• Restore default settings and reboot the system.
• Update your system.

To update your system, please do the following :

• Click on the “Choose File” button and browse to the WIC file downloaded from our website.
• Click on “Update CAM230” button to proceed to the update. The operation can take up to 1 minute. The device will reboot and browser will be refreshed.

The DOCUMENTATION tab will allow you :

• Get to the latest user guide.
• Go to product webpage.

The first time you access the webpage, your web browser is likely to complain that the connection is insecure. The reason for this is because we are using self-signed HTTPS certificate, because certificate providers will not provide certificates for address 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  enerated token. It can also be used to upgrade the device firmware.

REST API

The response will usually be JSON formatted with a “message” field containing a JSON string explaining the cause of the error or “success” in case of success. Note that we are using self-signed certificate.
You can enable a bearer authentication in the HTTP header (Authorization: Bearer ) through our configuration page to increase security on the API.
Here is the complete list of commands supported through the REST API (excluding password change, firmware update, bearer token get/set):

Command URL / Description| Body arguments| Return code| Return body
---|---|---|---
GET/POST
https:// /api/v1/rstrRestore default settings (including
password and rest api token)| | 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/resetReset/reboot the device| | 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET
https:// /api/v1/versionReturns firmware version| | 200 => success
401 =>
authorization error| {
“major”: ,
“minor”:
}
GET
https:// /api/v1/statusReturn devices, video/audio inputs and
HDMI output status| | 200 => success
401 =>
authorization error| JSON object with multiple
fields
GET/POST
https:// /api/v1/panRelative pan of the selected camera| pan=

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 allow. We recommend using values  between -10 and 10.

| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/tiltRelative tilt of the selected camera| tilt=

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 allow. We recommend using values  between -10 and 10.

| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/zoomRelative zoom of the selected camera| zoom=

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 athe  camera allow. We recommendusing values between  -10 and 10.

| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/zoomRelative zoom of the selected camera| zoom=

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 athe  camera allow. We recommendusing values between  -10 and 10.

| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/setHdmiSet HDMI output mode| mode=

Possible parameters:
0 => 1080P60

| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
| 1 => 1080P50
2 => 720P60
3 => 720P50
4 => 4K24
5 => 4K25
6 => 4K30| |
GET/POST
https:// /api/v1/setVideoFormatSet video input format| x-www-form- urlencoded
input=
format=Possible
parameters:
1 => USB input #1
2 => USB input #2
4 => Test pattern| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET
https:// /api/v1/getVideoFormatsGet video input format| 4 => Test pattern
input=
If input argument is not provided,
will use currently selected inputPossible parameters1 => USB input

1

2 => USB input #2
3 => HDMI input
4 => Test pattern| 200 => success
400 => error
401 =>
authorization error| JSON array containing all
formats for requested input.
GET/POST
https:// /api/v1/setAudioInputSet audio input| input=

The argument specifies the index
of the audio input. To see
available inputs, use “status”
command.

| 200 => success
400=> error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/setVideoInputSet video input| input=

Possible parameters:
1 => USB input #1
2 => USB input #2
3 => HDMI input
4 => Test pattern
The argument specifies the index
of the video input.
To see available inputs, use
“status” command.

| 200 => success
400=> error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/setVideoInputModeSet video input switching mode| mode=

Possible parameters:
0 => automatic switching
1 => manual switching

| | {
“message”:
}
GET/POST
https:// /api/v1/
disableSerialInterface Disable serial interface| | 200 => success
400 => error
401 =>
authorization error| {
“message”:
}Message field contains
characters read from RS232
GET/POST
https:// /api/v1/serialWriteWrite serial data to RS232. Giving
content to write in URL is not supported.| | 200 => success
400 => error
401 =>
authorization error| {
“message”:
}
GET/POST
https:// /api/v1/setNetworkConfigure network settings| x-www-form- urlencoded
mode=<static,dhcp>
If mode is static, must provide
following args:
ip=
netmask=
If mode is static, you can also
specify a gateway:
gateway=| 200 => success
400 => error
401 =>
authorization error| {
“message”:
}

It is also possible to embed arguments to an API call inside the URL to ease configuration with some control systems with the following topology: GET https:///api/v1.COMMAND/ARG1=value&ARG2=value

For example, using the SETVIDEOFORMAT, you can issue the following request: GET https:///api/v1/setVideoFormat?input=1&format=0
This request will set the input #1 to format index 0.
The following commands allow to perform password management, bearer token management and firmware update. The authentication used is basic auth, and we use the same user and password as the webpage (default user=admin password=admin).

Command URL / Description| Body arguments| Return code| Return body
---|---|---|---
POST
https:// /api/v1/changePassword?
password= Change the webpage password to