_readme.cpp

mod_RSsim

/////////////////////////////////////////////////////////////////////////////
//
// FILE: README.cpp
//
// Code is: (c) Adroit Technologies (Pty) Ltd. 1993,2000
//
// AUTHOR:
// Conrad Braam
// In the words of Paul DiLascia: If this code works, it was 
// written by Conrad Braam.
// If not, I don't know who wrote it.
// Compiles with Visual C++ 6.0, and runs on NT4, Windows 2000, XP, 98b and probably 95 too.
//
// LIMITATIONS:
// Not all of this code is production code, and as such is not fully tested. 
// Use at own risk.
//
// PURPOSE:
// This simulator was written to allow the testing of a MODBUS RTU driver without
// having to get 256 little MODBUS PLC's into one office. It is not by any means 
// a full implementation of the protocol, implementing only the common functions
// used in MODBUS. This simulator actually originated on Windows SocketsAPI, for 
// the Texas Instruments protcol, but that is another story. It surpasses 
// limitations in other programs we have found in the past by:
// 1. Allowing to simulate more than one RTU at once.
// 2. Allowing the editing+display of all the Registers 
// 3. Allowing the scanning of registers not actually in the display.
// Missing:
// 1. running on >1 comm ports, (you have to run 2.. coppies of the program)
// 2. ASCII protocol support
// 3. Display statuses for all outstations simulated.
//
// MORE:
// I am a programmer at Adroit Technologies
// This program is not a released work, and can be freely distributed, so 
// long as this headder is immortalized. (I.e. After I die, any copies of this 
// must still hold my name.)
// Visit the place I work at "http://www.adroitscada.com", or mail me at 
// [e-mail] . I dig the code that Paul DiLascia writes.
//
//
// PROGRAM STRUCTURE:
// By way of a class diagram, the program is based on a Dialog app.
// Diagram symbols used :
// *=many
// o=encapculate
// %=derived from; <> indicates direction
//
// CWinApp %< CMOD_simApp                     ;application object
// CDialog %< CMOD_simDlg                     ;main window
//                        o> CResizer         ;window resizing
//                        o> CServerRS232Array *> CMODRS232CommsProcessor %> CRS232Port
//                                                                        o> CRS232Noise
//                        o> CServerSockArray *> CMODEthCommsProcessor %> CDDKServSocket %> CDDKSocket
//                                                                     o> CRS232Noise
//                        o> CServerRS232Array *> CAB232CommsProcessor %> CPLCApplication %> CABCommsProcessor %> CCommsProcessor %> CRS232Port
//                                                                                                                                o> CRS232Noise
//
//                        o> CControllerMemory *> CControllerMemoryArea *> WORD
// CDialog %< CAboutDlg                                        ; application about window
//                      o> CEasterDlg                          ; Easter egg
//                                    o> CStarWarsCtrl %> CStatic
// CStatic %< CStaticLink                                      ; click-able web URL link
// CButton %< CMicroTick                                       ; clickable colored tick-box
// CMemWriteLock %< CSingleLock                                ; Mutex to control PLC RAM accesses
// CButton %< CCommsLamp                                       ; activity indicator LED
// CListCtrl %< CMemoryEditorList                              ; list-control for registers
// CObject %< DRegKey                                          ; registry class
// CComboBox %< CColorPickerCB                                 ; combo list of colors
// CObject %< CMODMessage                                      ; telegram parsing/building class
// CObject %< CRS232Noise                                      ; comms fault simulator
//
/////////////////////////////////////////////////////////////////////////////////////
//
// REVISIONS:
// Version 2.3b    xx/xx/xx   CDB Initial rev submitted to site
// Version 2.4     22/07/02   CDB Fixed and support Fn 10h and 15h (Write multiple 
//                            register/extended registers)
// Version 2.5     28/07/02   CDB conditional compilation macros _COMMS_DEBUGGING and
//                            _UI_DEBUGGING added, specify in build options to enable 
//                            more debugg'n messages. Display of data and addresses 
//                            format is selectable now.
// Version 2.6     29/07/02   CDB Reading digital I/O showed me a bug where the
//                            CMODCommsProcessor was reading the wrong address, see 
//                            UnPackField()
// Version 2.8     07/08/02   CDB Web-link to modicon.com. Tooltips added. Also allow 
//                            64K registers instead of 9999 (10K) uses more RAM now.
//                            Window "stay-on-top" added.
// Version 2.9     14/08/02   CDB Tooltips work in all dialogs except value edit dialog.
//                            This dialog still has some bugs in it.
// Version 3.1     27/10/02   CDB Devices can all start "off", regsiters can load at start-up.
//                            EasterEgg added to "About" box.
// Version 3.2     02/11/02   HF : (Hirofumi Fudoudou) Hirofumi Fudoudou's changes added
//                            CDB : Easter-credits updated
// Version 3.3     08/11/02   submitted by HF : Integrated transparency index bitmap fixes. PLC write 
//                            address returned in telegram corrected too.
// Version 3.4     11/11/02   CDB : Function 05 (write single coil) is now supported and tested.
// Version 3.4a    12/11/02   CDB : remember the register area type between load-ups
// Version 3.4b    21/11/02   CDB : Can now set upper limit to # registers.
// Version 3.4c    25/11/02   CDB : Write multiple coils 0F is supported now, # registers 
//                                  per req. is settable too.
//         3.4d    27/11/02   CDB : RTS can now be set for enable/dis/h-shake/toggle.
// version 3.5     18/12/02   CDB +AP : Renamed the MODCommsProcessor class to CMODCommsProcessor
//                            (羖varo Palma) Fixed the read-ahead length calculation. 
//                 20/01/03   CDB focus rectangle for the tick-boxes added, tab order here fixed too.
// version 3.6     23/01/03   CDB Keyboard only friendly hotkeys added to get to the other dialogs.
//                            [duplicate toolbar]
// version 4.0     22/03/03   CDB station activity indicators all accessible now, comms analyser 
//                            screen added. CMicroTick over-painting of parent Wnd by 1 pixel fixed.
//                            Class headder files tidied up. Registers list redraw &CPU load when 
//                            doing writes reduced.
// Version 4.1     24/03/03   CDB Option so that coils modify before the response is sent- see eMulation 
//                            dialog
// Version 4.2     02/04/03   CDB Emulations settings 'tick boxes' update the comms class, new tick 
//                            for disallowing writes to PLC memory.
// Version 4.3     04/04/03   CDB If scrolling thru stations, the comms engine was fetching the wrong 
//                            station enabled tickbox to see if it was enabled.
// Version 4.4     11/04/03   CDB dialog can now be re-sized, thanks to CResizer class by Dmitry Kochin 
//                            <[e-mail]>
// Version 5.0     02/05/03   CDB Merged Ethernet TCP functions into the sim/ Added training simulation.
// Version 5.1     05/05/03   CDB Splash screen- Training sim bugs sorted out.
// Version 5.2     XX/XX/XX   CDB Added tooltips support for diabled controls to trainer dialog 
//                            Ray Almog [[e-mail]] from - http://www.codeguru.com/controls/tooltip_for_disabled_control.shtml
// Version 5.3     15/05/03   CDB Icon for application changes from Modbus Ethernet to Serial.
//                            <ENTER> key trapped in main dialog.
// Version 6.0     20/05/03   CDB Allen-Bradley DF1 protocol added
// Version 6.1     09/06/03   CDB BCC and CRC option on Allen-Bradley added
// Version 6.2     24/06/03   CDB Modbus RS232 disabled station stations no longer respond as it should be.
//         6.3     06/07/03   CDB debugger screen data was not hex coded correctly, Eth. message frame trans # bytes are handled correctly too.
//                            fault reported by BMG  
// Version 6.4     28/08/03   CDB When funny chars come in on serial, we sometimes had crashes, if port settings are invalid, there 
//                            is now a warning messagebox!
//         6.5     08/09/03   Time license + : Patrick SOFORCADA fixed length calc. for force multiple coils - [e-mail]/ calculate
//         6.6     08/10/03   CDB Help updated, Joy protocol seriously tweaked, new setup dialog for joy
//         6.7     16/10/03   CDB Modbus Ethernet - COMMS screen error message if station ID not active.
// Submitted 6.7 to [e-mail] on 21/10/03
//         6.8     26/10/03   CDB Splash is now "programmed" in text-format, About text changed a bit+ mouse cursor over 
//                            links fixed.
//         6.9     06/12/03   CDB still need to sort out write multiple coils when writting 16. modem status lights added.
//         7.0     14/12/03   CDB cleaned up include statements; multiple stations have seperate modbus RTU registers. 
//                            write multiple coils fixed; Ctrl-J injects random char.
//         7.1     06/08/04   CDB Digital items now display with a darker background when "on" '1' to make them easier to spot.
//                            requested by Canada customer
//         7.2     30/10/04   CDB you can now specify a # of bits that is not a multiple of 16 for modbus coils and relays (in fact any bit-area)
//         7.3     29/10/06   CDB toolbar bn to open/close port
//         7.4     22/01/07   CDB Write multiple coils wrote one too many, fixed. (reported by [e-mail])
//         7.4b               Write single coil was dividing the returned coil address by 2, fixed now too
//                            __TEST_INJECTMSG macro added to allow testing of any message
// TODO: telegram Data to have spaces between bytes 00 00 00
// TODO: Settable timout for 'lost' tcp client socket recovery
//
/////////////////////////////////////////////////////////////////////////////

#include "stdafx.h"  // ha ha

const CHAR lpsMyAppVersion[10] = "7.4b\0";