IPedit V3.6.3 - Release Notes

This document contains the following sections:

Application Requirements

What's new in this release?

What is IPedit and how do I use it?

Installing IPedit

Running IPedit

Uninstalling IPedit

Application Requirements

IPedit is a 32-bit Unicode Windows application designed to run under Windows XP, Windows Vista, Windows 7, Windows 8, and Window 10.  

The user interface is currently available in English only, but support for other languages may be developed in the future.  IPedit uses resource DLL's which provide the user interface text in various languages.  IPedit automatically picks the appropriate language DLL to match the system locale selected by the user (in Control Panel, Regional and Language Settings).  If the required language DLL is not present, IPedit defaults to the English language resources that are compiled into the application executable.  An enhanced "About IPedit" dialog displays information regarding the IPedit build and resource DLL settings.  To support user interface languages other than English, a new resource DLL must be created for each language.

IPedit requires the following minimum firmware versions:

1: RVON-1 and RVON-2 devices share the same firmware image and are collectively called RVON Keypanels or RVON-KP (the default firmware file name is now rvonkp.bib).

2: OMI includes OMI-16, OMI-32, OMI-48, and OMI-64 devices (depending on how many channels are licensed).

3: OKI includes OKI-2 for RP-1000 and CLD family keypanels, and OKI-1 for KP32 Classic keypanels

4: OKP includes the OKP-2 and OKP-8 KP-Series (KP-5032 and KP-4016) keypanels (depending on how many channels are licensed). KP-Series (KP-5032 and KP-4016) keypanels with RVON compatibility are shown as RVON-KP devices in IPedit

5: OAP includes OAP-5 and OAP-10 ROAMEO devices (AP-1800) where the channel count is based on CODEC selection.

6: ODIN includes ODIN (OMNEO) and ODIN-R (RVON) devices.

7: EPAP includes EPAP (OMNEO) and EPAP-R (RVON) PAP-5032 devices.

8: RVON+ includes RVON+16 and RVON+32 devices.

<back to top>

What's new in this release?

Version 3.6.3

Various improvements and bug fixes:

  • Improved support for ROAMEO configuration of DECT Full Capacity
  • A checkbox is now available in IPedit labeled “Allow Full Capacity”, when communicating with ROAMEO Access Points V8.5.0 or later.
  • When unselected (default), the AP will reserve timeslots to automatically adjust and optimize performance when interference is detected. This is the recommended setting.
  • When selected, the AP will allow the maximum number of beltpacks to connect, but does not reserve timeslots to automatically adjust and optimize performance with interference.
  • IPedit versions V3.6.1 and V3.6.2 did not update the state of this checkbox properly when first connecting to a ROAMEO access point."

    • <back to top>

    Version 3.6.2

    Support for devices with improved security for ad-hoc commands

  • On devices that support it, the following operations have been re-implemented so that they are more secure:
  • Clear channel and pass-through statistics
  • Tear down channel(s)
  • Reboot device
  • Enable/disable Telnet
  • Admin permissions are also now required in order to enable or disable Telnet on all devices.

    • Support for two new commands in device context menu

  • On devices that support it, the following operations are now available:
  • Reset Authentication Table
  • Restore Factory Defaults
  • Hold CTRL+SHIFT when right-clicking device to access these new commands
  • Admin permissions are required for both commands.

    • Support for devices implementing compliance with California Senate Bill 327

  • For new devices, authentication must be configured when first connecting to the device.
  • This is necessary for compliance with California Law, re: SB327: An act to add Title 1.81.26 (commencing with Section 1798.91.04) to Part 4 of Division 3 of the California Civil Code, relating to information privacy.
  • For devices that support this, IPedit will switch to the Authentication tab and display a message notifying the user of this requirement.
  • Until authentication has been configured, the device will not allow any changes to be made; and IPedit will switch to read-only mode.

    • Various improvements and bug fixes:

  • Fix: Earlier versions of V3.6.x might crash on startup on some computers
  • Fix: Mouse wheel scrolling of the grid area didn't work if mouse was over left side heading
  • Fix: Intercom tab showed nonsensical port/frame data if device was not communicating

    • <back to top>

    Version 3.6.1

    Support for ROAMEO diagnostics

  • New menu Help | ROAMEO Diagnostics launches dialog to detect common ROAMEO configuration problems/errors, including:
  • Beltpacks with duplicate BPIDs
  • Beltpacks with Zone Masks that don't correspond to any Access Point
  • Access points with the same System ID that are not using the same codec
  • Access points with the same System ID that don't share the same PIN
  • Access points or beltpacks with a transmit power other than "Normal"
  • Access points home to one or more beltpacks but set to use DHCP
  • More than one Sync Master, or no Sync Master, identified in a System

    • Various improvements and bug fixes:

  • New: Support for a new ROAMEO codec (G.722-EX) for improved performance in tough RF environments
  • New: Consolidated ROAMEO Beltpack Configuration items into new section in grid
  • New: Support for future Access Point and Beltpack configuration items and status indicators
  • Fix: Showed wrong icon for unknown device types

    • <back to top>

    Version 3.6.0

    Support for EPAP, RVON+ and ODIN-R device types

  • New device types supported in the catalog, including:
  • EPAP and EPAP-R (OMNEO and RVON versions of the PAP-5032)
  • RVON+ (including the RVON+16 and RVON+32)
  • ODIN-R (ODIN with support for RVON channels)
  • New Intercom tab now shows information about connected ODIN devices
  • EPAP connections support a data-only mode for long distance OMNEO connections using EPAP-D device type

    • Various improvements and bug fixes:

  • Fix: Channels on intercom devices that do not have a port allocated to them are now indicated in the Channel Status LEDs
  • Fix: Unlicensed/unallocated channels are now shown with a greyed Channel # in the grid header
  • Fix: Ethernet tab is now always visible to show Ethernet status
  • Fix: Saved setup files for ODIN devices might not load correctly
  • Fix: Version V3.5.x of IPedit cannot send Authentication Table to KP-Series keypanels running V2.3.0 or later
  • Fix: Better validation of which devices and codecs can use VAD and/or adaptive VAD
  • Fix: Improved detection of device type changes and catalog management
  • Fix: Improved handling of changes in IP address for catalog devices
  • Fix: Autosizing of column widths didn't work properly if some channels were hidden
  • Fix: Renamed Device tab to either OMNEO or RVON tab depending on the type of the device
  • Fix: Send Changes dialog now groups items that are sent as a group
  • Fix: Improved copy/paste to better handle skipping hidden channels
  • Fix: Many fixes and improvements to the Paste Special dialog
  • Fix: Line items in the Paste and Send dialogs are now in the same order as in the grid
  • Fix: Improved handling of saved setup files
  • Fix: Device discovery at startup is now faster
  • Fix: Improved backward compatibility with devices running older firmware
  • Fix: Handle case where ODIN device has no OMNEO channels allocated
  • Fix: Wrong labels displayed for OMI Ethernet ports
  • Fix: Improved display of PTP and EXT clock status for ODIN devices
  • Fix: DECT sync state not loaded correctly from saved setup file
  • Fix: DECT Zone Mask font updated to work with newer operating systems
  • Fix: Added context menu to tabs to allow copy operations
  • Fix: Improved support for multiple windows

    • <back to top>

    Version 3.5.1

    Various improvements and bug fixes:

  • Fix: Allow entering of destination device IP address for OMNEO devices (look up device name in catalog).
  • Fix: If device name lookup by IP address is unsuccessful, warn that OMNEO connections require a device name.
  • Fix: Allow double click of destination device name to begin editing (was broken in V3.5.0).
  • Fix: Show destination device name in red if the name is blank but the IP address is not.
  • Fix: Don't show destination channel description as changed, it is read-only.
  • Fix: When multiple windows were open showing different device types, the grid view could display incorrectly.

    • <back to top>

    Version 3.5.0

    Added support for ODIN devices (OMNEO Digital Intercoms).

  • The ODIN is a 1RU intercom with support for up to 128 ports in a single frame.
  • Ports types can be configured as OMNEO (128 max), AIO (16 max), or 2W (2 max).
  • Multiple ODIN frames can be connected by IFL (Inter-Frame Links) to create a single intercom (up to 8 frames totalling 1024 ports).

    • Various improvements and bug fixes:

  • New: IPedit now supports devices with up to 128 channels.
  • New: IPedit indicates which ports are not licensed (e.g. when an ODIN frame is sized for more ports than it is licensed for).
  • New: IPedit indicates which ports cannot be configured in IPedit (e.g. AIO and 2W ports).
  • New: IPedit now uses an editable cell with spin controls instead of a drop list for entering destination channel numbers.
  • New: IPedit now allows ending channel number editing by pressing plus ('+') to auto-assign channels when multiple cells are selected.
  • Fix: IPedit now warns if you try to add a device that is already in the catalog.
  • Fix: Don't allow modifying of an existing password in the authentication table, always start edit with a blank password.
  • Fix: Don't show Telnet or Download privileges in Authentication Table for device that don't support them.
  • Fix: Re-arranged display of privileges in the authentication table to RWA from ARW (presented in order of least to most privilege).
  • Fix: Don't allow a domain name to be set if a DNS Server is not defined.
  • Fix: Selective sending of changes didn't work for channels if there were no changes to the device tab.
  • Fix: Saving OMNEO setups to file did not properly save/restore the authentication table. IPedit would crash on load.
  • Fix: Controller IP address was not loaded from file for OMNEO devices with both Controller and Audio IP addresses.
  • Fix: Saving and restoring UTF-8 (Unicode) device and channel descriptions did not work properly.
  • Fix: Destination IP address is now read-only for OMNEO devices (connections must use device name).
  • Fix: IPedit now disconnects (releases session) from current device when exiting the application.
  • Fix: Several small fixes to copy/paste operation (some settings were not included).
  • Fix: If user is read-only, don't allow browsing for new channel partner device.
  • Fix: Preferences | Discovery tab did not correctly show which network interface was selected.
  • Fix: Don't let IP address editing start by entering a dot.
  • Fix: Don't let non-changes (abort edit, or edit with no change) create an undo entry.

    • <back to top>

    Version 3.4.1

    Various improvements and bug fixes:

  • New: Added warning when changing DECT Zone Selection for a beltpack.
  • New: Device and Channel descriptions now support UTF-8 for support of Unicode text.

    • <back to top>

    Version 3.4.0

    Added support for ROAMEO DECT Series Beltpacks and Access Points with built-in OMNEO capabilities.

  • The AP-1800 is a DECT based Access Point with OMNEO intercom connectivity.
  • The TR-1800 is a DECT based Beltpack with Access Point roaming capabilities.
  • The Access Points are identified in IPedit as OAP-5 and OAP-10 devices (5 or 10 channel mode depending on CODEC selection).

    • Various improvements and bug fixes:

  • New: Added support for having more than one catalog file (Catalog | New, Save As, and Open).
  • New: Current catalog file name displayed in status bar.
  • New: Added support for removing all devices from catalog (Device | Remove All).
  • New: Form view collapsible dialogs replaced with tabs to reduce vertical scrolling.
  • New: Added channel group tabs for devices with more than 16 channels to improve channel navigation.
  • New: Removed support for File | Open, and Device | Disconnect, IPedit is now always ONLINE.
  • New: Removed auto-connect preference (always on), IPedit will always connect if username/password are valid.
  • New: Added commonly used actions to toolbar: Device | Add, and Edit | Paste Special, plus new functions: Catalog | New, Open, and Save As
  • New: Added support for AIO Enable checkbox (Device Configuration), to remotely enable/disable AIO mode on devices that support it.
  • Fix: Better support for unique device IDs and catalog management.
  • Fix: Improved backward compatibility with older device catalog files.
  • Fix: Grid view allowed editing of empty cells when no device selected. Fixed.
  • Fix: Improved support for dynamic catalog changes (ie. when a device type changes due to licensing or CODEC selection).
  • Fix: Catalog communications thread could hang when device removed. Fixed.
  • Fix: Warn user when no network interface is selected and an attempt is made to browse for devices.
  • Fix: Reduced flickering in status bar.

    • <back to top>

    Version 3.3.2

    Various improvements and bug fixes:

  • New: Added support for new RVON-IO GPIO audio tracking modes
  • Fix: Previous V3.3.x versions might not save all channels to file (only visible channels got saved)
  • Fix: Sorting a catalog tree node by IP address was broken in previous V3.3.x versions (sorted by MAC address instead)

    • <back to top>

    Version 3.3.1

    Various improvements and bug fixes:

  • Fix: Hide Telnet and Download permissions in authentication table for devices that don't support them.

    • <back to top>

    Version 3.3.0

    Various improvements and bug fixes:

  • New: Supports KP-Series keypanels with RVON compatibility (using a G.711 codec).
  • New: Supports OCA compatible devices for configuring RSTP and Rx Latency.
  • New: Shows the intercom name and port alpha for each channel with devices that can report this information to IPedit.
  • New: Only refreshes channels that are visible in the grid to improve refresh performance.
  • New: Improved catalog management with devices that are capable of reporting a unique ID to IPedit.
  • Fix: Showed "Link is up" checkboxes for three adapters even if device only had one.
  • Fix: Allowed editing of Ethernet speed/duplex settings even if "Use fixed..." not checked.

    • <back to top>

    Version 3.2.3

    Various improvements and bug fixes:

  • New: Supports OKP-8 device type (KP-5032 or KP-4016 licensed for 8 OMNEO channels, 8 inputs, 2 outputs).
  • Fix: Changes to device catalog could result in IPedit crashing or failing to update communication status for catalog devices.
  • Fix: Pressing F3 for context navigation on device name in channel grid could crash IPedit if the device name was not found.
  • Fix: Improved validation on device information form, won't try to validate read-only data.

    • <back to top>

    Version 3.2.2

    Various improvements and bug fixes:

  • New: IPedit can now report uni-directional OMNEO channel status (ie. TX only, or RX only, connections).
  • New: You can now double click on a device in the Add Devices search tab to add it to the catalog.
  • Fix: Undo/Redo did not undo/redo changes made in an edit box that had no yet been committed.
  • Fix: Device domain name is limited to 192 characters (to allow room for device name and service type in device registration).

    • <back to top>

    Version 3.2.1

    Various improvements and bug fixes:

  • Fix: After sending changes, IPedit could sometimes show the older configuration before the device reboots.
  • Fix: In the Device | Add dialog, pressing Find could show the incorrect device type for OKP devices.
  • Fix: Assume unknown device types are OMNEO-type devices rather than RVON-type devices.
  • Fix: Better handling of catalog and preference files that have been saved with previous versions.

    • <back to top>

    Version 3.2.0

    Added support for KP-4000 / KP-5000 Series keypanels with built-in OMNEO capabilities.

  • The KP-4016 is a 1RU keypanel with 14 talk/listen keys.
  • The KP-5032 is a 2RU keypanel with 32 talk/listen keys.
  • Both keypanels have:
  • Dedicated CWW and Mic Sel keys.
  • High resolution color displays.
  • Built-in GPIO and Aux inputs.
  • Built in OMNEO connection capabilities.
  • The keypanels are identified in IPedit as OKP-2 devices (2-channel OMNEO Keypanels).

    • Various improvements and bug fixes:

  • Now you can double-click a device channel/keypanel status LED to navigate to that channel in the grid.
  • Fix: You cannot make changes to device or domain names that involve letter case only.
  • Fix: It was possible to end up with two devices with the same device name in the catalog.
  • Fix: If you specify a domain name with static configuration, you must also specify a DNS server IP address.
  • Fix: It was possible for channel/keypanel status LEDs to be shown disabled, even while connected to device.
  • Fix: Changes to device IP address were not always written to catalog.
  • Fix: Controller and Audio IP addresses for OMI were sometimes reversed.

    • <back to top>

    Version 3.1.0

    Added support for OEI-2 OMNEO 2-channel external box as new device type.

    OMI devices from V5.x.x can now report Controller and Audio IP addresses, and both can be edited when device configured for static IP addresses.

    OMNEO devices can now report MAC address for display in IPedit.

    OMNEO devices can now report Ethernet link status for each interface.

    Added a Refresh button to device discovery dialog to force refresh of discovered devices.

    Improved device discovery process detects when OMNEO devices have received new IP addresses (even if this occurs while IPedit is not running).

    Improvements to device catalog to store more information about devices, including IP addresses, device name and domain, so that catalog can be used to detect changes to device IP address and update the catalog accordingly.  Note: This version can read catalog files created with earlier versions, but the new information stored in the catalog is lost if it is opened with any prior version of IPedit.

    Improved editing and validation of device domain and IP addresses.

    Various other improvements and minor bug fixes.

    <back to top>

    Version 3.0.2

    Fixed reporting of status for each OMNEO Ethernet interface port.

    Allow user to select an interface for device discovery at startup (even if only one interface available). The user may elect not to choose an interface if OMNEO support is not required.

    Allow user to enable/disable device discovery interface warnings (via Edit | Preferences | Discovery)

    <back to top>

    Version 3.0.1

    Added support for OMNEO devices.

    Renamed from RVONedit to IPedit.

    <back to top>

    Version 2.0.3

    Updated to run better under Windows Vista.

    Changes made in Manage Logins take effect immediately, instead of requiring the application to be restarted.

    Improvements made to column sizing context menu actions.

    <back to top>

    Version 2.0.2

    Updated help file.

    <back to top>

    Version 2.0.1

    Support for RVON Keypanels (includes RVON-1 and RVON-2).

    <back to top>

    Version 2.0.0

    Support for RVON-16.

    Support for making changes to more than one device before sending changes.

    Support for opening more than one Window (to view or edit multiple devices at the same time).

    Support for setting and remembering the usernames and passwords of multiple devices simultaneously.

    <back to top>

    Version 1.0.2

    Updated help file.

    <back to top>

    Version 1.0.1

    The initial release of RVONedit.

    <back to top>

    What is IPedit and how do I use it?

    Introduction

    IPedit is a Windows application (replacing RVONedit) providing the Graphical User Interface (GUI) used to monitor and configure RTS OMNEO, RVON, and ROAMEO products.  The OMNEO family currently includes the OMI-16, OMI-32, OMI-48, OMI-64, OKI-1, OKI-2, OEI-2, OKP-2 and OKP-8 products from Bosch Security Systems, Inc.  The RVON family currently includes the RVON-8, RVON-16, RVON-1, RVON-IO, and RVON-C products from Bosch Security Systems, Inc.  The ROAMEO family currently includes the AP-1800 and TR-1800 products from Bosch Security Systems, Inc.  IPedit is to OMNEO, RVON and ROAMEO devices what AZedit is to ADAM, Zeus, and Cronus intercoms.

    IPedit refers to OMNEO, RVON, and ROAMEO products generically as devices (because there are several different types of OMNEO, RVON and ROAMEO products).  Associated with each device is the device configuration (items which the user can change), the device status (read-only attributes of the device), and one or more channels.  Associated with each channel is the channel configuration (again, items which the user can change) and the channel status (read-only attributes of the channel).  IPedit allows the user to add OMNEO, RVON, and ROAMEO devices to a catalog that is automatically maintained between IPedit sessions.  The catalog shows the OMNEO, RVON, and ROAMEO devices in a flat list, and/or sorted by device type.

    The IPedit GUI looks like a typical windows application.  Starting from the top of the application window and working downward, there is a title bar, a menu bar, a toolbar, the user interface area, and a status bar at the bottom.

    The user interface area is divided into three sections.  There is a vertical section on the left containing the device catalog, while the right side is divided horizontally into two sections, the top section containing a scrollable form displaying the device configuration and status, and the bottom section containing a scrollable grid displaying the channel configuration and status.

    The sections are separated by divider bars (or splitter bars).  You can click and drag these bars to size each section to your preference, and the sizes are saved between sessions.  The vertical divider can be double clicked to collapse/expand the catalog, which can also been done by using the View | Device Catalog (Ctrl+T) menu item.  If you double right-click the vertical divider, the catalog section will automatically size itself to the correct width for its contents (or collapse itself if it is already wide enough).

    The keyboard focus can only be in one section at a time, but you can switch between sections by pressing F6 (to move clockwise) or Shift+F6 (counter-clockwise).  You can also switch sections by clicking in a section with the mouse.  If your mouse has a mouse-wheel, you can use the wheel to scroll both the form and grid views vertically.

    Where possible, keyboard shortcuts for common commands have been kept the same as in AZedit (for instance, Send Changes is F10, etc...).

    Adding Devices to the Catalog

    The device catalog is displayed using a collapsible tree, which will initially be empty.  Once the catalog is populated with devices, you can simply click on a device in the tree to select that device for monitoring and configuring (and the information will appear in the device form and channel gird on the right).  

    To add devices to the catalog, select the Device | Add menu item (Ctrl+A).  You can add devices manually by entering an IP Address or OMNEO Device Name, and an optional description and device type.  Once you've entered an IP Address or Name, you can press the Find button to have IPedit contact the device (if possible) and return the device information.  If the device information is correct, you can then add the device to the catalog by pressing the Add button.  You can then continue to enter more device IP Addresses or Names, or press Done to exit the dialog.

    You can also automatically search for devices on your local network by selecting the Search page on the Add Devices dialog (Ctrl+A).  The Search page displays a list of the OMNEO, RVON, and ROAMEO devices found on the local network (the search for RVON devices will not be able to search through a gateway).  Note that the search will only be able to find devices that have the minimum firmware versions listed in the Application Requirements section of this document.  The search also only shows those devices that are not already in the catalog.  If the search discovers new devices, you can add them to the catalog by selecting one or more devices from the list and pressing the Add button.  To select more than one device, you can click and drag within the list, or hold down the control or shift keys while selecting list items.

    In IPedit, each device type is represented by a different color icon (the colors are unimportant but allow you to quickly distinguish differences in device type).  In the device catalog, each element in the tree contains an identifying icon (either identifying the device type, or a collection of devices grouped by type).  For each device in the tree, the device icon will be "bright" if IPedit is able to communicate with the device, and "dark" otherwise.  In addition, the text for the currently selected device will be shown in bold text, and the device icon will be overlaid with the connection state (a small checkmark or 'x' which indicates whether you are connected to the device or not).

    The device catalog display can be customized by using the Edit | Preferences menu item (Alt+Enter) and selecting the Catalog page.  The preferences allow you to select whether to display the catalog as a flat list, or grouped by device type (or both at the same time).  You can also select whether to use the IP address, the device Name, or the device description (if available) as the text displayed in the catalog.

    Devices in the catalog can be sorted by IP address or Name/Description (depending on the view mode).  To sort the devices under a catalog filter node, right-click the node, and select "Sort" from the context menu.

    To remove a device from the catalog, select the device and invoke the Device | Remove menu item.  You can also remove a device by right-clicking the catalog entry and selecting "Remove from Catalog" in the context menu.  If you attempt to remove a device for which changes are pending, you will be alerted by IPedit.

    If you are connected to a device with 'write' or 'admin' privileges (see Connecting to a Device, below), then the right-click context menu for the selected device in the catalog tree will allow you to Teardown All Channels, Clear All Counters/Statistics, or Reboot the device.

    Changing Devices

    Use the device catalog to move between devices by clicking on the tree element of the device you want to view/modify.  Much like a web-browser with Internet sites, IPedit remembers which devices you have visited in the catalog, and allows you to move forward and back through that list by using the View | Back (Ctrl+Left) and View | Forward (Ctrl+Right) menu items.  IPedit automatically refreshes device information on screen, but you can also manually force a refresh for the current view with View | Refresh (Ctrl+Space).  In addition, while the keyboard focus is on any control containing a device Name or IP Address, you may press F3 to navigate to the device with that name/address if it exists in the catalog.

    Connecting to a Device

    When you select a device from the catalog, IPedit attempts (by default) to connect you to the device by initiating an authenticated UDP session with the device.  IPedit supplies a username and password that is verified by the device which then returns a session ID and the access rights granted to the session.  The OMNEO, RVON and ROAMEO devices support an authentication table which can contain up to five entries (each with a username, password, and access rights).  The access rights include:
    When shipped, the OMNEO, RVON and ROAMEO devices have a default authentication table that includes the user 'telex' with access rights of 'RWTD', and the user 'admin' with access rights of 'ARWTD'.  The default password for both users is 'password'.  By default, IPedit will use a username of 'telex' and a password of 'password' when requesting a session.  This means that "out-of-the-box", IPedit will automatically connect to OMNEO, RVON, and ROAMEO devices with the default authentication table.

    Note that the default IPedit connection does not include 'admin' rights.  The 'admin' privilege allows the user to modify advanced configuration items such as: the device name, IP address, netmask, and gateway settings, the device Ethernet interface configuration, SNMP configuration, and the device authentication table.

    In order to modify any of the settings described above (including the authentication table) you must connect to the device with 'admin' privileges.  You can re-connect to a device using a different username and password by selecting the Device | Change User (Ctrl+U) menu item.  For a previously unconfigured device, you should be able to connect using the default 'admin' username and password.  When entering a username and password, there are options to have IPedit remember the username and password, for future use with the current device.

    If the authentication fails, IPedit is disconnected from the device.  The connection state is shown in the device catalog as an overlay image on the selected device icon.  The overlay consists of a small green checkmark when connected, or a small red 'x' when disconnected.  The current device and connection state are also shown in the status bar at the bottom of the application window, as well as in the device status section of the device configuration form (which also displays the current access rights).  As in AZedit, the status bar also contains Tx and Rx LED icons to show communication status with the selected device.

    It is possible that a connected device could become disconnected if it fails to respond to repeated polls by IPedit (i.e. if the device was reset, or the Ethernet link was lost).  Unlike AZedit (which must re-connect or lose any pending changes), IPedit allows you to continue in the disconnected state and simply re-connect later before sending any pending changes (you must be connected to a device in order to send changes).  While in the disconnected state, your access rights will be the same as when you were last connected to that device (or the default RWTD if you have never been connected to the device).  This means that you must be connected to the device with 'admin' privileges before you can change any of the advanced configuration elements, even when disconnected.

    Managing Passwords

    It is possible to manipulate the remembered usernames and passwords for multiple devices at the same time.  The Manage Passwords dialog can display a list of several OMNEO, RVON and ROAMEO devices, and let you save or clear the remembered username and password for the selected devices simultaneously.  If launched from the Device | Manage Passwords menu item, the dialog displays all devices.  However, if you right click a node in the Catalog tree that contains one or more OMNEO, RVON or ROAMEO devices as children, and choose the Manage Passwords context menu item, the dialog will list all the devices under that node.  For instance, on the All Devices node, you would get a list of all devices, whereas on the RVON-8 node, you would get a list of all RVON-8 devices.

    Using the Device Configuration Form

    When a device is selected from the catalog, information about the device is displayed in the form view (upper right section of the user interface area).  The device information is grouped into separate categories and displayed in a tabbed dialog format:
    In general, configurable items that can be modified have a white background, while those that are status items (or configurable items for which you don't have access rights to modify) are shown with the same background color as the rest of the form.  When a configurable item is modified, it will be displayed with a yellow background.  In edit controls, the background will change to yellow as soon as you start typing, although you can cancel the current changes by pressing ESC.  To accept changes made to an edit control, simply press enter, or move to another control.  Some edit controls involve a validation process to ensure the data entered is valid.  For instance, if you enter an invalid IP address, a message will be displayed and you will be allowed to continue editing to correct the entry.

    When a change has been made to a device, in addition to highlighting the individually changed elements, the device itself is highlighted with a yellow background in both the catalog tree and in the status bar.  

    Device Information

    This sub-section includes the following configurable items for the selected device:
    Note that all of the above (except the description) require 'admin' privileges to modify, and that changing the IP address, netmask, or gateway will cause the device to reboot when the changes are sent.

    The sub-section also includes the following status (non-configurable) items for the selected device:
    Note that Keypanel Status does not apply for channels that do not have an RVON-1 or an RVON-IO in Local Mode at one end of the connection.

    Ethernet Information

    This sub-section includes the following items for the selected device: NOTE that these fields editable only for RVON devices and are read-only status for OMNEO and ROAMEO devices.

    DECT Information (ROAMEO devices only)

    This sub-section includes the following editable items for the selected ROAMEO device:
    Note that Zone and CODEC require 'admin' privileges to modify, and that changing the CODEC will cause the device to reboot when the changes are sent.

    Pass-Through Information

    This sub-section includes the following configurable items for the selected device:
    The sub-section also includes the following status (non-configurable) items for the selected device:
    Note that this sub-section is only shown if the device has Pass-Through capabilities, and that there are two instances of this sub-section for the RVON-16, which has two Pass-Through serial ports.

    The context menu for this sub-section offers the option to clear the pass-through counters.

    GPIO Information

    This sub-section includes the following configurable items for the selected device:
    The sub-section also includes the following status (non-configurable) items for the selected device:
    Note that this sub-section is only shown if the device has GPIO capabilities.

    The context menu for this sub-section offers the option to clear the pass-through counters.

    SNMP Information

    This sub-section includes the following configurable SNMP items for the selected device:
    Note that this sub-section is only shown if the device has SNMP support, and the preference to show this section is enabled.  The preference can be changed by selecting the Edit | Preferences (Alt+Enter) menu item, going to the Devices page, and toggling the "Hide SNMP configuration" checkbox.  If this sub-section is not visible, the SNMP configuration cannot be changed (even via Paste/Paste Special, or via a File Load/Send).

    Authentication Information

    This sub-section includes the authentication table for the selected device, which includes up to five entries, each entry consisting of:
    Usernames and passwords are case sensitive.  The access rights are as described in the "Connecting to a Device" section.

    Note that this sub-section is only shown if the current access rights include the 'admin' privilege, and the preference to show this section is enabled.  The preference can be changed by selecting the Edit | Preferences (Alt+Enter) menu item, going to the Devices page, and toggling the "Hide Authentication table" checkbox.  If this sub-section is not visible, the Authentication Table cannot be changed (even via Paste/Paste Special, or via a File Load/Send).

    Also note that it is possible to create an empty authentication table (effectively disabling IPedit, Telnet, and firmware download for the device).  If this occurs by accident, you can restore the default authentication table (with users 'telex' and 'admin') by turning on a DIP switch on the OMNEO or RVON device, restarting the device, and then (after the device has fully booted-up again) turning the DIP switch off and restarting again.  The DIP switch number can vary by device, please see the user manual for each OMNEO or RVON device for more information.

    For security purposes, it is recommended that you modify the authentication table to change the default usernames and passwords, so that they are not easily accessible by unauthorized personnel on your network.  At the same time, it is recommended that you let IPedit remember the usernames and passwords used to connect to each device, especially if you choose to create different authentication tables for each device.  Having IPedit remember the usernames and passwords allows you to navigate between devices without having to constantly "login" to each device as you go.

    Using the Channel Configuration Grid

    When a device is selected from the catalog, information about the device's channels is displayed in the grid view (lower right section of the user interface area).  The grid is organized such that each row contains a different channel configuration or status element, and that each column (other than the first) represents all the information for one channel.  The first column identifies the channel elements.  The channel information is grouped into five categories and displayed in collapsible sub-sections:
    Each sub-section is identified by a row with a bold white title and  a blue background in the first column of the grid. The sub-sections can be toggled between their normal state, and being collapsed to a single line, by double-clicking the sub-section title, or by right-clicking the sub-section title and selecting the Collapse/Expand context menu item.  Some sub-sections will include other context menu items (described later).  In addition, individual rows and/or columns can be hidden by right-clicking the row or column header and choosing Hide from the context menu.  You can also use the context menu to show any previously hidden rows or columns.

    When the grid has the keyboard focus, you can use the cursor keys or the TAB key to navigate between cells.  The grid will automatically scroll to ensure that the current cell is visible.

    The width of each column can be adjusted by clicking and dragging the column dividers.  Double-clicking the column divider will auto-size the column to fit the displayed information.  Alternatively, the context menu for the column headers will also allow you to autosize one or all columns, or set all columns to the size of the selected column.  The row height for all rows can be adjusted by clicking and dragging a row divider.  Changing a row height affects all rows (except the grid header whose height can be adjusted independently).  Row and column height adjustment can be enabled or disabled on the Channels page of the Edit | Preferences (Alt+Enter) dialog.

    As with the device configuration form, configurable items have white backgrounds, while status items have grey backgrounds, and any changes to channel configuration will be highlighted with yellow backgrounds (as will the device itself in the catalog tree and the status bar).  In addition, some cells may be highlighted with red backgrounds to indicate a configuration problem (eg. the specified device type does not match the actual device type of the specified destination IP address).

    The channel grid contains a number of different types of cells:
    The drop-down and spinner cells look like editable text cells until the cell is selected, at which point the cell's drop-down or spinner buttons will be shown.  The drop-down and spinner cells may also have data-specific shortcut keys for faster selection (these are listed as each configuration item is described below).

    You can change the contents of more than one cell at a time by selecting multiple cells on the same row.  When you edit the focus cell, all other selected cells on the same row will also be modified.  This means, for instance, that you can select the entire destination IP row (by clicking the row title cell) and then type in an IP address that will be assigned to all channels.  This technique also works for rows with drop-down lists, checkboxes, and spinners.

    If you are connected to a device with 'write' or 'admin' privileges, then the context menu for the header row in the grid allows you to Teardown or Clear Statistics/Counters for All Channels (by right-clicking in the left-most corner cell), or for any individual channel (by right-clicking the channel column header).

    Channel Configuration

    This sub-section contains the modifiable channel configuration items: If you are connected to a device with 'write' or 'admin' privileges, then the context menu for the Channel Configuration sub-section allows you to Teardown All Channels  (by right-clicking in the left-most title column), or any individual channel (by right-clicking on a channel column).

    Channel Status

    This sub-section contains (read-only) status information about the channel connection: If you are connected to a device with 'write' or 'admin' privileges, then the context menu for the Channel Status sub-section allows you to Clear Connection Statistics for all channels (by right-clicking in the left-most title column), or for any individual channel (by right-clicking on a channel column).

    Beltpack Configuration

    This sub-section contains modifiable Beltpack configuration items and read-only status items:

    VOIP Status

    This sub-section contains (read-only) VOIP statistics and counters: If you are connected to a device with 'write' or 'admin' privileges, then the context menu for the VOIP Status sub-section allows you to Clear VOIP Statistics for all channels (by right-clicking in the left-most title column), or for any individual channel (by right-clicking on a channel column).

    Network Status

    This sub-section contains (read-only) Network statistics and counters: If you are connected to a device with 'write' or 'admin' privileges, then the context menu for the Network Status sub-section allows you to Clear Network Statistics for all channels (by right-clicking in the left-most title column), or for any individual channel (by right-clicking on a channel column).

    Errors

    This sub-section contains (read-only) Error counters:

    Copy, Paste, and Paste Special

    When you invoke the Edit | Copy (Ctrl+C) command, RVONedit takes a snapshot of the entire configuration of the selected device, so that the entire device is available for the Paste Special command (described later).  The normal Edit | Paste (Ctrl+V) operation will paste only the Channel Configuration items (ignoring the Device Configuration items, like IP address, netmask, and gateway, etc...).  This is based on the assumption that it is much more likely that you will want to copy a device's channel configuration to another device, than to actually copy the IP information.

    The Copy operation can also be affected by which items are selected for copying.  In the Channel Configuration grid, you can highlight individual cells by clicking and dragging, or by holding down the control key while selecting cells.  You can select an entire row or column by clicking on the row or column headers (and holding the control while doing this will add the row or column to your current selection).  If one or more cells in the grid is selected, the Copy operation will take a snapshot of the entire device, but will also record which elements in the grid were selected.   At this point, the normal Paste command will only paste the selected elements, and will paste them starting from the current channel column.  For instance, you could select the destination type, destination IP address, and destination channel for channels 2 and 3, select Copy, then move to the column for channel 5 and select Paste to copy the data from channels 2 and 3 to channels 5 and 6.

    Similarly, you can select the data from any of the Device Configuration sub-sections to copy.  For instance, to perform a device copy and mark only the Pass-Through and GPIO configuration as selected, right-click the Pass-Through and GPIO Information sub-section title, and select Copy from the context menu.  Now you can select another device and choose Paste to copy only the Pass-Through information to the new device.

    The Edit | Paste Special (Alt+V) command allows you to select which configuration items you want to Paste to the current device.  When Paste Special is invoked, a dialog is displayed showing a grid containing to tabbed pages.  One page displays the device configuration items, and the other page displays the channel configuration items.  Upon entering the dialog, only those items that were selected when the Copy was performed are marked for being ready to Paste.  However, if nothing was selected when the Copy was performed, then the dialog will mark the Paste Special defaults.  In either case, you can check or uncheck items on either page to select what will be pasted.  On the Channel page, you can mark items from individual channels using the checkboxes on the right side of the grid in columns for each channel, or you can mark a configuration item for all Channels by using the checkbox on the left side of the grid.

    The Options button on the Paste Special dialog provides some advanced options for marking which items will be pasted.  Pressing the Options button displays a context menu that offers the ability to Select, Clear, or Invert the selection marks for either the Device Configuration items, the Channel Configuration items, or both sets of items.  Other options let you toggle the selections between the Clipboard Copy selections, and the Paste Special Default selections.  The final option on the context menu lets you save the current settings as the Paste Special Default settings.  This allows you to configure the standard Paste Special selections in any way you like and remember those settings between sessions.

    Undo, Redo and Abort Changes

    IPedit supports unlimited undo/redo capabilities (including undoing File Load operations) via the Changes | Undo (Ctrl+Z) and Changes | Redo (Ctrl+Shift+Z) menu items.  The Undo and Redo stacks are reset whenever changes are sent to the device or when changes are aborted.  You can abort all changes made to a device by selecting the Changes | Abort menu item.  When connected to a device, aborting changes will re-upload the current settings from the device.  If you are not connected to a device, aborting changes simply clears the change flag markings (yellow backgrounds disappear), but does not restore any previous data.

    Sending Changes

    When you invoke the Changes | Send (F10) or Send All (Shift+F10) command, or when a Device | Send (F12) command is executed, IPedit displays a dialog showing which devices have changes pending, and which items are marked for being sent to the current device.  The Send Changes dialog looks very similar to the Paste Special dialog (described above), except that the grid only contains items that can be sent (i.e. items that are not marked as changed are not shown in the grid to make it easier to see what will be sent).  On the Channel page, a configuration item is shown if it is changed for any of the Channels, so there may be some cells that do not have a checkbox in them.  This implies that the data for that channel has not been marked as changed and cannot be selected to be sent.

    If you invoke the dialog with Send (F10), only the current device is selected for sending, however if you invoke the dialog using Send All (Shift+F10), then all devices with pending changes are pre-selected.  In either case, you can manually select or un-select any of the devices with pending changes.  When you highlight a device from the list, the grid to the right shows what changes are pending for that device.  The dialog is a confirmation of which devices will have their changes sent, and which items will be sent to each device, and it allows you to un-select items that you do not want to send (but it will not let you mark items for sending that have not been changed).  This is useful, for instance, after doing a Device | Load where you might want to prevent the overlaid Device Configuration items from being sent.

    Pressing the "Send" button causes the marked changes to be sent to the selected device(s).  You must be connected with sufficient access rights ('write' and/or 'admin') for the data being sent (which should always be the case, because IPedit should not allow you to change items for which you do not have edit privileges).  If the send was successful, the dialog will automatically close, otherwise, an error message will be displayed.

    Downloading Firmware

    To download firmware to a device, select the device from the catalog and use the RVON | Download Firmware (Ctrl+Shift+D) menu item, or right-click any device and choose Download Firmware from the device context menu.  The Download Firmware dialog displays a list of all devices of the selected type, and highlights the device used to launch the dialog.  You can select more devices by holding down the CTRL key while clicking on them in the list, or you can choose to download devices of a different type by selecting a new type from the list of available types.  

    You must also select the firmware file to download.  You can enter the file path and name directly, select from a list of previously used files, or press the folder browse button to select a file.   By default, IPedit looks in the "FIRMWARE" directory below the application directory for firmware files.  This directory can be changed by accessing the Directories page of the Edit | Preferences (Alt+Enter) dialog.  IPedit creates sub-directories below the firmware directory for each device type, and looks in the appropriate directory for the selected device type, although you can navigate to any directory and choose any firmware file.  Note that IPedit validates the firmware files to ensure that they are RVON images, but does not check that the firmware file is appropriate for the selected device type.

    Once one or more devices are selected, and a firmware file has been chosen, the "Begin" button will become enabled, press this button to start the download process.  The firmware file will then be loaded and validated, and IPedit will begin sending the file to the first of the selected devices (the load and send progress is shown for each device selected in the list).  IPedit will download each selected device in turn, and can "Auto-close <the dialog> after successful completion" by checking the option at the bottom of the dialog.

    In order to download firmware to an RVON device, you must be connected as a user with the 'download' privilege.  If it is necessary to re-authenticate to be granted this access right, you may need to enter a username and password to be used for downloading firmware for this device (the dialog will appear automatically if you begin a download with insufficient access rights).

    IPedit can download firmware to any RVON device supporting the older "rvonfile.exe" utility, even those which do not yet support communicating device configuration and status to IPedit.  IPedit does not support download of the ADAM2 boot code, or any of the flash file system utility programs.  To download these, when necessary, you should continue to use "rvonfile".

    Saving a File

    IPedit supports saving the settings for a device to file.  By default, IPedit stores setup files in a directory called "SETUPS" located under the IPedit directory.  This directory may be changed by accessing the Edit | Preferences menu item and selecting the Directories page.  Regardless of where the setup files are stored, IPedit will always suggest storing setup files for each device in a separate sub-directory named using the device's IP address.  This allows you to keep the setup files for each device separated from those of other devices.  When you choose to save a setup file by selecting Device | Save (Ctrl+S), IPedit prompts you to save in the proposed sub-directory, however, you can always change this directory from within the File Save dialog.

    When saving a setup file, IPedit does not include those configuration items for which a device is not capable (eg. SNMP, Pass-Through, and GPIO information), and it will not save the SNMP configuration or Authentication Table unless the current user has been granted 'admin' rights, and the preferences to hide these sections are not enabled.  Setup files are stored in XML format, and so are viewable and modifiable with standard text editors and are even viewable with a web-browser.  The Authentication Table, if saved, is stored in an encrypted format, so it cannot be meaningfully edited by a text editor.

    Loading and Sending a File

    When you select Device | Load (Ctrl+L), IPedit will prompt you to select a setup file to open.  If a catalog device is currently selected, IPedit will default to showing you the files in the sub-directory named for the current device's IP address, however, you can use the File Open dialog to navigate to a different directory to select a file for a different device.  After a file is selected, IPedit will read the file and overlay the settings stored in the file on the currently selected device (marking the items as changed).

    After loading a setup file, you can view and modify the configuration for the current device, and then save the changes to the original file, or save the entire setup with a different file name.  To send an entire file, you should use the Device Send command.

    As with saving a file, IPedit will not read the SNMP Configuration or Authentication Table from file unless the current user has 'admin' rights, and the preference to hide these sections are not enabled.
    Load file can be used when you want to preview and/or modify the items in a file before sending them to a device (typically when you load a setup file saved for the same device as the current device).

    Load file can also be used when you want to import the setup file for one device into another device (when the current device has a different IP address than that in the setup file).

    Note that partial loads and partial saves are not supported, so that all information in a setup file that can be loaded, will be loaded.  So, for instance, if the current user has 'admin' rights, then loading a file will modify the IP address, net mask, gateway, and Ethernet interface configuration settings for the current device.  It will also load the SNMP and Authentication information if these sections are not hidden.  You can prevent these modified items from being sent by making sure to de-select them when previewing the changes to be sent during a Send Changes operation.

    To send a setup file, use the Device | Send (F12) menu item.  Sending a file is simply a combination of a Device | Load followed immediately by a Changes | Send Changes (F10) operation.  The setup file is loaded as described above, and then the Send Changes process is invoked.  Note that the Send Changes process allows you to preview the items to be sent (and modify which items will be sent if desired).

    <back to top>

    Installing IPedit

    To install IPedit, insert the installation CD into an optical disk drive. If installation does not start automatically, execute the SETUP.EXE file on the CD. Follow the on screen instructions. The default directory for installation is:

    C:\TELEX\RVONEDIT\V363

    but you may change this if desired. The installation program creates the desired directory if necessary.  The IPEDIT.EXE application file, and the release notes (this file) are copied to this directory.

    The installation program also creates a shortcut to IPedit.EXE on the Programs sub-menu of the Start menu on the Taskbar. The shortcut is labelled:

    IPedit V3.6.3

    The location of this shortcut, and its name, are not customizable during the installation process. You may move, rename, or delete this shortcut afterwards; however, if you move or rename it, it will NOT be deleted as part of the uninstall process.

    At the end of the installation process, you are presented with a dialog that allows you to view this file, and to launch the application when complete.

    To view this file at a later time, you can choose the Release Notes menu item from the Help menu within the application.

    <back to top>

    Running IPedit

    To run IPedit after installation, simply select the shortcut from the Start | Programs menu.

    IPedit will create a set of registry entries located at:

    HKEY_CURRENT_USER\Software\Telex\RVONedit

    The key remains the same as in older versions for backwards compatibility.  For the most part, you will not need to edit the settings stored here directly as almost all of them are set automatically by the program or are modifiable through the Edit | Preferences dialog in the application.

    These registry settings are NOT removed during the uninstall process.

    <back to top>

    Uninstalling IPedit

    To uninstall IPedit, use the Add/Remove Programs applet from the Control Panel. Select the IPedit application from the list of available applications and press the Remove button.

    The uninstall process will delete the IPEDIT.EXE program file, the Release Notes file, and the Start Menu shortcut. It will not delete the registry entries used to customize the application.

    To fully remove IPedit, you may have to manually delete the installation directory (which defaults to C:\TELEX\RVONEDIT\V363), and all of the files and directories beneath it. You may also decide to manually delete all of the registry settings under HKEY_CURRENT_USER\Software\Telex\RVONedit, although these settings may also be used by other installed versions of IPedit.

    <back to top>