A100K10282 - AlphaVision User Manual v0310
Contents
1. AA 41 TL VB 42 AlphaVision User Manual A100K10282 8 10 Introduction I Introduction 1 1 Short Product Introduction AlphaVision is a PC based system management package for the AlphaCom exchange This software gives access to all of the features inside the AlphaCom exchange It is primarily intended for use in a control room environment 1 2 Software Versions The features for AlphaVision described in this manual require e AMC software 08 20 or later AlphaPro programming tool 08 01 or later 1 3 About This Manual This manual describes the features installation programming and use of the system management software AlphaVision 1 3 1 Reader Group The manual has been written for the following reader groups e Users of AlphaVision e Sales and marketing people in the Zenitel organisation and at distributors e Installation personnel in the Zenitel organisation and at distributors e Technicians in the Zenitel organisation and at distributors The feature description installation instructions and technical description of the manual assume that the reader 15 familiar with the functionality and system units of the AlphaCom system 1 3 2 Related documentation AlphaCom User Guide A100K10000 AlphaCom System Description A100K10001 AlphaCom Installation amp Commissioning A100K10002 AlphaCom AlphaPro User Guide A100K10005 AlphaCom AlphaNet Data Protocol A100K12. The command parameter is the string which will be written to the log file on the harddisk DELAY The command parameter is the delay before the next command in the script 15 executed The delay is in steps of 100ms STE SendToExchange Command parameter is any legal AlphaCom simple link layer command string EXEC Execute an external application Command parameters Path ApplicationName Application parameters these can be any of the script parameters which are passed to the script itself AlphaVision User Manual A100K10282 8 10 25 Programming AlphaVision STE EXEC e SHOWMAP The command parameter 15 the name of the map that must be displayed in the map area Indicates a remark Everything following this sign on the same line is ignored by the script interpreter Inside a script it 1s possible to use a number of script parameters These parameters are AlphaCom related DIRI Directory number of the to the AlphaVision position related intercom unit e DIR2 Directory number related to a call in point or A subscriber in data protocol messages e DIR3 Related to directory number in event handler or B subscriber in data protocol messages MN Message number data message id 0 7 01 0x7c02 0x7c06 0x7c10 Ox7c2f TAG TAG number Mail Tag or Connection Reference PRIO Call request priority as defined in the AlphaCom exchange SO SO number PSI
3. Button 4 Conference E Busy Menu command E 2 Connected EN Cancel 8 Delete Command praperties L aplian Information Script File Info ser p nDblClick Cancel Show Files Scripts can be grouped into scriptsets In order to define scriptsets the script files must be available first To define a scriptset select ConfigurationlScript Sets In the available dialog it is possible to Add Edit and Delete scriptsets Give a meaningful name to the scriptset AlphaVision User Manual A100K10282 8 10 23 Programming AlphaVision Scripts can be assigned to the 4 buttons related to the received call requests and established calls This is only relevant for scriptsets which will be assigned to intercom devices Click the relevant button enter a caption for the button and assign a script click the button Scripts can be assigned to the icons They can be dependent on the status of the device click 0 1 2 3 or 4 or independent click A script which is dependent on the status of the device is only available when the device 15 in that status After selecting the status dependency click on Menu command and enter the caption and file If the checkbox DbIClick is enabled the script can be activated by double clicking on the icon The script is always available by right clicking the icon and selecting the required script from the drop
4. SI s and SO s are defined in AlphaVision This procedure assigns icons to such items in the sub system list gives the facility to assign scripts and to put the icon into a map When a call request or a SI status change message is received the relevant icon changes colour Information about call in points and SI s SO s which are not defined in AlphaVision is still received by AlphaVision AlphaVision will display call requests in the call request list The defined default behaviour is applicable to such call requests and the resulting conversation AlphaVision will add such unknown devices in the sub system list with a default icon and name AlphaVision User Manual A100K10282 8 10 Installation 3 Installation AlphaVision is a software package which runs on a PC The required operating system is Windows 98 2000 or higher from Microsoft 3 1 Hardware 3 1 1 Single PC A single PC can be directly connected to the serial ports of the exchange For this the AlphaCom E exchange has 2 serial ports available The PC can also be connected to the AlphaCom E exchange via a LAN network 3 1 2 Multiple PC s LAN Only one of the PC s the one running the AlphaVision communication module AVCM needs to be connected to the exchange The connection is as described in paragraph 3 1 1 All other PC s must be connected to the same LAN as the one running AVCM The LAN must support the TCP IP protocol Maps and scripts can also be shared a
5. AlphaVision has the possibility to filter these broadcast messages out In order to make AlphaVision behave correctly these messages need to be generated via the event handler The difference is that when the AlphaCom generates these messages automatically they are sent to a broadcast address Oxff When they are generated from the event handler they need to be sent to the actual AVCM device address As the messages must be sent for each intercom the event owner in the following examples will be Stations with UDP 8 As a default UDP 8 is set for all intercom stations In this case it needs to be removed from the physical numbers which are used for the AlphaNet audio connections In each relevant exchange in the AlphaNet 4 events must be programmed In the following action strings 90140 stands for the node and device number of the receiving AVCM module The first event is to generate the ST BUSY BC message Gwener Type Stations w UDP Id 8 All Stations Evert Type 104 Station in use Sub typef 0 Details wnen change Tr Action Command ar ROO The second event is the ST FREE BC message AlphaVision User Manual A100K10282 8 10 Programming the AlohaCom Owner Type Stations w UDP ld Sent Statonnuse E Sub type is When Change when Related To Jal Action Command ar OSS im m The third event is the CONN STATUS BC message Owner
6. Button 3 caption Open Door disabled default script STE NN SER U2 UO Ul Ul L NN DIR2 U3 L DIR 1 DELAY 35 STE NN SER U2 UO UO Ul L ZNN DIR2 U3 L DIR 1 e Button 4 caption Cancel enabled default script STE CL DIRI1 AlphaVision User Manual A100K10282 8 10 22 Programming Alpha Vision Start script caption irrelevant disabled no default script 4 8 2 Scripts and scriptsets The 5 scripts which are defined in the Options dialog are stored in the registry All other scripts are by default stored in the directory as defined under Default script directory However it is possible to store scripts in other directories Scripts are stored as ASCII text files with the file extension SCR To write modify scripts a standard ASCII text editor such as Notepad can be used Scripts are related to devices or to from the exchange received data messages Scripts related to devices must be part of a scriptset SI and SO type devices must be assigned a scriptset to be able to perform an action Intercom devices which are not assigned a scriptset will have the default behaviour as defined in the Options dialog 4 8 3 Scriptsets status Script MH ame Standard intercom EE Call Request Status names by type B Intercom Station Add comman S 8 Accept uM E Cancel Button 1 8 Button 2 E B Idle E Connect Button 3
7. ND RETIA 18 Devices nd 19 dl MDA 19 ER AE RE EE tant to EE e E N 20 2 DE vere 20 LG ELSE NE 21 201 Default SCript etd 22 282 Sps dnd SCETDISOLS Haee adressa 23 205 Skaare 23 aou TI 24 Mosis Rm UU ete 25 4 08 6 Parameter relationships uoc ao ot epe eee aves de a SEU EHE exi a USE GA 26 AlphaVision User Manual A100K10282 8 10 Contents 5 1 3 2 3 3 5 4 305 5 6 6 1 6 2 6 3 6 7 Tel 7 2 1 3 Programming the AlphaConm esesssssssssessessssssssnnnnnnnnnnnsssseesesssssssnnnnnnnnnnnnenenssssssssssssnsee 29 NTN 29 MN NR 29 Ree 32 SAT NTN 33 Fre ooi N EL tid 33 PESTEN eee 33 MOG He DUNO EE EE 35 VE SEEREN EEE EE EN 35 Olt tom Maar 35 1025 OO OO TU 35 0 1 5 Lanes 35 614 Changing of password eda 36 Korea 36 OI NNN 36 NNN Sn 36 GE RR Ru e me a Apos nu 24 DO MIMIC AOI EN Ne D d IDE 37 0 92 OT ODHODS iu ese cal tack shasta _______ sala 37 38 ET 38 SPS 38 rod 38 eno MES Eco ONE 38 0 0 9 General DIL DOSE 39 39 External appliCations 41 LEunctionallby RA 4 Fi 41 Data COMMUNICA OM
8. SI number NN Node number oC HG State change 1 for 0 for off coded as UINTI SCR The name of the script file DIRI is fixed for the AlphaVision position Script commands are performed asynchronously This means that for instance a script will start an external application but immediately continue with the rest of the script commands or return to the main AlphaVision application AlphaVision will not wait for an external application to terminate AlphaVision will only run one script at the time Care must be taken not to use the command DELAY too much and with long delay times The command STE sends a simple link layer message to the exchange Everything following the STE command is sent to the exchange where script parameters are first replaced by the appropriate values The message e STE C L DIRI is the default behaviour for the cancel button DIR1 is the directory number of the operator intercom associated with AlphaVision If this is for instance directory number 101 the command actually sent into the exchange is C L101 The command EXEC will start an external application For instance e EXEC c d2 Appl exe DIR 1 will start Appl exe in c d2 and use one command line parameter which in this case is whatever the value of DIR1 happens to be More details about external applications are given in section 7 4 8 6 Parameter relationships 26 The availability of the script parameters depends on what trigge
9. SO s SI s and SO s can be numbered from 1 9999 SI s and SO s are not limited to the physical number of RCI s and RCO s in an exchange They can be used as more general status items Devices can be given specific appearances Select a defined icon set Devices that should behave in a similar manner can be assigned the same scriptset Select one of the defined script sets If an intercom device is not assigned a scriptset it will use the default behaviour as defined in the options dialog When a scriptset is assigned to the operator intercom the scripts will be available from the Script menu item Select the map where the icon should be placed This 15 not required either because the icon should not appear in a map or because the icon will be placed using drag and drop from the sub system list The label can be chosen differently from the name In general the label will be shorter to prevent too much clutter in the map area The label is used on the map and the sub system list The place of the label in the map can be in different locations related to the icon Select the required location Position X and Position Y are the co ordinates of the icon in the selected map A drag and drop action on the device enters these values automatically It is possible to fine tune the location of the device by entering these co ordinates Finally Save the choices by clicking OK 4 8 Scripts AlphaVision has some default func
10. Stations w UDP ld All Stations Evert Type 09 Conversation Outgoing M Sub type 0 Change T when Related To lan Aul o Action Command or RCO The full action string is 20140 CONN STATUS BC W clkyear U clkmon U clkday U clkhour U clkmin U clksec W 0P OP 1 NOD 552 1 PHY 1 REF 2 REF The fourth event is the DISCON_STATUS_BC message Owner Type Stations w UDP ld All Stations Event Tyne Sub type When Change When Related To a To Action Command or REO gt O 40140 SDISCON STATUS BC Weclkyear Utclkmon 2 Usclkday U clkhour Usclknin Usclksec WSOP S0P 51 N0D 552 41 PHY J The full action string is AlphaVision User Manual A100K10282 8 10 31 Programming the AlohaCom 20140 DISCON STATUS BC W clkyear U clkmon U clkday U clkhour U clkmin U clksec W9 6OP 96OP 961 NOD 552 201 PHY 53 RCI 32 The exchange provides a facility of re routing data messages that it receives which are intended for another device than itself It is also possible that the exchange generates such a message itself from the event handler and then routes it Such an action is programmed in the event handler in simple link layer format Another facility is that the exchange treats messages with a message ID in the range 0 7000 0 7 in a special way This kind of message has no meaning to the exchange and is not defined to have any sp
11. Supervisor e Manager e Operator All programming described in this section can only be done by a user with Supervisor level When a user logs in on a lower level these options are not available AlphaVision consists of the software av exe which is the AlphaVision main application and avcm exe This last application is the AlphaVision Communication Module It takes care of the data communication between the AlphaCom exchange and AlphaVision Avcm exe can also be used by other applications to communicate with the exchange It provides the facility that multiple software packages can communicate with the exchange through the same serial port 4 1 Default settings In principal it is possible to use AlphaVision without any programming other than the communications settings in AlphaPro as a default AlphaVision is device 64 40 in hex AII default settings of AlphaVision will be used and the functionality 1s limited to accepting incoming call requests and cancelling the resulting conversations Without any programming only one AlphaVision can be used to control an exchange because other PC s running AlphaVision would all have the same setting AlphaVision has the ability to program itself from information it receives from the exchange When it receives information about an intercom unit it does not know about yet it assigns a default name and default behaviour to that unit This capability can be used for a quick start by dia
12. configuration there is only one shared AVCM for all PC s running AlphaVision AlphaVision needs to know the network address of the PC which is running AVCM Address 127 0 0 1 is the default address for same computer Enable Local Run if AVCM is running on the same PC as AlphaVision and the requirement is that AlphaVision starts and stops AVCM when AlphaVision itself is started and stopped AVCM can also be started independently from AlphaVision AVCM can communicate with many applications and provide a communication channel with the AlphaCom for these applications AlphaVision is just one of those applications In order for AVCM to be able to communicate with an application an application needs to register itself with AVCM with a Registration Name Each registration name needs to be unique The default registration name for AlphaVision is but in a LAN configuration only one copy of AlphaVision can use this registration name while others need to be given another registration name There are a number of timers for the communication between AlphaVision AVCM and AVCM AlphaCom exchange AlphaVision User Manual A100K10282 8 10 14 Programming Alpha Vision Mode Open Both AVCM and AlphaVision must open their respective libraries to be able to operate and communicate with each other and the exchange How long it takes before these packages are ready depends on the speed of the PC on which they are running With th
13. down list Scripts can be moved in the drop down list by using the Up and Down arrows A script file can be used in more than one scriptset 4 8 4 Data messages AlphaVision reacts on data messages it receives from the AlphaCom exchange Some of these messages are defined in the AlphaCom protocol document others are generated via the event handler These are the messages with id s 7 01 0x7c02 0x7c06 and Ox7c10 0x7c2f A received data message can start a script The script assignment to data messages 15 done in the same dialog box which 15 used to set the filtering for logging In the main menu select Configuration Message Filters A dialog box will become visible listing all data messages which are defined to trigger one of the following actions e Show in the on screen history list e Log to the hard disk log e Start a script By clicking Items it is possible to add or edit definitions Delete will remove a definition from the list It is possible to filter on data messages related to a specific intercom SI or SO and unrelated to such devices If both are used the programming for a related device takes precedence It is not the case that both are performed on the same incoming data message The dialog in which the above information is entered is depicted below In Message select the data protocol message on which should be filtered If the message filtering must be related to a certain device u
14. number of different ways As described above in this paragraph as part of the default behaviour of AlphaVision e Onreceipt of certain data messages from the AlphaCom exchange e By assigning scripts to menus These menu items are as a default invisible They are not labelled From within AlphaVision it 1s possible to label such a menu item and assign a script file to them Once the menu item has a label it will become visible Scripts can start external applications AlphaVision provides a facility for such external applications to communicate with the AlphaCom exchange AlphaVision User Manual A100K10282 8 10 System description 2 4 Miscellaneous 2 4 1 Multiple users It is possible to define a number of different users each with their own user name and password It is possible to assign to each defined user the facilities to which that user has access A system manager will have access to all facilities which AlphaVision offers an operational user will only have access to the operational facilities There are three different user levels It is possible to change users the This means that in order to change from one user to the other it is not necessary to stop AlphaVision and restart again 2 4 2 AlphaVision start When AlphaVision starts it checks whether there are any entries in the for AlphaVision important mail queues inside the AlphaCom exchange 2 4 3 Unknown devices 10 Normally call in points
15. the operator 6 6 1 Call in point Click with the right button on a call in point icon If scripts are defined for the call in point they will appear as a pop up menu Select the required script and click on it using the left mouse button Scripts might be defined to be activated via a double click on the icon 6 6 2 SI and SO Scripts related to SI s and SO s can be started in two different ways e Froma received data command from the exchange This is outside operator s control Right clicking on the SI SO icon If scripts are defined for the SI or SO they will appear as a pop up menu Select the required script and click on it using AlphaVision User Manual A100K10282 8 10 38 Operation the left mouse button Scripts might be defined to be activated via a double click on the icon 6 6 3 General purpose If general purpose scripts are defined they are available from the main application menu Select the required script form the menu item Scripts and click on it using the left mouse button Run Command A user with supervisor level can sent messages to the exchange from the ScriptsiIRun command menu item This will show a dialog in which a command can be entered When the button is pressed the command is executed This 1s intended mainly to facilitate testing of certain functions 6 7 Maps In the main menu it 15 possible to select the map which should be displayed By right clicking anywhe
16. to use AVCM it needs to register itself Then the application can get and send messages When an application registers itself it should immediately read the current buffer pointer value for the buffer where AVCM is storing messages from the AlphaCom After that it must regularly poll the value of this pointer and check whether new data has arrived Before the application terminates it needs to unregister itself If terminateCM is passed with value 1 AVCM will terminate if no other clients registered If terminateCM is passed with value 0 AVCM will not terminate Data to be send to the AlphaCom exchange can be passed as an ASCII string Data read from the exchange is in binary format although it is passed as an ASCII string This means that for each character the function ASC must be used to find its value Good knowledge of the AlphaCom data protocols is required to be able to use these functions The IP address is passed in Unix format The relation between a standard IP address and the Unix format is as follows IP address a b c d gt 256 256 256 d 256 256 c 256 b a The same computer 127 0 0 1 16777343 Some declarations Private Declare Function SetRemoteModuleAddr Lib _ path avemlib dll ByVal remote addr As Long ByVal remote port As Long _ As Integer Private Declare Function Unregister Lib _ path avemlib dll ByVal terminateCM As Integer As Integer Private Declare Function RegisterInAVCM Lib _
17. 0200 AlphaCom E System Management A100K10338 Table 1 Related Documentation 1 4 Liability STENTOFON IS A BRAND NAME OWNED BY ZENITEL NORWAY AS NORWAY IN THE INTEREST OF PRODUCT IMPROVEMENT ZENITEL RESERVES THE RIGHT TO ALTER SPECIFICATIONS AND DESIGN WITHOUT NOTICE AlphaVision User Manual A100K10282 8 10 Introduction ZENITEL NORWAY AS AND ITS SUBSIDIARIES ASSUME NO RESPONSIBILITY FOR ANY ERRORS THAT MAY APPEAR IN ITS DOCUMENTATION OR DAMAGES ARISING FROM THE INFORMATION IN IT NO INFORMATION IN THIS PUBLICATION SHOULD BE REGARDED AS A WARRANTY MADE BY ZENITEL THIS PUBLICATION MAY BE UPDATED WITHOUT NOTICE PRODUCT NAMES MENTIONED IN THIS PUBLICATION MAY BE TRADEMARKS THEY ARE USED ONLY FOR IDENTIFICATION AlphaVision User Manual A100K10282 8 10 System description 2 System description AlphaVision is a PC based system management package for the AlphaCom exchange 2 1 Configurations AlphaVision can be used stand alone as well as in a LAN configuration In stand alone mode AlphaVision communicates directly with the AlphaCom exchange In this mode it 1s possible to have multiple PC s running AlphaVision where each PC 1s connected to the exchange Each PC 1s assigned a device number The range of valid device numbers is between 1 and 64 It is also possible to have only one PC connected to the exchange All other PC s running AlphaVision share the communications module which is running on the to the exchange conn
18. 1 and Ul in the On action Ul W1 and UO in the Off action are related to the script parameters as follows NN Node number SI SI logical number RCI in the AlphaCom SI in AlphaVision CHG 1 for on 0 for off AlphaVision User Manual A100K10282 8 10 Programming the AlohaCom 5 4 Status information The data messages 7 01 and 7C02 can also be used to transmit general purpose status information to AlphaVision The status byte can be given the values 0 I 2 3 or 4 Each value relates to a different icon appearance The logical number can be in the range 1 9999 Data message 7 01 is related to SP s in AlphaVision 7C02 is related to SO s There is no difference in SI and SO behaviour 5 5 Error reporting Via the event handler the AlphaCom can report line errors for individual intercoms by generating a data message with message ID 7C06 AlphaVision can use this data message to change the with the intercom associated icon s appearance The format of the string to be defined in the event handler is e nhFF M7C06 1 REF U 3 CHG 1 0 nh node number of the exchange to which the AlphaVision PC is connected in hexadecimal format Ger pe sons voe E as All Stations Evert Type 13 Faulty station line Sub type Details When Change To ON or OFF when Related To la Action Command or RCO M7C 6 1 0 35 CHG 1 0 BR o Lo Arco 5 6 Special data messages A
19. 100K10282 8 10 36 Operation e Active or The above are the default icons for Idle and Active transmitted from the exchange with status byte value 0 and I It is possible to use the SI type and SO type devices as general purpose status indicators Five statuses can be shown through 5 icon appearances The status byte value can be 0 1 2 3 or 4 6 3 Call request Associated with AlphaVision 1s the operator s intercom A call in point can make a call request to the operator 6 3 1 Indication e The icons on the map and in the sub system list related to the call in point turn blue e The call in point is put in the call request list Its position depends on call request priority and date time of entering the list e When there is an entry in the call request list the Accept button is enabled If the call in point is unknown to AlphaVision it is not listed in the sub system list AlphaVision can automatically add it to the sub system list It is of course possible that the icon associated with the incoming call request 1s not on the map which is currently displayed In that case it 1s possible to right click on the call request list entry This will show the correct map 6 3 2 Operator options Accept The operator has the following option assuming default behaviour e Accept the call request The operator can accept the call request in the following ways e Select the call in point in the call request li
20. MsgNumber MsgText If errNumber 0 Then MsgBox Reading error amp errNumber Next k PreviousMsgNumber MsgNumber End If End Sub Sending a message Sub SendToAC MsgText Some Simple Link Layer String errNumber SendMessageToAVCM MsgText If errNumber 0 Then MsgBox Sending error amp errNumber End Sub Unregistering Sub UnregisterA VCM errNumber Unregister 1 If errNumber gt 0 Then MsgBox Unregistration error amp errNumber End Sub AlphaVision User Manual A100K10282 3 10 44 External applications AlphaVision User Manual A100K10282 8 10 45 About Zenitel With more than 50 years of experience STENTOFON systems offers solutions which have given us an international reputation as an expert on communication and security solutions We have a strong commitment to the quality and functionality of our products and invest continuously in developing products for secure and time critical communication STENTOFON development is based in Oslo Norway and supports a world wide sales and service network STENTOFON is a brand name owned by Zenitel Norway AS Box 4498 Nydalen NO 0403 Oslo Norway Quality Assurance Stringent controls throughout Zenitel Norway AS assure the excellence of our products and services Zenitel complies with the Quality System Requirements specified in NS EN ISO 9001 1994 and Norwegian Certification System s certification rules In the interest of product improvement Zeni
21. User manual STENTOFON O O 000 Q AlphaVision Contents Contents 1 1 1 2 1 3 1 4 Z4 2 2 2 3 2 4 3 1 3 2 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 Lr 5 Short Product IntroduetiOtlsmdesus 5 NT NN 5 AOUE Chis Nibe 5 VE FG 5 9 27 RET MHET 5 MaDi ENE 5 ridi isi 7 C onner GE vaste cod ccs 4 FAUST 7 22M SEM Cle MIC MUS transi estat PE ET 7 222 Cleese 8 PS MSDN 8 222 S s 9 225 NON vvs rennene 9 a 9 Velt CP 10 eee 10 240 PES tu NND 10 DOs EN 10 SSL 11 ER AEE EN RR EN dete ent te us 1 AEE SIMIC PC is 11 2412 eed 11 ES Mu l ple uuo ne 11 14 ARNE LES 11 m TNI 11 N 1 Programming Alpha VISION 5seesensseneseseseennendsntenend enensnndenepensenenkaekeenntdennesnndenndenadeneeaane 12 UID AS 12 PACTS E pirate eno rud boi dudo ae ERN PURSE GE gab ME Lo ipe dou UU UM 12 AD ME ANM 13 4 22 AlphaVision ve ce repu geo 13 PS 15 GE 0 TESE EE NE TE 16 SUES V SUCH SE a a a NE 18 lere SEE M MET DEN
22. aVision It is possible to show items in the sub system list always and maps if available 4 7 1 Map behaviour Options Man oom 20 Disable zoom Show Request iw Show Request Enabled 32 Preview width 32 Preview height Default map directory Main Form color Default map BA Second floor Intercom v Connected ra Call low priority high priority wv Error C Program Norway sAlphavisian maps mm System Input Status 1 Status 2 Status 3 Status 4 Programming Alpha Vision Status names by type B Intercom Station Label style Font color Bold Underline Invisible Scale 5 zi System Output Status 1 Status 2 Status 3 Status 4 Cancel Apply ConfigurationlOptionsIMaps makes it possible to define Map behaviour AlphaVision User Manual A100K10282 8 10 19 Programming Alpha Vision 4 7 2 Maps As from AlphaVision version 3 10 maps do not automatically change when a call request with a certain priority is received Instead AlphaVision will show a list with active icons Clicking on an item in this list will bring the relevant map to the front This list will show a miniature map with the position of the icon in it The size of the miniature map can be changed by setting Preview width and Preview height to the desired values Whether this facility 1s to be used can be define
23. cross the LAN 3 1 3 Multiple PC s stand alone When more than one operator position is to be equipped with a PC running AlphaVision and there is no LAN available it 1s possible to connect each PC to its own RS232 port on the exchange this is only possible if enough free ports are available In this case the connection to each PC is as described in paragraph Sil 3 1 4 AlphaNet In an AlphaNet configuration each PC running AlphaVision must be connected to a data port on the AlphaCom exchange to which the associated operator intercom is physically connected This is the case both for the stand alone and LAN configuration 3 1 5 Hardware key The software 1s fully enabled by the use of a hardware key which must be plugged into the USB or parallel printer port on the PC depending on the particular key Without this hardware key the software will start up in demo mode Demo mode is fully functional but only 6 devices see paragraph 4 7 3 can be defined The hardware key is not required for software installation 3 2 Software AlphaVision can be downloaded from the Zenitel web site Download the file SETUP EXE to a directory for instance c VAVInstall In that directory double click this file The set up software will start and guide you through the rest of the set up process AlphaVision User Manual A100K10282 8 10 11 Programming AlphaVision 4 Programming AlphaVision In AlphaVision there are three user levels e
24. d by the flag Show Request Enabled Which visible 2 statuses are to be put in the list can be set by flags under the columns Intercom System Input and System Output From the defined maps it is possible to assign one as Default map The default map will be shown at the moment the last active icon becomes idle again Removal of default map can be done by clicking the Default map list box and pressing the delete key Disable zoom makes the zoom buttons on the screen inactive An operator cannot zoom in or out on the maps Use Configuration Maps to edit add and remove maps All defined maps are listed in this dialog By using the buttons with the up and down icons it is possible to change the order of the maps Create will just add a new map area Edit will start a new dialog in which characteristics of the map can be changed The same dialog can be started by showing the required map right clicking in it and clicking on Properties In this dialog a number of items can be entered Picture The file name of the map WMF or BMP format Map name The name under which it will be listed Width and Height When a map file is defined this is not relevant However this gives the possibility to define a map area of a certain size without a map picture Icons can be defined in such a map to act as status indicators when the location of such icons is not important Frame This is an area a
25. day The file name is related to the date yyyymmddav txt These log files are stored in a location as specified in Log directory Press the button labelled to select the required path With Exit over password it is possible to define whether it is required to enter the password to exit the application It is possible to shut down the operating system when AlphaVision is closed Enable this feature with Shutdown Windows on exit AlphaVision has a possibility to define icons in maps and assign a double click action to those icons When Double click as single is enabled a single click on the icon will suffice to invoke the action which in general is the preferred way of operation when a touchscreen 15 used In order to operate properly AlphaVision needs to know with which intercom unit it is associated Select the node number and directory number of this unit with AlphaVision Node and AlphaVision Operator s station Note that the operator s station and AlphaVision must be connected to the same node AlphaVision uses a file called Langs mld situated in the same directory as AV exe for multi language support If this file is not present AlphaVision uses the default language If the file 1s present other languages can be selected after clicking on the button Language Select the required language and click OK There is a separate tool available called MuLaEditor exe With this tool existing language co
26. ecific number of parameters This means that the exchange will just generate and or re transmit such a message to the correct destination and keep the parameter list intact The above described facility will be used for transferring SI information to AlphaVision AlphaVision can use this information to display a to the SI related icon in the appropriate colour and react on a change of its status Each RCI in the AlphaCom exchange to be used will be programmed to at least send the following data string nhFF M7CO1 Und Wx Uy nh node number of the exchange to which the AlphaVision PC is connected in hexadecimal format node number of the SI in decimal format logical RCI number y 0 Off 1 On Inputs RCI Number gt Faults Descriptive Input 1 Device Number Exchange Fin Mumber 1 ON Action ON m 01FF LUT L1 OFF Action ROOT OFF LI VA Uo ON when closed 7 Normal open Delay Before ON Action 580 Activate Faulty Madule LED L For instance if RCI 1 should operate 1 and send the information about its status change to AlphaVision the programming of RCI 1 should be assuming that the node number of the exchange equals 1 e ON Action RCO I ON Q01IFF M7COI U1 W1 UI e OFF Action RCO I OFF GOIFF 7 1 Ul W1 UO AlphaVision can use this message to start a script The 3 parameters in the data protocol message Ul W
27. ected PC This is the LAN configuration 2 2 Features The main purpose of AlphaVision is e Display a list of received call requests Give the facility to the operator to accept call requests Operate SO s Open doors select CCTV camera s Display the status of SI s Act as a platform for feature extensions 2 2 1 Screen elements When AlphaVision starts the initial display shows a few different elements in a number of different areas on the screen e Map area on the right Call request Sub system list on the left Established call window below the call request list Menu at the top Message window at the bottom The size of the menu is fixed all other elements can be resized AlphaVision User Manual A100K10282 8 10 System description gt Alphavision Main building EB 181 gt Messages Configuration Scripts Help 81 amp 11 Q Q Main building J e 5 p Time LN Source 5 24 08 PM 101 101 25 11 2001 4 30 38 P Open Mode please wait 26 11 2001 4 30 48 P Standby Mode xi PEPE PP EPP Service qu Astart 4 2 8 1 10282 200 4 Alphavision 89 435 2 2 2 Call request list AlphaVision uses the internal queues of the AlphaCom exchange The AlphaCom can be set up to broadcast changes to its internal queues on its serial data ports Call requests are shown in the list sorted on priority and date
28. es means that it 1s possible to develop an application without the need for a development environment such as Visual Basic or Visual C Microsoft Windows Script Host 1s part of the Windows operating system The latest version can be downloaded from www microsoft com An external application can communicate with the exchange through the AVCM module For this AlphaVision itself does not have to be running An external application may be started from outside AlphaVision An external application started in this way has no access to parameters that Alpha Vision might pass if it would start the external application 7 2 Parameters When AlphaVision starts an external application it does that with the following command e EXEC Execute an external application Command parameter Path Application name Application parameters For instance e EXEC c d1 Appl exe Dir1 will start Appl exe in c d1 and use one command line parameter which in this case is whatever the value of Dirl happens to be If this file is not present in the defined path the EXEC command will be ignored The list with parameters which AlphaVision can pass is given in section 4 7 3 Data communication An external application may need to communicate with the AlphaCom exchange This can be done through the AlphaVision Communication Module AVCM When AlphaVision is started AVCM is started automatically as well If AVCM is required to run without AlphaVision itse
29. etc An external application needs to register itself with AVCM 7 3 1 VisualBasic 42 In the file avcm lib are the functions which are required for communication between an external application and the AlphaCom exchange The following error numbers are defined 1 AVCM ERROR TIMEOUT 2 AVCM ERROR CREATE SOCKET 4 AVCM ERROR BIND 8 AVCM ERROR SENDTO 16 AVCM ERROR MISMATCHED DATA 32 AVCM ERROR NO MESSAGES IN BUFFER 64 AVCM ERROR MSG NOT IN BUFFER 128 AVCM ERROR BUFFER IS FULL 256 AVCM ERROR CLIENT NOT REGISTRED 512 AVCM LOST COMMUNICATION To use the functions they need to be declared in the application e Private Declare Function SetRemoteModuleAddr Lib _ path avemlib dll By Val remote addr As Long ByVal remote port As Long As Integer Private Declare Function Unregister Lib _ path avemlib dll By Val terminateCM As Integer As Integer e Private Declare Function RegisterInAVCM Lib _ path avemlib dll By Val regname As String As Integer e Private Declare Function GetLastMessageNumber Lib _ path avemlib dll ByRef msgnmb As Long As Integer e Private Declare Function GetMessageFromAVCM Lib _ path avemlib dll ByVal msgnmb As Long ByVal Text As String As Integer AlphaVision User Manual A100K10282 8 10 External applications e Private Declare Function SendMessageToAVCM Lib _ path avemlib dll By Val Text As String As Integer For an external application to be able
30. is timer it is possible to set how long after AlphaVision startup communication with the AVCM module should be established Mode Run AlphaVision polls AVCM for new received messages The time period between successive polls is set with this timer Mode Standby When AVCM and AlphaVision are communicating after the Mode Open time AVCM tries to establish communication with AlphaCom exchange This timer sets the time period between different tries Max Repeat sets how often AVCM should try to establish this communication If communication cannot be established an icon appears at the bottom of the screen Click on the red arrow to repeat this process AVCM will try to establish the link with the exchange again Mode Test This timer starts 1f during operation the link between AlphaVision and AVCM is lost The timer is the time between successive tries the repeat counter sets how many times AlphaVision will try to re establish the link 4 3 System settings Use the menu item ConfigurationlOptions and select the tab System In this dialog a number of settings must be entered AlphaNet filter has to be enabled when AlphaVision is part of an AlphaNet installation It can also be enabled if there is only a single multi module exchange but this is normally not the case A further explanation 1s in paragraph 5 2 AlphaVision can store events on harddisk in a log file A new log file is started at midnight each
31. ist 6 1 3 Logging out Depending on the configuration of AlphaVision there are two possibilities when AlphaVision is closed down As an option it is possible that the user needs to enter the user name and password AlphaVision will always show a regret window at which point it is still possible to continue the program Closing down can be done via the FilelExit menu item AlphaVision User Manual A100K10282 8 10 35 Operation 6 1 4 Changing of password FilelChange Password gives the option to the user to change the password dialog will become visible in which the old and new passwords must be entered For verification the new password must be entered twice Change Password X Old Password Mew Password 6 2 Icon colours There are different icons for intercoms SI s and SO s available Normally the icon will reflect the type of installed equipment The behaviour of the icons is independent of the picture With the by default available icons in different corners of the icon different colours can appear These reflect the status of the device 6 2 1 Intercom The icons related to call in points can show the following statuses e Idle e Connection established Pink e Pending call request Blue e Busy Yellow s 6 2 2 SPs and SO s The icons related to SI s and SO s can show the following statuses e Idle Or l AlphaVision User Manual A
32. lf the application AVCM exe can be started independently AlphaVision User Manual A100K10282 8 10 41 External applications AVCM makes the following functions available e SendMessageTOAVCM e GetMessageFromAVCM e GetLastMessageNumber Data which AVCM receives from the AlphaCom exchange is put into a circular buffer Such a message can be addressed via the number of the position into which the message is put By using the function GetLastMessageNumber AVCM can indicate in which position it has put the last message it has received from the exchange An external application can from this information deduce whether new messages have been received by AVCM since it polled AVCM the last time The application can use GetMessageFromA VCM to get a message from a certain position in the buffer It is the responsibility of the external application to poll AVCM regularly for the position of its receive buffer pointer An external application can use the function SendMessageToAVCM to put a data message into the AVCM transmit buffer AVCM will then transmit this message to the AlphaCom exchange AVCM uses the AlphaCom data protocol message EXECUTE COMMAND to send information to the exchange The message passed to AVCM will just be send as a parameter of this command AVCM does not check the correctness of the parameter Any message which normally can be sent as parameter of the EXECUTE COMMAND can be used This includes commands such as MPP MST
33. lling directory number 7885 from an intercom with superuser status This starts a tonetest in the exchange effectively marking each connected intercom and sending information about it to AlphaVision If no operator station has been assigned to AlphaVision AlphaVision will do so automatically to the station with directory number 102 in node number 1 once this station has been found by the exchange 4 20 Administrative 12 If the default settings cannot be used AlphaVision needs to know something about the programming of the exchange e Which intercom directory number is associated with the AlphaVision position e The device number of the AlphaVision PC e The directory number of all call in points e The logical number of all SI s and SO s Status Inputs and Status Outputs AlphaVision User Manual A100K10282 8 10 Programming Alpha Vision 4 2 1 AVCM The AlphaCom exchange handles AlphaVision as a device The communication between AlphaVision and the exchange is via a separate application a software module called AVCM AlphaVision Communication Module Communication between AVCM and the AlphaCom exchange can be via IP or a serial connection Start the program AVCMSETUP EXE to set the parameters required by AVCM e Select the communication type between AVCM and the AlphaCom exchange e ACE IP address is the IP address of the AlphaCom Ethernet port used to communicate with AlphaVision e ACE IP port number is the IP port number as
34. llowing items must be programmed 1 For each ACDP link which will be used to communicate with an AVCM module Update Records ACDP Link 4 Fort Type server Link Type Stentofon Multidrop Master Reserved Broadcast Destination Part SRI 0 Keep Alive Enable the ACDP Link Port Type Select one of the serial ports or set as TCP IP server When a serial port is selected set the port to 9600 baud 8 data bits no parity and 1 stop bit otherwise set a Port number Note that the port number must be enabled in AlphaWeb the suggested port number is 55010 Select link type Stentofon Multidrop Master Enable Broadcast 2 For each AlphaVision PC device number Device Number 4 Description Device Type Data ACDP Link Define the ACDP link number Set the Device Type to Operator passive After changes to the serial port setting the exchange needs to be reset 5 2 AlphaNet AlphaVision relies on data which it receives from the AlphaCom exchange The main messages it uses are 1 ST BUSY 2 ST FREE BC AlphaVision User Manual A100K10282 8 10 29 Programming the AlohaCom 30 3 CONN STATUS BC 4 DISCON STATUS BC 5 Q ELEM ADDED 6 ELEM REMOVED In an AlphaNet installation the first 4 of these are not always reliable This is because these messages give information about the connections in the local exchange not about the end to end connection
35. lphaVision provides the facility to start scripts on the receipt of specially defined data messages This is very similar as described above under the heading 5 3 The exchange can generate such a data string from the event handler The general format of the data string is 2nhFF M7Cxy L nd 1 DIRQ U 3 CHG 1 0 L 2 DIRO nh node number of the exchange to which the AlphaVision is connected 1n hexadecimal format nd node number of the exchange to which the station is connected in decimal format xy is in the range 0x10 Ox2F 7Cxy tells AlphaVision which script to execute 1 DIRQ 3 CHG 1 0 and 2 DIRQ in that order provide parameters for the script if required AlphaVision User Manual A100K10282 8 10 33 Programming the AlphaCom 34 Owner Type Stations w UDP Property 1 Event Type 115 Event Trigger Feature Subbpe 0 Wenchewero w F When Related To Directory Number Id n 6902 Action Command ar 0 a 10 L l El DIR Ul LE2 DIE vr Any event action list can contain a command as described above It 1s also possible to define directory numbers with feature numbers 52 or 85 event trigger with or without cancel tone which sole purpose is to send such a data string Feature 052 Event Trigger Without Tone M Directory Humber 6902 Display Text something The intercom which dials the number causes the data string to be sent where its ow
36. lumns can be edited and other languages can be added AlphaVision User Manual A100K10282 8 10 15 Programming Alpha Vision mor System Communication Fiequest Scripts Maps Alpha isian Made f l lphaCom 1 Operator s station Guard pplicatio Exit over password Shutdown Windows on exit W Double click as single AlphaNet filter Language Log M Autoload devices Log directory C Program Files enitel NonvayAlpha isionsLog 4 4 Call request list Right clicking on an item in the call request list always brings the map in which the related icon is placed to the foreground The appearance of the call request list can be changed Select ConfigurationlOptions from the main application menu Select the tab Call Request Options Info colors selected item item selected Active connection Source Time High priority appearance m Normal priority Font size request list Button size aj 140 ad Font size 8 m B High priority Cancel Apply The call request list can have a maximum of 7 columns 1 Name of the intercom which initiated the call request as defined in AlphaVision AlphaVision User Manual A100K10282 3 10 16 Programming Alpha Vision Directory number of the intercom which initiated the call request Node number of the AlphaCom exchange whe
37. me manager password manager e Operator level access name operator password operator AlphaVision User Manual A100K10282 8 10 13 Programming Alpha Vision A user which logs in on Service level has access to all functionality on Manager level previous programming can be edited only It is advisable to re define these user names and passwords after the first log in To make the link between AlphaVision and the AVCM module select ConfigurationlOptions from the main application menu Select the tab Communication System Communication Call Request Scripts Serve IP Address Part w Local Run 27 1 5000 Server Path Mode Standby on connecting lphaCom Javem avem exe m Timer 2000 repeat 1 Ch gt EN ien 2 000 1 Client Path avemtavemlib dl Registration M ame Timer 1000 repeat 3 AM 1 000 E 3 lex Timer 3000 Timer 650 3 000 550 Mode Test on timeout Apply Enter the location of AVCM exe and AVCMLIB dll Make certain that the value of Port matches the value as entered in AVCMSETUP exe The location of AVCM exe is only required when Local is enabled In this case AlphaVision needs to know this location so it can start AVCM when required otherwise AVCM needs to be started in another way AVCM exe and AV exe do not have to run on the same PC in fact as part of a LAN
38. n directory number 1 DIRQ in the event handler can be used as parameter in the script The dialled number can be 2 DIR 0 in the event handler The 3 parameters in data protocol message L 1 1 DIRQ Ul and L 2 DIRQ in the action list in the example above are related to the script parameters as follows e DIR2 directory number in AlphaCom event handler CHG 1 for on 0 for off e DIR3 Related to directory number in AlphaCom event handler AlphaVision User Manual A100K10282 8 10 Operation 6 Operation The operation of AlphaVision depends very much on the programming of scripts Some basic behaviour is always the same such as entering of call requests into the call request list 6 1 Users 6 1 1 Logging in When AlphaVision starts a log in screen will be shown xi Hame Password __ The user must enter his or her Access name and Password Depending on the entered data AlphaVision will start up in the correct user level mode 6 1 2 Handing over It is possible to change users the This means that it 15 not necessary to stop AlphaVision and restart it again when there is a change of operator From the main menu File select Handover File Messages Configu Handover Change Password A dialog similar to the Log in dialog will become visible The new user can now log in Any pending call requests remain in the l
39. n the map e From the intercom keyboard as described in the different AlphaCom manuals note that in this case a defined script on Direct Call will not be executed this is of course always possible All the above actions set up an audio connection between the operator and the call in point The icons related to the call in point will turn pink Details about the connection will be displayed in the established call window directly below the call request list with the directory number and name of the call in point One or two buttons will become visible depending on the programming for the call in point e Cancel Click this button to cancel the conversation This is the same as pressing the on the operator s intercom e An action button This button is only visible when an action during conversation is defined for the call in point This could be for instance Open door Click this button to start the action 6 5 Cancel call An established connection between a call in point and the operator can be cancelled by the operator e Click the Cancel button on the screen e Cancel the conversation from the intercom note that in this case a defined script on Cancel Call will not be executed The icons related to the call in point will turn to the idle indication The call window will be cleared 6 6 Script execution Scripts can be started from many different points A number can be started at any time by
40. nder High priority appearance For other devices the status is numbered 0 4 and depends on the status byte value as received for the AlphaCom exchange By selecting ConfigurationlIcon Sets it is possible to add edit and delete icon sets Give the icon set a name and for each state load a picture Press the Load button to browse and select an appropriate graphics file For each state it is possible to set a number of additional properties e Transparent changes the appearance of the icon check the result in the preview window e Flashing e Invisible the icon and its label are not shown on the map normally only used for the idle status especially when there are many icons in the same map e Do not show icon status the icon appearance and properties will not change from the previous status only available for status 2 and 3 e Do not put into call request list the icon status will be reflected on the map but not in the call request list only available for status 2 and 3 AlphaVision User Manual A100K10282 8 10 Icon set Mame E Pictures Idle Connected 2 Call low priority Call high priority Error Transparent Flashing Invisible Do not show icon state Do not put into call request list Size preview 16 4 7 Devices and maps Intercoms Status Inputs SI s and Status Outputs SO s should be defined to give access to the full power of Alph
41. path avemlib dll By Val regname As String As Integer Private Declare Function GetLastMessageNumber Lib path avemlib dll ByRef msgnmb As Long As Integer Private Declare Function GetMessageFromAVCM Lib _ path avemlib dll ByVal msgnmb As Long ByVal Text As String As Integer Private Declare Function SendMessageToAVCM Lib _ path avemlib dll ByVal Text As String As Integer Dim errNumber As Integer Dim IPAddr As Long Dim Port As Long Dim PreviousMsgNumber As Long Dim RegName As String Dim MsgText As String Registering the application with AVCM Sub AVCMInit initialization RegName Example AlphaVision User Manual A100K10282 3 10 43 External applications IPAddr 16777343 Port 5000 errNumber SetRemoteModuleAddr IPAddr Port If errNumber 0 Then MsgBox Remote module error amp errNumber errNumber RegisterinAVCM RegName If errNumber gt 0 Then MsgBox Registration error amp errNumber errNumber GetLastMessageNumber PreviousMsgNumber If errNumber gt 0 Then MsgBox Read LastMessageNumber error amp _ errNumber End Sub Getting a message Sub GetLastMessage Dim k As Integer Dim MsgNumber As Long errNumber GetLastMessageNumber MsgNumber If errNumber gt 0 Then MsgBox Read LastMessageNumber error amp _ errNumber If MsgNumber lt gt PreviousMsgNumber Then for k PreviousMsgNumber 1 to MsgNumber MsgText String 255 errNumber GetMessageFromA VCM
42. programmed in the AlphaCom for communication with AlphaVision e AV port number This is the port which AVCM uses to communicate with other applications such as AlphaVision Set this to the same value as entered in AV exe itself The value 5000 is the default in both e AC node number The node number of the AlphaCom with which AVCM communicates The number should be entered as a decimal value in the range 1 254 e AV device number The device number as assigned to AlphaVision The number should be entered as a decimal value in the range 1 64 e Serial port enter the PC s serial port which will be used for communication with the exchange Note that the serial port parameters are fixed to 9600 baud 8 bits no parity and 1 stop bit AVCM Setup 3 10 X AVCM Setup 3 10 Communication type Serial Communication type Serial IF IP address B3 254 1 5 AL E IP part number 5501 0 AV port number 5000 number NE Seral port AV port number AL node number AM device number T AV device number 64 Cancel To finish the programming of the AVCM module click OK 4 2 2 AlphaVision programming All other programming is from within AlphaVision itself To be able to enter the programming AlphaVision needs to be started AlphaVision will display a log in screen There are three pre defined users Service level access name service password service e Manager level access na
43. re in the map area not on a device icon a drop down menu appears listing the defined maps From this menu the required map can be selected as well Double clicking in the map area not on a device icon shows the map at the default size Right clicking on a line in the call request list will show the map related to that pending call request It is possible to display multiple maps Press one of the buttons Or to show the maps in the desired way AlphaVision User Manual A100K10282 8 10 39 External applications 7 External applications 7 1 Functionality AlphaVision can start external applications The idea behind the use of an external application is modification or extension of the default behaviour of AlphaVision Examples of such applications An application which at certain intervals updates the AlphaCom internal clock with the PC time An application which sets and resets transfers at certain times A prisoner information management package Interfaces through AlphaVision with other sub systems such as fire alarm An application which scans certain intercoms for listening in purposes An application in which it is possible to enter wake up times An external application can be an executable file extension EXE It is also possible to use a script language VBS or JS These are run as parameter to the WSCRIPT or CSCRIPT commands of the Microsoft Windows Script Host Use of these scripting languag
44. re the intercom is located Time as passed to AlphaVision by the data received from the AlphaCom Priority of the call request MailTag of the mail 7 Text parameter as passed to AlphaVision by the AlphaCom exchange ON ROO PO Of each of these columns it is possible to set the title whether the column should be visible and in which order the columns should appear e set whether the column should be visible double click in the Visible field means visible 15 not visible e To change the title click in the Caption field and edit as desired To change the order of the columns select a field and by clicking on the Up and Down buttons put the column in the required position Underneath the call request list is an information window In this window information can be displayed about call requests and established calls The background colour of this window can be set differently to easily distinguish between the types of information given The window can have three different background colours No selected item if no information is displayed Tag item selected information about an in the call request list selected item e Active connection information about an established call How information about a call request is displayed can be selected by entering parameters in the Information column For instance in the picture above two information fields are activated Priori
45. round the map area which can be defined as a border By picture and current zoom are related to the ratio of sizes of maps and icons Icons are resized when a map is resized The basic size of the icon in the map is determined by the standard size of the map drawing By picture or the size of the map as it is shown in the map area when By current zoom is selected The background colour of the map itself and the map window can be set with Window Colour and Map Colour 4 7 3 Devices Use ConfigurationlDevices to show a list of all defined devices In this dialog it is possible to edit add and delete devices 20 Type defines one of the following AlphaCom Node each AlphaCom in the network needs to be defined with its node number intercoms SI s and SO s will be shown in the sub system list as connected to the relevant AlphaCom AlphaVision User Manual A100K10282 8 10 Programming AlphaVision Intercom Station System Input System Output Add and Edit show a dialog in which the properties of the devices can be entered Before Add is clicked the relevant type must be selected under Device type The properties dialog is the same as is shown when right clicking a device icon Name is the name with which it is known to AlphaVision Node Number is the node number in AlphaNet to which the device is connected Logical Number is the directory number for intercoms and logical number for SI s and
46. rs the script AlphaVision User Manual A100K10282 8 10 Programming AlphaVision 7oDIR 1 is always available Button 1 and Button 2 DIR2 the directory number of the call in point the exchange node number related to DIR2 9 TAG mailtag number the priority of the call request Button 3 and Button 4 DIR2 the directory number of the call in point 9oNN the exchange node number related to DIR2 the connection reference this must be used with care as depending on the way the exchange is programmed this may not be the actual connection reference as used by the exchange itself Intercom device AlphaVision operator No additional parameters Intercom devices right click on icon DIR2 the directory number of the intercom 9oNN the exchange node number related to DIR2 SI devices right click on icon PSI the number of the SI 9oNN the exchange node number related to DIR2 SO devices right click on icon PSO the number of the SO 9oNN the exchange node number related to DIR2 EXT MAIL 0x0030 TAG Mail tag DIR2 Sending station related to DIR2 MN 0x0030 ST BUSY BC 0x0036 DIR2 related to DIR2 MN 0x0036 ST FREE BC 0x0037 DIR2 related to DIR2 MN 0x0037 CONN STATUS BC 0x0041 O6DIR2 A s
47. se Node Device Type and Device to select the relevant device Otherwise leave these fields empty They can be cleared by clicking Clear device Define the actions as required show log script The caption of the button Replace in the picture below changes to Add when appropriate a new definition rather then changing the properties of an existing definition AlphaVision User Manual A100K10282 8 10 24 Programming Alpha Vision Message Made 0048 Queue elem added 1 Device B Intercom Station Clear device Device Cell A Filter properties Show in window Write to log Script File Info ser E Heplace 4 8 5 Script files A script file contains the commands to be performed Scripts can contain more than 1 command Scripts can be associated with parameters command parameters and script parameters Script commands have the following structure lt Command gt lt Command parameter s gt If a command has a number of command parameters the parameters are separated by a space If the command parameter itself contains an embedded space the command parameter must be enclosed by double quotation marks The following commands are defined SETTIME set the AlphaCom time to the PC time no parameters PRINT The command parameter is the string which will be displayed in the history list LOG
48. selected These actions are programmable If the item 1s defined in a map the action Show in map will be available Clicking on this will display the map which contains the device 2 2 5 Message window Any information received by AlphaVision which AlphaVision uses itself can be made visible in the message window However it is possible to filter messages and so define the information that should be visible By AlphaVision received information can also be stored on disk as a log The filtering on information to be stored 1s independent of information to be displayed in the message window The message window is a docking window It can be placed somewhere else on the screen resized and closed 2 3 Functionality When first installed AlphaVision has some default behaviour It is possible to accept call requests e delete call requests from the queue without answering e assign a door to an intercom and open the door during conversation e cancel a connection The default behaviour can be altered through scripting All of the above listed actions that AlphaVision takes are part of a script The default behaviour is defined in default scripts Default scripts can be edited additional scripts can be added Script commands can be data messages in simple link layer format to be sent to the AlphaCom exchange and commands to start external applications Script commands can be used together with parameters Scripts can be started in a
49. st By selecting the tab Call Request or System Tree it is possible to display either of these two information windows The system tree displays a list of all to AlphaVision known devices and their current state At the top of the tree is the operator intercom unit If a call request is received while the system tree is displayed AlphaVision will automatically revert to the call request list From the sub system list it is possible to place an icon in the required map directly Bring the desired map to the foreground drag and drop the icon to the correct position Right clicking on the icon gives a list of possible actions Properties This is always available Clicking on it shows a dialog where the properties for the device can be altered e Show in map This is only available if the icon is defined in a map Clicking it brings the relevant map to the foreground e Availability of other actions depends on the defined scripts for the device and the status of the device 4 6 Icon sets 18 AlphaVision has some built in icons for the different device types Pictures can be defined to make customised icons In AlphaVision a device can be in 5 states For intercom devices these states are pre defined 0 Idle 1 Connected 2 Call low priority making a call request 3 Call high priority making a call request 4 Error The difference between 2 and 3 in the list above is defined in the option screen u
50. st and click Accept e Double click on the call in point in the call request list e Double click on the icon in the map e From the intercom keyboard as described in the different AlphaCom manuals note that in this case a defined script on Accept will not be executed All the above actions set up an audio connection between the operator and the call in point The icons related to the call in point will turn pink Details about the connection will be displayed in the established call window directly below the call request list with the directory number and name of the call in point One or two buttons will become visible depending on the programming for the call in point e Cancel Click this button to cancel the conversation This is the same as pressing C key on the operator s intercom e An action button This button is only visible when an action during conversation is defined for the call in point This could be for instance Open door Click this button to start the action AlphaVision User Manual A100K10282 8 10 37 Operation Accepting the call request will remove the request from the internal AlphaCom queues It will disappear as such from any operator position that received the same request 6 4 Direct call An operator can call a call in point without the call in point having made a call request if this possibility has been programmed this 1s not default behaviour e Double click on the icon i
51. tel Norway AS reserves the right to alter specifications and design without notice ZENITEL NORWAY AS zenite uos EU d NS EN 150 9001 Certified FT AC CRE DAT AT KOM na 900162
52. time The call request list has a number of columns It is programmable which columns are displayed and in which order 2 2 3 Maps AlphaVision can handle maps which are in BMP and WMF format Most Windows based drawing programs can export files in either or both of these formats It also gives the facility to use files which are produced by a scanner The maps can be displayed in different scales From within AlphaVision it 15 possible to place icons on the maps There are icons for intercoms SI s Status Inputs and SO s Status Outputs The appearance of an icon gives an indication of its status Double clicking an intercom icon sets up a connection between the operator and the selected intercom if defined this way Right clicking gives access to a drop down menu list from which an action can be selected 1f such actions are defined These actions are programmable AlphaVision User Manual A100K10282 8 10 System description 2 2 4 Sub systems The by AlphaVision handled sub systems are shown in a list in a format similar as used by Windows Explorer AlphaVision is at the top of the list It is possible to descend into branches down to the level of individual intercoms SI s etc The icons which are displayed on this level are the same as the ones used in the maps The colour of an icon gives an indication of its status If the item 1s selected right clicking gives access to a drop down menu list from which an action can be
53. tions and behaviour These functions are defined in standard scripts By modifying and adding scripts the functionality can be altered and extended AlphaVision User Manual A100K10282 8 10 21 Programming Alpha Vision 4 8 1 Default scripts Options AN LU 6 x System Communication Call Request Scripts Maps Default scripts Script type Caption Button 1 d Accept W Enabled 8 Start script T NN SDIRZ W64 Default script director C Program FilestStento 45 4 Alohayisionecripts Cancel Apply Via the Scripts tab in the Options dialog script behaviour of the default scripts in AlphaVision can be defined There are 5 possible default scripts e A script which runs on AlphaVision start up This gives the possibility to start executable files which should run together with AlphaVision in order to extend the capabilities of AlphaVision e A script for each of the 4 special buttons Button 1 Button 4 NE Accept Delete i Open Door Cancel These 4 buttons are below the call request list and the information window Each of the 5 default scripts can be enabled or disabled and a caption can be assigned As a default the behaviour is as follows e Button 1 caption Accept enabled default script STE SCALL L DIR1 L NN DIR2 W64 e Button 2 caption Delete disabled default script STE SDELETE MAIL L DIR1 W TAG STE C L NN DIR2 e
54. ty and Text16 The character means that the value of the parameter should be used The effect 1s as depicted below Priority 100 Text 101 SystemStat The font size of the items in the call request list can be changed by clicking the Font size up and down buttons The size of the buttons related to call requests below the call request list and established calls below the information window can be changed by clicking the Button size up and down buttons AlphaVision lists incoming call requests in order of priority and time It is possible to define call requests with an AlphaCom level higher than defined in High priority appearance to be shown with a distinctive colour background in the call request list To save the changes click on the Apply button When the dialog is closed by the button the changes are effected in the AlphaVision screen The width of each column of the call request list can be set by moving the mouse in the title part of the columns to the border between columns and dragging the border to the required width The width of the call request list itself can be altered by dragging the outer border of the list to the required position By clicking the ES button it 15 possible to remove the map area totally and add that part of the screen to the call request list area This is a toggle button AlphaVision User Manual A100K10282 8 10 17 Programming AlphaVision 4 5 Sub system li
55. ubscriber DIR3 B subscriber related to DIR2 MN 0x0041 TAG Connection Reference DISCONN STATUS BC 0x0042 MN 0x0042 Connection Reference Q ELEM ADDED 0x004b DIR2 MN 0x004b Mail tag Q ELEM REMOVED 0x004c DIR2 AlphaVision User Manual A100K10282 8 10 27 Programming AlphaVision 28 YNN MN 0x004c Mail tag 0x7c01 Defined message id to transmit SI status information to AlphaVision PSI SI logical number PNN 96MN 0x7c01 1 for on 0 for off 0x7c02 Defined message id to transmit SO status information to AlphaVision PSO SO logical number NN 96MN 0x7c02 1 for on 0 for off 0x7c06 Defined message id to transmit intercom failure information to AlphaVision DIR2 the directory number of the intercom the exchange node number related to DIR2 0x7c06 1 for on 0 for off 0x7c10 0x7c2f Defined message id s for general purpose use DIR2 Owner directory number in AlphaCom event handler PNN 1 for on 0 for off DIR3 Related to directory number in AlphaCom event handler MN 0x7c10 0x7c2f AlphaVision User Manual A100K10282 8 10 Programming the AlphaCom 5 Programming the AlphaCom 5 1 Administrative In AlphaPro the fo
Download Pdf Manuals
Related Search