User Tools

Site Tools



This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
device_setup [2018/06/25 09:21]
admin [Device Editor]
device_setup [2018/10/29 14:06] (current)
admin [Creating a Channel]
Line 1: Line 1:
 ====== Device Setup ====== ====== Device Setup ======
-To configure the devices select //Configure - Devices// in main menu (or //Device// shortcut in the toolbar ) . The Device Setup window opens as shown below. The right table lists all devices currently available in the project. The left table list device templates, whose search criteria matches one of the fields Category, Type or Manufacturer.+To configure the devices select //Configure - Devices// in main menu (or //Device// shortcut in the toolbar ) . The Device Setup window opens as shown below. ​
-{{:devicesetup.png|}} ​+{{ ::​configure_devices.png |}}
-If the desired driver appears ​in the left list, double click or //Add Device// adds the device to the right list (project devices). //Save Devices// saves the right list and make the devices available.+The dialog offers two possibilities to select device drivers from the database. First is to select a category and search for a device ​in a category ​list:
-Before the device is usable, it is necessary to assign at a Channel. To do that, follow the instructions in the screenshot below.+{{ ::​device_categories.png |}}
-{{:​devicesetup_hb_en.png|}} +The second possibility is to use the search field next to the category ​list. Here you can simply enter a search term such as the device ​name or manufacturer.
-  - Select ​the device in main windows device list +
-  - press the setup tab (right from commands tab) +
-  - in the //Available Channels// ​list select ​the channel to assign to the selected ​device +
-  - press the //Add// button+
-====== Device Editor ======+{{ :​device_search.png |}}
-It is possible to customize (if needed) ​the device drivers for a projectA complete description how to create and  edit device ​drivers is found in the [[device_editor|Device Editor]] chapter. In most cases it should ​be sufficient ​to change ​the device name. To do that, follow ​the instructions below.+The list below shows all devices matching ​the search termAs soon as the searched ​device ​appears ​in the list, it can be added to the project via the //Add Device// button.
-The Device Editor is launched via //Device Edit// symbol in the toolbar or main menu //Configure -> Edit Devices...//+{{ ::​device_added.png |}}
-{{:​edit_device_en.png|}}+If you select a device in the search result list or in the project device list (the one on the botom left), additional information about the device driver is shown at the bottom textfield.
-To change a device ​name enter / edit the name in the //​Name// ​textfieldThe device ​is selected ​in the Drop Down Box //Device:////Update Device// saves the new name in the current project.+===== Renaming Devices ===== 
 +To change ​the name of a device ​select it in the project device list and click the //Change ​Name// ​buttonAlternatively,​ a double click on the device in the list is sufficientThis opens another dialog in which a new name can be entered.
-The device ​Editor knows two modes. If launched via //Configure -> Edit Devices// or the //Device Edit// toolbar icon, all changes made in any driver stored in the project (*.vc4 file). The original driver template stay untouchedIf launched via //Configure -> Edit Device ​Templates//the template is edited, and the project devices stay untouched. This is important ​to keep in mind if editing device drivers.+===== Deleting Devices ===== 
 +To delete a device ​select it in the project device list and click the //Delete Device// button 
 +===== Creating a Channel ===== 
 +To control a device, there must be an interface that is used to send and receive commands to / from the device. In V-Control these interfaces are Channels. A Channel is an RS232 interface, a TCP or UDP connection or any other interface installed on the computer that can "​talk"​ with V-Control. 
 +In this example we need a TCP channel to interact with an Ascender. If we scroll down in the device help textfield we find some information about the parameters we have to use for the TCP channel. 
 +{{ ::​device_help.png |}} 
 +The information says that the default IP Address of an Ascender is,​ and the default port is 10600. Make sure that the device is using the default values or change them here if other values used. Also take care that your network configuration does not conflict with the network settings of the connected devices. 
 +In this example we use the default values. So we need a TCP channel that connects to port 10600 at IP Address 
 +{{ ::​add_channel.png |}} 
 +It is important that every channel has a unique name. In the //Channel Name// textfield enter a name for the channelIn the tab bar select the //TCP Client// tabNow enter the values for //Port// and //IP Address// and click the //Add Channel// button. 
 +The final step is to assign the channel to a deviceSelect the device in the project devices list at the bottom left of the dialog and select the channel in the channel list. Then click the //Assign Channel to selected ​Device// ​button. 
 +===== Channel Types ===== 
 +All available channel types are organized in a tab panel. 
 +==== Serial Channel ==== 
 +Serial channels are used for RS232/422 and 485 interfaces. Get Serial List loads all previously scanned ports in the Port: list. If new serial ports attached to the systemRefresh executes a new port scan. On systems with many serial interfaces this could take a while. 
 +{{ :​channelrs232.png |}} 
 +==== TCP Channel ==== 
 +To control devices via TCP, the Port and IP Address is needed 
 +{{ :​channeltcp.png |}} 
 +==== UDP Channel ==== 
 +Router Hops determine how many routers ​the UDP packet is allowed to pass. 
 +{{ :​channeludp.png |}}  
 +==== SMTP Channel ==== 
 +The SMTP channel specify'​s a mail server. This channel ​is used by the SMTPMailClient device ​to send emails. 
 +{{ :​channelsmtp.png |}} 
 +Server: The mail server (e.g. 
 +From Adr.: The sender address ( 
 +Username: Username to log in 
 +Password: Mail server password 
 +==== Http and Https Channel ==== 
 +{{ :​channelshttp.png |}} 
 +HTTP and HTTPS channels can automatically log in if username and password is saved in the channel propertiesThey both can do http Get and Post request
device_setup.1529918493.txt.gz · Last modified: 2018/06/25 09:21 by admin