© BOSCH Sicherheitssysteme GmbH                                     created 22.11.2017

OPCServer for MAP5000 Version 1.4.1				    				
Deutsche Version weiter unten

**************************************************************************************
Uninstall the Program "MapOPC" before installing the new version of MAPOPCServer using
"Start->Settings->Control Panel->Add or Remove Programs". Before installing, make sure
that the latest Windows updates are installed on the PC.
**************************************************************************************


!! Notes for creation the setup:
---------------------------------
!! In the file "Startparameters.xml" of project Bosch.MAP.OPC.Server.Setup set the 
!! property configdir = "". If you fail to do this then a default path appears in the
!! client installation as it is used in devellopment phase.


Changes MAPOPCServer 1.4.1 vs. 1.3.9
------------------------------------

 - Important note: 
   Because of a property change and a new property in the StartparametersEditor the 
   previous configuration of the MAPOPCserver can not be further used. Please generate
   a new configuration for MAPOPCserver using the StartParametersEditor. 
   The UID of the MAPOPCserver remains the same, means the existing setup in BIS can
   be further used.

 - Support of an additional operating system
      * Windows Server 2012 R2

 - MAP CommServer isn't used anymore. Now MAP Comm DLLs are used directly.

 - Support of new detector types:
      * FNM-420-A/B    Stand-alone Sounder indoor/outdoor
      * FNM-420-A-BS   Base Sounder indoor
      * FNM-420U-A/B   Stand-alone Sounder indoor/outdoor uninterruptible
      * FNM-420U-A-BS  Base Sounder indoor uninterruptible
      * FNS-420 R      Strobe
      * ATB-420        LED Annunciator with outputs (32 OUT)
      * ATG-420        LED Annunciator (32 LED)

 - Support of new keyswitch functions:
      * Internal program On/Off
      * Internal program Off
      * Silence

 - Improvement in the detection of duplicate names of points and areas in the Start-
   parametersEditor.
   Note: Please always execute the panel validation for "Duplicate Names" in RPS for MAP 
   before publishing the configuration. 

 - Area State Refresh:
   New property for automatic refresh of the "Ready to Arm" state of areas in the 
   StartparametersEditor by implementation a configurable polling mechanism.
   Default refresh time = 20 sec. If necessary this time can be modified individually 
   for each single area.

 - Problems with the display of the Internal Program states are resolved. Now the states 
   are displayed correctly.

 - Alarms occurred during a disconnection phase get displayed at BIS after reconnection.
   

Changes MAPOPCServer 1.3.9 vs. 1.3.3
------------------------------------

- OPC Core Components 3.0 and .Net Framework V4.0 or higher required.
  Please check versions before OPC installation.

- File "Startparameters.xml" as template:
  By extension of the file name "Startparameters.xml" with .OLD/.DE/.EN this file is now
  available as a template.
  To select the required template rename the file according the following format:

  -> Startparameters.xml

  Template "Startparameters.xml.old":
  -----------------------------------
  This template complies with the previous Startparameters.xml
  A few default values of states have been changed. Please check the states when updating 
  the OPCServer.

  |  Name                        | state old | state new |
  --------------------------------------------------------
  |  Normal                      |     271   |       5   |
  |  Disarmed                    |       5   |    2011   |
  |  Duress                      |    1526   |      86   |
  |  Armed                       |    2211   |    2010   |
  |  Fault                       |     274   |      12   |
  |  Tamper internal             |    4061   |      19   |
  |  Bypass                      |    5000   |       3   |
  |  Disabled                    |    5003   |      31   |
  |  Verification                |    5001   |      30   |

  -> Use this template for updates older MAPOPC Server versions or with new Installations
     of the OPC with BIS version 3.0 and older.

  Template "Startparameters.xml.DE" and "Startparameters.xml.EN":
  --------------------------------------------------------------
  These two new templates include German or English terms and commands plus new default 
  values for the states. These states are supported only from BIS version 4.0 or higher.

  -> Use this template only for new installations with BIS 4.0 or higher.

  |  Template                    | Language | Support in BIS Version
  -------------------------------------------------------------------
  |  Startparameters.xml.old     |    EN    |     V3.0 and older
  |  Startparameters.xml.de      |    DE    |     V4.0 and higher
  |  Startparameters.xml.en      |    EN    |     V4.0 and higher

- The OPC DA mode for OPC clients is now configurable.

- Support of the point type "Hold-up (Non Silent)"

- Change of validation of the "Config Directory" entry in the panels tab when saving:
     * if the specified directory does not exist (String.Empty, null or not existent)
       the current assembly directory will be used (as hitherto)
     * the contents of the text box will be set newly if necessary (changed)
     * if file "ld_all_cfg_001.xml" does exist in this directory, then all is fine
       (changed, in previous versions only the presence of the directory was tested)
     * if not, the panel will be added to the list of faulty panel (list<Panel>)
       (as hitherto)
     * further processing, display of a message with the faulty panels (as hitherto).

- Limiting of the log file settings to avoid too big log files (both COMM Service and
  OPC Server). Now maximal 10 log files with 5 MB each will be created.

- If the LSN loop is installed over several areas the tamper event is created in 
  dependancy of the armed/disarmed state of the individual area.

- Improvements of the fault handling at connection loss.

- Bugfix in registration of the OPCServer during installation.

- Bugfix for displaying the "ReadyToArmState". This value kept unchanged when using 
  OPC in DA mode.

- Bugfix for using the same name for "Areas" and points. This issue is nun listed 
  in the file "Problems.txt".

- Modification of the LSN gateway device name when flat name space is configured (the 
  area name is added to the Loop name) to avoid duplicate names.

- Update of OPCServerFramework version to avoid errors with unvalid OPCServer names.


Changes MAPOPCServer 1.3.3 vs. 1.3.1
------------------------------------

- Test of panel host key according BSI. When the OPC connects to the panel the panels
  RSA fingerprint is checked.


Changes MAPOPCServer 1.3.1 vs. 1.3.0
------------------------------------

- It is now possible to use the flat namestpace

- In startparameters.xml the state values for a boltcontakt have been changed from 506 
  and 507 to 5 and 2011. This is just a change in the startparameters.xml

Changes MAPOPCServer 1.3.0 vs. 1.2.1
------------------------------------

- Implementation of an action queue for all messages to the panel.

- The usage of the queue can be controlled with a property.

- Duplicates of refreshRequests are not entered in the queue.

- The query PanelRefreshRequestcan be controlled with a property. Either a Refresh
  Request is sent for the whole panel or for a single component of the panel.

- BIS is set to Busy when the current message waits longer in the queue for 
  processing than a configurable time.
  
- Status Busy is cleared when the dwell time of the current action is less than a
  configurable time.

- Improvements of the Startparameter-Editor so that the settings from the XML file
  can be read and can be written in a file.

- Before a message is sent to the panel it is checked if the panel is currently busy.
     * If the panel is currently busy the check is repeated again after a short period.
     * If there is no confirmation after a defined time, the check is repeated again.
     * If the panel is not busy the current message is processed.

- Implementation of a new message "PanelRefreshRequest".


Changes MAPOPCServer 1.2.1 vs. 1.1.0
------------------------------------

- Support of virtual points, virtual outputs and virtual key switches.

- For keypad new status added: "deactivated" and "trouble and deactivated"

- New point type "Fire" added with its status "fire internal" and "fire external"


Changes MAPOPCServer 1.1.0 vs. 1.0.7
------------------------------------

- Possibility displaying points of an area in hierarchic manner. This can be done
  with the StartparameterEditor.

- OPC extended with AE functionality

- Configuration shifted from the MAP cfg files in the own Startparameters.xml

- Extension of StartparameterEditors with the setting the number of retries, until
  status P4 is sent to panel address.

- Rework of the logging protocol and the possibility to change the logging configuration
  at runtime.

- Supports Windows7 x86 and x64


Changes MAPOPCServer 1.0.7 vs. 1.0.6
------------------------------------

- Status "Trouble" added to SystemDevices

- Bugfix for status Hold-up. This status is always set to Hold-up.


Changes MAPOPCServer 1.0.6 vs. 1.0.5
------------------------------------

- The area state of an External-Intrusion Alarm of a 24 h point is checked a second time.
  When the area is disarmed the alarm is sent to BIS as Internal Intrusion Alarm.

- After refresh all addresses keep the state "Disable" or "Bypass".

- Sometimes a duress alarm from a keypad is not displayed at BIS. Reason for this is that
  the message restores so fast, so this cannot processed from a DA-OPCServer.

- A bigger amount of events in the log are moved to DEBUG, so the log files 
  should be smaller now.
    

Changes MAPOPCServer 1.0.5 vs. 1.0.4
------------------------------------

- SetTime method sets on an input value of "00:00:00" automatically the current time and 
  date onto the MAP5000.

- Points keep their status even past a refresh and do not just show 'Active' 
  In case of an armed area an External Alarm remains an External Alarm.
  In case of a disarmed area and an armed Internal Program an Internal Alarm remains an 
  Internal Alarm.
  In case of a disarmed area and disarmed internal program 'Active' will be shown for a
  tripped point.
	
- An interruption of the connection will no longer being reported immediately to the BIS.
  Before the report is done a configurable number of reconnect attempt is done.
  

Changes MAPOPCServer 1.0.4 vs. 1.0.3
------------------------------------

- Internal programs are handled correctly now. (Status of Internal program is strongly
  connected to an OR over all areas)

- Error handling was improved, so that connection is only disconnected when a reconnect
  to the MAP panel isn't possible anymore. 


Changes MAPOPCServer 1.0.3 vs. 1.0.0
------------------------------------

- Universal error handling for the state machine implemented. Errors within the state
  machine do no longer kill the event listener

- AntiMask status is now handled correctly

- If a point has been set to active, it will remain active as long as the point is not
  being cleared.
  



Deutsche Version

******************************************************************************************
Bevor die neue Version des MAPOPCServers installiert wird, muss das Programm "MapOPC" über
"Start->Einstellungen->Systemsteuerung->Software" deinstalliert werden. Vergewissern Sie
sich vor der Installation, dass die neuesten Windows-Updates auf dem PC installiert sind.
******************************************************************************************


!!  Hinweise zum Erzeugen des Setup:
------------------------------------
!!  In der Datei "Startparameters.xml" im Projekt Bosch.MAP.OPC.Server.Setup den Parameter 
!!  configdir = "" setzen. Wird dies unterlassen, erscheint nach der Kundeninstallation
!!  als Vorgabepfad ein Eintrag, wie er zu Entwicklungszwecken benutzt wird.


Änderungen MAPOPCServer 1.4.1 gegenüber 1.3.9
---------------------------------------------

 - Wichtiger Hinweis:
   Wegen einer Parameteränderung und eines neuen Parameters im StartparametersEditor kann
   die bestehende Konfiguration des MAPOPCservers nicht weiter verwendet werden. Bitte 
   erzeugen Sie mit dem StartParameterEditor eine neue Konfiguration für den MAPOPCserver.
   Die UID des MAPOPCservers bleibt gleich, d.h. die bestehende Konfiguration der BIS kann
   weiterhin verwendet werden.

 - Unterstützung eines weiteren Betriebssystems
      * Windows Server 2012 R2

 - Der MAP CommServers wird nicht mehr genutzt. Stattdessen erfolgt eine direkte Nutzung
   der MAP Comm DLLs.

 - Unterstützung neuer Meldertypen:
      * FNM-420-A/B    Sirene für Innen-/Außenbereich
      * FNM-420-A-BS   Sockelsirene für Innenbereich
      * FNM-420U-A/B   Sirene für Innen-/Außenbereich unterbrechungsfrei
      * FNM-420U-A-BS  Sockelsirene für Innenbereich unterbrechungsfrei
      * FNS-420 R      Blitzleuchte
      * ATB-420        LED Anzeigetableau mit C-Ausgängen (32 OUT)
      * ATG-420        LED Anzeigetableau (32 LED)

 - Unterstützung neuer Schlüsselschalterfunktionen:
      * Internprogramm Ein/Aus
      * Internprogramm Aus
      * Signalgeber Aus

 - Verbesserung bei der Erkennung von doppelten Namen von Meldern und Bereichen im 
   StartparametersEditor.
   Hinweis: Bitte führen Sie vor der Veröffentlichung einer Konfiguration immer eine
   Überprüfung auf "Doppelte Namen" in RPS for MAP durch.

 - Area State Refresh:
   Neuer Parameter zur automatischen Aktualisierung des Zustands "Scharfschaltebereitschaft"
   von Bereichen im StartparametersEditor durch die Implementierung eines konfigurierbaren
   Polling Mechanismus.
   Default = 20 Sek. Bei Bedarf kann diese Zeit für jeden einzelnen Bereich individuell
   modifiziert werden.

 - Probleme bei der Darstellung der Internprogrammzustände sind behoben. Die Zustände 
   werden nun richtig angezeigt.

 - Alarme, die während einer Verbindungsunterbrechung auftreten, werden nach Wiederherstellung
   der Verbindung an der BIS angezeigt.


Änderungen MAPOPCServer 1.3.9 gegenüber 1.3.3
---------------------------------------------

- OPC Core Components 3.0 und .Net Framework V4.0 oder höher erforderlich. 
  Bitte überprüfen Sie die Versionen vor der Installation des OPCServers.

- Datei "Startparameters.xml" als Vorlage:
  Durch Ergänzung des Dateinamens "Startparameters.xml" mit .OLD/.DE/.EN steht diese nun 
  als Vorlage zur Verfügung.
  Zur Auswahl der gewünschten Vorlage benennen Sie diese wieder in folgendes Format um:

  -> Startparameters.xml

  Vorlage "Startparameters.xml.old":
  ----------------------------------
  Diese Vorlage entspricht der bisherigen Startparameter.xml
  Es wurden einige Standardwerte von Zustanden (LZs) geändert. Bitte überprüfen Sie die 
  LZs bei Update des OPCServers.

  |  Name                        | LZ alt | LZ neu |
  --------------------------------------------------
  |  Normal                      |   271  |     5  |
  |  Disarmed                    |     5  |  2011  |
  |  Duress                      |  1526  |    86  |
  |  Armed                       |  2211  |  2010  |
  |  Fault                       |   274  |    12  |
  |  Tamper internal             |  4061  |    19  |
  |  Bypass                      |  5000  |     3  |
  |  Disabled                    |  5003  |    31  |
  |  Verification                |  5001  |    30  |

  -> Verwenden Sie diese Vorlage für Updates älterer MAPOPC-Server-Versionen oder bei 
     Neuinstallationen des OPC´s auf einer BIS V3.0 oder älter.

  Vorlage "Startparameters.xml.DE" und "Startparameters.xml.EN":
  --------------------------------------------------------------
  Diese beiden neuen Vorlagen beinhalten deutsche oder englische Begriffe und Kommandos
  sowie neue Standardwerte für die Zustände, passend für BIS ab Version 4.0.

  -> Verwenden Sie diese Vorlagen nur bei Neuinstallationen mit BIS ab Version 4.0. 

  |  Vorlage                     | Sprache | Unterstützt von BIS Version
  ----------------------------------------------------------------------
  |  Startparameters.xml.old     |   EN    |       V3.0 und älter
  |  Startparameters.xml.de      |   DE    |       V4.0 und höher
  |  Startparameters.xml.en      |   EN    |       V4.0 und höher

- Die DA-Funktionalität für OPC Clients ist nun parametrierbar.

- Unterstützung des Meldungstyps "Überfall (kein stiller Alarm)". 

- Änderung der Validierung der "Config Directory"-Angabe im Panels Tab beim Abspeichern:
     * existiert das angegebene Verzeichnis nicht (String.Empty, Null oder nicht existent)
       wird das aktuelle Assembly-Verzeichnis genommen (wie bisher)
     * der Textboxinhalt wird ggf neu gesetzt (geändert)
     * existiert dann in diesem Verzeichnis die Datei "ld_all_cfg_001.xml" ist alles OK 
       (geändert, bisher wurde nur auf das Vorhandensein des Verzeichnisses geprüft)
     * falls nicht, wird das Panel zu der Liste der fehlerhaften Panels (List<Panel>) 
       hinzugefügt (wie bisher)
     * weitere Verarbeitung, Anzeige einer Fehlermeldung der "fehlerhaften" Panels. 
       (wie bisher)

- Begrenzung der Log-Datei-Einstellungen, so dass keine zu großen log-Dateien entstehen 
  (sowohl COMM Service, als auch OPC Server). Es werden nun maximal 10 Logdateien mit 
  je 5 MB geschrieben.

- Führt der LSN Ring über mehrere Bereiche, wird bei einem Ringfehler die Sabotagemeldung 
  abhängig vom scharf/unscharf Zustand des jeweiligen Bereiches erzeugt.

- Verbesserung der Störungsbehandlung bei Verbindungsabbrüchen.

- Fehlerbehebung bei der Registrierung des OPCServers während der Installation.

- Fehlerbehebung für die Anzeige des "ReadyToArmState". Bei DA-Nutzung blieb dieser Wert 
  unverändert.

- Behebung des Problems bei gleichen Namen für "Area" und "Melder". Es erfolgt nun ein 
  Eintrag in der Datei "Problems.txt".

- Anpassung des LSN GW Gerätenamens "Loop" bei flachem Namensraum (der Name "Loop" wird
  mit dem Namen der Area ergänzt), um doppelte Namen zu vermeiden.

- Aktualisierung der OPCServerFramework Version, um Fehler mit ungültigem OPCServer Namen
  zu beheben.


Änderungen MAPOPCServer 1.3.3 gegenüber 1.3.1
---------------------------------------------

- BSI konforme Prüfung des Zentralenschlüssels. Bei jedem Verbindungaufbau prüft der
  OPC den RSA-Fingerprint der Zentrale.


Änderungen MAPOPCServer 1.3.1 gegenüber 1.3.0
---------------------------------------------

- Die Einstellung des flachen Namesraumes ist wieder möglich

- Der Zustände des Riegelkontaktes werden statt der Werte 506 und 507 jetzt mit 
  5 und 2011 gemeldet. Diese Änderung ist nur eine Änderung der Defaultwerte in der
  Startparameters.xml


Änderungen MAPOPCServer 1.3.0 gegenüber 1.2.1
---------------------------------------------

- Implementierung einer Action-Queue, in der alle Telegramme an die Zentrale eingetragen
  werden.

- Die Verwendung der Queue kann über einen Parameter gesteuert werden

- Duplikate für RefreshRequests werden in die Action-Queue nicht eingetragen

- Die Abfrage PanelRefreshRequest kann über einen Parameter gesteuert werden. Entweder 
  wird nur eine Refreshanfrage für die gesamte Zentrale gesendet oder für jede einzelne
  Komponente der Zentrale.

- BIS erhält den Status BUSY, wenn das aktuell zu bearbeitende Telegramm länger als eine
  einstellbare Zeit in der Queue auf die Abarbeitung gewartet hat.

- Der Status BUSY wird zurückgesetzt, wenn die Verweildauer der aktuellen Aktion kleiner
  einer einstellbaren Zeit ist.

- Änderungen im Startparameter-Editor, damit die Einstellungen auch aus der XML-Datei 
  gelesen bzw. in die Datei geschrieben werden.

- Bevor ein Telegramm und die Zentrale gesendet wird, erfolgt eine Überprüfung (einstellbar),
  ob die Zentrale gerade beschäftigt ist.
     * Ist die Zentrale gerade beschäftigt, wird nach einer kurzen Wartezeit die 
       Überprüfung noch einmal durchgeführt.
     * Kommt nach einer Definierten Zeit noch keine Rückmeldung zu dieser Überprüfung,
       wird sie erneut durchgeführt.
     * Ist die Zentrale nicht beschäftig, wird das anstehende Telegramm bearbeitet.

- Neues Telegramm PanelRefreshRequest implementiert.


Änderungen MAPOPCServer 1.2.1 gegenüber 1.1.0
---------------------------------------------

- Unterstützung für virtuelle Melder, virtuelle Ausgänge und virtuelle Schlüssel-
  schalter

- Neue Zustände "deaktiviert" und "Störung und deaktiviert" für das Bedienteil

- Neuer Meldertyp "Feuer" mit neuen Zuständen "Feuer intern" und "Feuer extern" 


Änderungen MAPOPCServer 1.1.0 gegenüber 1.0.7
---------------------------------------------

- Einbau der Möglichkeit der hierarchischen Darstellung der Melder in Bereichen.
  Konfiguriert wird das über den StartparameterEditor.

- Erweiterung um OPC AE Funktionalität

- Auslagerung der Parametrierung von den MAP cfg-Dateien in die eigene 
  Startparameters.xml (mit nur den notwendigen Informationen)

- Konfigurierbarkeit der hierarchischen Darstellung über den StartparameterEditor
  möglich

- Erweiterung des StartparameterEditors um Einstellung der Anzahl der Wiederholungen,
  bis P4 auf Panel Adresse geschickt wird

- Überarbeitung des Loggings und Ermöglichung der Änderung der Loggingkonfiguration
  zur Laufzeit

- Windows7 x86 und x64 Fähigkeit


Änderungen MAPOPCserver 1.0.6 gegenüber 1.0.7
---------------------------------------------

- SystemDevices um den erlaubten Status "Störung" erweitert.

- Fehlerbehebung für Überfall Status. Dieser wird nun immer auf Überfall gesetzt


Änderungen MAPOPCServer 1.0.5 gegenüber 1.0.6
---------------------------------------------

- Bei einem Extern-Alarm von einer "Einbruch 24 Std."-Linie wird ein zweites Mal überprüft,
  ob der Bereich scharf ist oder nicht. Falls der Bereich unscharf ist, wird der Alarm nur 
  als Intern Alarm gemeldet.

- Adressen behalten nach einem Refresh den Zustand "Sperre" oder "Abschaltung". 

- Ein Bedrohungsalarm vom Bedienteil wird an der BIS manchmal nicht angezeigt. Grund dafür 
  ist, da die Ruhemeldung so schnell nach der Alarmmeldung kommt und dies mit einem
  DA-OPCServer nicht behandelt werden kann.
  
- Einträge in den Log-Dateien reduziert. 


Änderungen MAPOPCServer 1.0.5 gegenüber 1.0.4
---------------------------------------------

- SetTime Methode setzt bei einen gegeben Wert von "00:00:00" automatisch das aktuelle 
  Datum und die aktuelle Uhrzeit auf der MAP

- Melder behalten den Status, der anlag auch nach einem Refresh und gehen nicht nur in 
  'Active'. Bei scharfem Bereich bleibt ein Externalarm bestehen, bei unscharfem Bereich
  und einem scharfen Internprogramm bleibt der Internalarm bestehen. Bei allem unscharf 
  steht ein 'Aktiv' an.

- Ein Disconnect führt noch nicht sofort zu einer Meldung innerhalb der BIS, sondern wird
  erst nach einer bestimmten Anzahl an Wiederholungen an die BIS gemeldet


Änderungen MAPOPCServer 1.0.4 gegenüber 1.0.3
---------------------------------------------

- Internprogramme werden nun richtig gesetzt (ODER-Verknüpfung der Stati bei 
  AreaStatusReceived)

- Die Fehlerbehandlung wurde nochmals verbessert, so dass die Verbindung nur noch dann
  getrennt wird, wenn eine Verbindung mit der MAP nicht möglich ist.


Änderungen MAPOPCServer 1.03 gegenüber 1.00
-------------------------------------------

- Durchgängige Fehlerbehandlung in der StateMachine, so dass kein Fehler in der 
  StateMachine mehr zum Abbruch des Programms führt (EventListener bricht nicht mehr ab)

- AntiMask Status Behandlung ergänzt und Status selbst hinzugefügt

- Melder behalten den Status Active, wenn eine Meldung angelegen hat, auch weiterhin, 
  solange der Status noch nicht zurückgesetzt wurde.


+++ Ende des Dokuments +++

