Turn your device into a professional AV Control center.

AVCommander User Manual

OVERVIEW

AVCommander is a professional application for iPhone and iPad that turns your iOS device into a powerful AV equipment control panel over IP networks. Instead of complex programming and using third-party controllers, AVCommander allows you to create an intuitive control interface "on the fly" by simply adding devices and their commands. The application is suitable for controlling DSP processors, HDMI matrices, PTZ cameras, video walls, VCS codecs, and any other equipment that supports TCP, UDP, Telnet, SSH, or HTTP protocols.

KEY FEATURES

• Dynamic Interface Generation: The control interface is built automatically based on the devices and commands you add.
• Wide Equipment Support: Ready-made UI templates for Audio (DSP), Video (matrices, video walls), Camera (PTZ), Codec, Congress, and other device types.
• Flexible Command Management: Ability to add, edit, and delete commands. Support for buttons, toggles, and sliders.
• Multiple Protocols: Native support for TCP, UDP, Telnet, SSH, and HTTP (REST API).
• Import and Export Configurations: Fast system deployment and backup using JSON files.
• Access Protection: Ability to set a UI password to prevent unauthorized access to settings.
• Server Independence: Direct peer-to-peer communication with equipment without intermediate servers.

GETTING STARTED WITH AVCOMMANDER

Download and Installation

1. Go to the App Store on your iPhone or iPad.
2. Find the AVCommander application and install.
3. Choose a lite or dark theme on your iPhone or iPad. The app is adaptive.

Basic Settings

1. Launch the application.
2. Go to the "Settings" ⚙️ section by tapping the corresponding icon.

• Language: Select your preferred interface language: English, Arabic, Chinese, French, German, Hindi, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Spanish, Swedish, Thai, Turkish.
• UI Password: Set a 6-digit password to lock access to Edit Mode from Control Mode. This adds a layer of security.


• Configuration: Here you can Export To JSON Config File (export the current configuration of all devices to a JSON file for backup) or Import From JSON Config File (import a ready-made configuration for quick system deployment).

  Ready-made configurations are available in the Drivers Library.

EDIT MODE - ADDING DEVICES

In this mode, you add, configure, and remove devices. To enter it, tap the "Edit Mode" button on the main screen.

Adding a New Device

1. While in Edit Mode, tap the "Add New" button.

In the popup window, select the device type:

• Audio: For DSP processors, mixers, etc. You can give a custom name to sources when creating a device. By default Input/Output.

• Video: For matrices, video processors, video walls. You can give a custom name to sources when creating a device. By default Input/Output or Source.

• Camera: For PTZ cameras.

• Codec: For video conferencing codecs.

• Congress: For congress systems and conferencing systems.

• Other: For any other IP-controllable equipment (players, TVs, LED screens, etc.).

Fill in the device information:

• Device name: Enter a descriptive name (e.g., "Barco GreenBCM").
• IP-address: Enter the device's IP address on the local network (e.g., 192.168.0.100).
• Port: Specify the control port (e.g., 23 for Telnet, 80 for HTTP).
• Protocol: Select the communication protocol: TCP, UDP, Telnet, SSH, or HTTP.

Tap "Save" to save the device. It will appear in the list. The device is saved automatically.

By tapping and holding the device cell, you can move it up or down the list.

To delete a device, swipe left on it. A confirmation dialog will appear.

Editing a Device

In Edit Mode, tap the cell of the desired device. The "Edit Device" screen opens, where you can:

• Modify basic settings (name, IP, port, protocol).
• Move device commands. The device's core commands cannot be deleted, hidden, or moved.


• Add new device commands.
• Click the 👁️‍🗨️ icon to hide or show device commands in the UI.


• Delete device commands.

Managing Commands

In the "Device commands" section, you can create control elements for your device.

1. Tap the "Add Command" button.
2. The "Edit Command" screen opens, where you need to configure:
   • Button name: The name displayed on the button (e.g., "Power On", "Up", "Preset 1").
   • Command: The actual command to send to the device.
     • ASCII: Text string, e.g., [POWR1]\r\n
     • HEX: Hexadecimal code, e.g., 5B 50 4F 57 52 31 5D 0D 0A
     • HTTP: Endpoint path, e.g., /cgi-bin/api.cgi?cmd=move


3. Important: For sliders and toggles, you can use variables:
   VolumeSet{$V} — where {$V} is the slider value in ASCII format
   VolumeSet{$H} — where {$H} is the slider value in HEX format
   Power{$ON} — where {$ON} will substitute 'ON' or 'OFF'
   Power{$On} — where {$On} will substitute 'On' or 'Off'
4. Format: Select ASCII or HEX command format.
5. Type: Select how the control element will appear:
   • button: Simple tap.
   • slider: For value control (volume, brightness). When this type is selected, additional fields appear for Min, Max, and Symbol (e.g., dB, %).
   • toggle: Can have two states (On/Off or 0/1).


6. Tap "Save" to add the command. The new control element will appear on the device card and UI.

CONTROL MODE

1. To switch to control mode, tap the "Build New UI" button.
2. You will see device categories. Tap on a category card to open the control panel. Each device will appear in the UI by name and in the order added (top to bottom).

3. The control panel displays all the elements you created: buttons, toggles, and sliders. Simply tap them to send commands to the equipment.

PASSWORD

UI Password

1. Go to "Settings".
2. Tap on "UI Password".
3. Enter a 6-digit password and confirm it.


4. After this, the password will be required each time you exit Control Mode. To lock exiting the app, use the Guided Access feature on iPhone or iPad.


5. To remove the password, go to Settings, tap "UI Password" and select "Delete password to unlock UI?" in the dialog box.

TROUBLESHOOTING

Problem	Possible Solutions
Device does not respond to commands	1. Verify the IP address and port in device settings. 2. Ensure your iOS device and AV equipment are on the same network. 3. Check that the correct protocol is selected (TCP, UDP, Telnet, SSH). 4. Verify the command format (ASCII or HEX). 5. Check command syntax (e.g., presence of \r\n characters).
Device does not appear in the list	1. Make sure you are in "Edit Mode". 2. Verify that the device was successfully added (a confirmation message appears when saving).
Cannot import JSON file	1. Ensure the file has the correct structure and is not corrupted. 2. Try exporting the current configuration to see the reference JSON structure. 3. Try importing a JSON configuration from the Drivers Library.
Forgot UI password	Unfortunately, for security reasons, the password cannot be recovered. The only solution is to delete and reinstall the app. All device configurations will be lost if you did not export them beforehand.

FAQ (Frequently Asked Questions)