IPedit V3.2.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, and Windows 7.  

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:

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

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

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

***NOTE: OKP includes the OKP-2 and OKP-8 KP-Series (KP-5032 and KP-4016) keypanels (depending on how many channels are licensed).

IPedit can download firmware to older versions but requires the versions above in order to be able to automatically detect the devices and to view and modify the device configuration.

<back to top>

What's new in this release?

Version 3.2.3

Various improvements and bug fixes:

  • New: Now 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 and RVON 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.  IPedit is to OMNEO and RVON devices what AZedit is to ADAM, Zeus, and Cronus intercoms.

    IPedit refers to OMNEO and RVON products generically as devices (because there are several different types of OMNEO and RVON 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 and RVON devices to a catalog that is automatically maintained between IPedit sessions.  The catalog shows the OMNEO and RVON 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 and RVON 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 and RVON 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 and RVON 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 and RVON 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.

    Connected and disconnected states are much like the ONLINE and FILE modes of AZedit.  You can manually disconnect from a device (the equivalent of entering FILE mode) by selecting the Device | Disconnect (Ctrl+D)  menu item.  Similarly, you can attempt to re-connect to a device (the equivalent of Going ONLINE) by selecting the Device | Connect (Ctrl+G)  menu item.

    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 and RVON 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 or RVON 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 four categories and displayed in collapsible sub-sections:
    Each sub-section is surrounded by a group box with a button in the top-right corner.  The sub-sections can be toggled between their normal state, and being collapsed to a single line, by pressing the button.  You can also collapse/expand a sub-section by double-clicking the group title, or by right-clicking the group title and selecting the Collapse/Expand context menu item.  Some sub-sections will include other context menu items (described later).

    When the device form has the keyboard focus, you can TAB or Shift+TAB forward and back between active controls, including moving between sub-sections.  The form will automatically scroll to ensure that the control with keyboard focus is visible.

    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.

    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 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 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 dAlso 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. ntext 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 desitnation 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).

    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 File | 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 File | 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 File | 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.

    Opening a File

    When you select File | Open (Ctrl+O), 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 disconnect from the current device (if connected) and read the file.  If the file is for a device other than the current device, IPedit will switch to the new device in the catalog.  If the file is for a device that is not in the current catalog, IPedit will add the device to the catalog and then switch to it.

    After opening a setup file, you can view and modify the configuration for the specified device, and then save the changes to the original file, or save the entire setup with a different file name.  You can also attempt to connect to the current device and send the changes to the device.  Note that only those items that were changed after opening the file would be sent.  To send an entire file, you should use the File Load or File Send commands.

    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.

    Loading and Sending a File

    To load a setup file, use the File | Load (Ctrl+L) menu item.  Loading a setup file is similar to opening a setup file, except for the following differences:
    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 File | Send (F12) menu item.  Sending a file is simply a combination of a File | 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\IPEDIT\V323

    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.2.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\V323), 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>