Home

M-Bus Application Manual (English)

1. M Bus Application Version 1 29 The selection is always done with a mode 1 LSB first telegram with CI 52 f customers 3453F4509384 hexedecimal Mode 2 and older selection telegrams CI 51 55 or 56 Rasam 3496059064FF hexadecimal are not supported S The slave list contains all slaves already found on the bus The s ave list is updated every time you do a slave search or a REQ UD2 Use the context menu right click the slave list to clear the slave list or to invoke the Show Slave List dialog see 2 2 2 6 Depending on the selection mode the list shows the primary address device ID manufacturer generation and medium standard selection or sub eae eal the customer number and address customer selection The slave 585858588888 111111111111 001 123456 9 list 1s cleared by starting a slave search if the respective option ee see 2 2 3 2 is selected You can easily address a slave by selecting it from the s ave list and press Slave Select The primary address field is automatically set to 253 and a slection telegram for selecting the chosen slave is sent Remember that the primary address is automatically changed to 253 2 1 3 Serial Port Section In M Bus Application you are able to predefine four sets of serial port communication parameters By simply selecting one of the four settings you can change the communication parameters Press Parameter to invoke the COM Parameters dialog see 2 2 3 5 for changing
2. Size of Data Record List Window You can enter the size of the data record list on the main window in screen units Values between 10 and 1000 units are valid default is 65 units The transaction tracking list is automatically resized The reset button sets the size to 65 units default It is also possible to resize the lists with the slider Options gt List Resizing Slider Only VIF Units without multiplier If you check this option all VIFs containing a multiplier are replaced by VIFs without multiplier The value is recalculated accordingly e g 3244 Energy 100 Wh will be replaced by 324400 Energy Wh This feature is not working with VIFs from table FB with an index smaller 50 decimal If this option is not checked all VIFs are returned as they are Automatic PRIOS Decryption Telegrams with PRIOS encryption can be automatically decrypted if either the standard key option is chosen or a specific decryption key is entered DES Key Some meters on the market deliver their data only in encrypted form If you enter a DES key different from FFFFFFFFFFFFFFFF the automatic DES decryption CPB mode is enabled If a device with DES encryption is read out the data is automatically decrypted to M Bus form If the DES key is set to FFFFFFFFFFFFFFFF the automatic DES decryption is disabled Automatic AES128 Decryption Telegrams with AES128 encryption can be automatically decrypted if the automatic AES128 decrypt
3. 2 1 Main Window Repeat Count Context Help Main Menu CI Field DIF Field Primary Address Command List Action Buttons Output Field Output List Transmission Tracking List Value Type List Secondary Addressing Value Entry Field Slave List lt MDus Mm x File Mode Tools BPptions elp K7 1 Device ID Ge Me C 0 38400 z FFFFFFFF FFF FF FF Com281E3 s Il I Cl 51 Fabrication C1 9600 BRT Com2 8 1 E 3 DIF Iv OF T CustomerA C2 2400 sy 2545 HEX F CustomerN Com2 8 1 E3 lt No predefined command gt z lt All slaves gt fg 300 Com2 8 1 E 3 SND_NKE SND_UD REQ_UD1 BEGQ_UD2 Slave Select Slave Searc C 4COM Ott 5 REQ_UD2 6 SND_UDL Parameter t Tariff Storage Data Value Funct VIB RC Request Answer Serial Port Parameter List Resizing Slider A screenshot of the main window after installation and execution of M Bus Application is shown above There are mainly seven different sections Theses sections are described in detail in the next chapters Main Menu see 2 2 Data Input Section upper left section including Cl Field DIF Field Primary Address see 2 1 1 Secondary Addressing Section upper middle section including Slave List see 2 1 2 Serial Port Section upper right section see 2 1 3 2 2 3 5 Action Buttons middle see 2 1 4 Output Section lower middle including Output Field a
4. FC reset R UD Choose FCB toggle FCB toggle REQ UD language of VIF ee NEER C FCB inverted C ECB FCB option for f English C FCB set FCB set outgoing and VIFE C German a G FC et FCB reset telegrams Slave search Slave Search Slave Select SND UD option e Primary Address Search Cl 52H FCB Address 255 FCB FCV CI Field for lv Secondary Address Search lv FCB FCV reset for address 255 Gac opuon for Slave Search Slave List Size of Datarecord List Window address 255 Check if Slave IV Reset slave list before slave search 106 24 Sgreen Units Reset Set si f List should be donasi g cleared before Automatic Requests Automatic PRIOS Decryption Output List and a slave search e Automatic REQ_UD1 on ACD Y NoPRIOS C PRIOS standard Transmission Automatic Ie Automatic REQ_UD2 on DIF 1F PRIOS key Trackin g List request Only VIF Units whithout multiplier Automatic DES Decryption e Deciphering of options e VIF Units without multiplier DES Key FFFFFFFFFFFFFFFF PRIOS VIF Units VIF Ox7C Interpretation VIF in string Automatic 4ES128 Decryption N telegrams without Alternate VIF 0x7C Interpretation Enable automatic AES 128 decryption Ge of heels telegrams multiplier FFFFFFFFFFFFPPRREEFFFFFFFFFFFFFF dran Standard or Deciphering of AES128 telegrams alternate string VIF decoding Cancel Help Value field in data records with error VIFE Check this option if a value follows a slave record error VIFE Do no
5. Send Remove Again Save Cancel specified time is Count Type l Description 1 SND_NK 2 REQ_U reached NN Discard changes Save changes Assign often The dialog is divided into several functional groups e Data All data you need with one of the M Bus script lines are entered here Not all M Bus script lines need all of the data displayed here therefore look at the M Bus actions below for which parameter is needed The primary M Bus address Adresses 0 255 are the standard M Bus address addresses 256 257 and 258 have a special meaning see also 2 2 2 6 e 256 repeats the M Bus script line for all slaves in the slave list using primary addressing e 257 repeats the M Bus script line for all slaves in the slave list using standard secondary adressing e 258 repeats the M Bus script line for all slaves in the slave list using customer secondary addressing The CI field Any parameter or command used in conjunction with SND UD Predefined commands see 2 2 2 2 Adressing mode primary secondary or customer press the checkbox to toggle between the different options Device ID manufacturer generation and medium for standard secondary addressing or number and address for customer secondary addressing or nothing for primary addressing e Actions There are several M Bus related actions you can put in a script line For a better explanation of each action see 2 1 4 16 SND_UD sends a SND_UD to the slave You have to fil
6. 3 If you increase DT to much because the echo is still received in front of the answer telegram it might work for slaves answering rather slow However for slaves answering very quickly the first bytes of the answer telegram could be suppressed Another problem arises due to the fact that most serial ports UARTs in PC computer systems are buffered The intention of the so called FIFO is to buffer more than one received byte therefore the operating system does not have to check the serial input too often However while using the buffer the time each byte is received is no longer recognized by the operating system and the TB timeout time can not be checked correctly You have to perform a more relaxed TB timeout checking or switch the FIFO off to be as close to the M Bus timeout demands as possible To switch off the FIFO you have to do the following l From the taskbar choose SZART gt Settings gt Control Panel gt System gt Devices gt COM gt Settings gt Extended 2 Switch off the FIFO buffer using the checkbox or slide the receive and transmit buffer settings to lowest 28 M Bus Application Version 1 29 4 Using M Bus Command Lists M Bus Command Lists are useful for predefining master to slave commands like standard M Bus commands change baudrate or slave specific commands clear readout list set date and time Instead of entering all data records in a hexadecimal form the data records are predefined and only the value
7. M Bus Application installation CD ROM into your CD ROM drive 2 If the autostart feature 1s enabled the installation program starts immediately If not you have to execute MBSETUP EXE in the top level directory of the CD ROM e g from the Task Bar press Start gt Execute and type d mbsetup exe replace d with the drivename of your CD ROM 3 Choose the installation path and press Next 4 Choose whether you want to install M Bus Application with english or german help files the program itself is only available in English and press Next 5 Press Finish to exit the installation 6 To execute M Bus Application press Start gt Programs from the Task Bar and select M Bus Application For de installing M Bus Application do the following steps From the Task Bar press Start gt Settings gt Control Panel and execute Software Select M Bus Application from the upcoming list and press Add Remove Confirm the de installation of M Bus Application After the de installation program has finished press OK All M Bus Application related files and registry entries are now removed from your system oe I 1 2 Manuals This document in english and german is also available on the installation CD ROM It will not be copied to your harddisk during installation The following documents are available replace d with the drive name of your CD ROM e d docu english MBusApp pdf english manual in Acrobat Reader Format e d d
8. M Bus slave It answers to M Bus requests according to its settings see 2 2 3 4 Slave Mode Properties In M Bus Slave mode all buttons and menus are disabled since the M Bus slave is a passive device which only answers to master requests If M Bus Slave mode is selected the Eile Mode Tools Options Help e M Dus Master E M Bus Slave M Bus CPUR epeater Options Help eA ll lI Z HEX Password Cancel picture on the main window changes as shown on the left To leave the slave mode you have to press the Break button In M Bus Slave mode the active COM parameter settings are used The current baudrate can be changed with the standard M Bus baudrate commands CI B8H BFH Since the slave mode runs on a non real time operating system it is possible that the maximum allowed M Bus timeouts can not be granted This depends on your computer and the workload it has to work off Therefore you may have to increase the timeout time while requesting M Bus Application in M Bus Slave mode To exit M Bus Application it has to be in M Bus Master mode otherwise the exit button will not work The M Bus CPURepeater mode is for a special M Bus master device called CPU Repeater or Homecentral If you select this mode you have to enter the CPURepeater s password If the password was correct you are attached to the CPURepeater and you can use all functions of M Bus Application as you would do in M Bus Ma
9. Secondary Addressing Section The Secondary Addressing Section is used to select slaves There are several ways to slect a slave M Bus standard secondary selection The standard selection uses the Device pp ID manufacturer code Man generation number Ge and the medium Me aap Ta aT 23 Fill in the appropriate entry fields and press Slave Select to select a slave If you L Fabrication do not want to fill in all entries you may mask out certain nibbles 4 bit of the e secondary address with a wildcard F All entries are hexadecimal except Tess T 2 Device ID which is a BCD value The checkboxes in front of Fabrication CustomerA and CustomerN are deselected M Bus standard secondary selection with fabrication number This is the maeb w ae same as above but an addtional data record with the fabrication number is also f 2134234F f 3423 f 23 f 23 sent with the selection telegram Select the checkbox in front of Fabrication and Febiestion cicada another entry field for the fabrication number appears The checkboxes in front meet of CustomerA and CustomerN are deselected T aiaee sd M Bus customer selection with customer number and or customer address If you select one or both checkboxes in front of CustomerA or CustomerN all standard secondary selection related entries are disappearing Therefore the customer address CustomerA and or the customer number CustomerN are solely used for addressing a slave
10. UARTs see High Speed option below Recommended M Bus baudrates are 300 2400 9600 and 38400 baud e Databits Selects the number of databits per byte 5 6 7 and 8 databits per byte are available M Bus default 8 databits e Stopbits Selects the number of stopbits per byte 1 1 5 and 2 stopbits are possible 1 5 stopbits is not available on some systems M Bus default 1 stopbit e Parity Setting Selects the parity setting Available settings are Parity off Parity even and Parity odd M Bus default Parity even e RTS option Selects how the RTS line of the serial COM port is controlled Available options are Reset Set Handshake and Toggle M Bus default Reset e Handshake The RTS line is set if the UART input buffer is less than half full The RTS line is reset if the UART input buffer is more then three quarters full e Toggle The RTS line is set if there are bytes to transmit in the UARTs transmit buffer The RTS line is reset if there are no bytes to transmit e DTR option Selects how the DTR line of the serial COM port is controlled Available options are Reset Set and Handshake M Bus default Reset e Timeout TA Selects the maximum allowed time between sending a request and receiving an answer telegram in bittimes M Bus default 330 bittimes see 3 for more details about M Bus timeouts e Timeout TO Selects an offset to the TA timout in milliseconds The tolerable time between a request and an answer is therefore TA
11. any other column and select Show Buffer from the context menu You may also double click the Transmission Tracking List or the Output List to invoke the Show Buffer dialog Corresponds with the count column in the Transmission Tracking List Request in K Show Buffers equest Resize window P ss cose text form H l KE UD C B A FD Request in hexadecimal form Answer in text form telegram Answer ong C 08 A 01 Cl 72 12345678 RAC 02 Heat_inlet 01 00 0000 2 DRs header Data records of answer telegram in text form Answer in hexadecimal form Start of the next datarecord 2 2 Main Menu 10 U U U bo UU 11 cogogaooood Inst Value Funct VIB Customer Location Customer PAE ZAE E Fi 34 12 23 d UZ UC 0 00 g E F 1i 1 The main menu contains the selection File Mode Tools Options and Help The only selection under File is Exit for leaving the program You can also leave the program by pressing ALT F4 or clicking the right most window button in the title bar M Bus Application Version 1 29 9 2 2 1 Mode There are three modes you can use in M Bus Application M Bus Master M Bus Slave and M Bus CPURepeater In M Bus Master mode the program initates M Bus requests and readouts M Bus slaves This is the main purpose of the program therefore this mode is described in detail later In M Bus Slave mode however the program simulates a
12. bittime TO milliseconds M Bus default 50 milliseconds see 3 for more details about M Bus timeouts 26 M Bus Application Version 1 29 Timeout TB This is the maximum allowed time between receiving two bytes of an answer telegram before the end of a telegram is recognized M Bus default 4 bittimes see 3 for more details about M Bus timeouts Deadtime DT This is the time in bittimes from the end of the last byte sent to the time the program opens its receive channel All bytes received before opening the receive channel are rejected This option is used to cancel echoes on the transmission lines M Bus default 11 bittimes see 3 for more details about M Bus timeouts Timeout Mode There are three different timeout modes available M Bus default Part Wait see 3 for more details about M Bus timeouts e No Wait After recognizing the end of an answer telegram the program will not wait for another telegram even if there is timeout time left e Full Wait The program will always wait the full TA TO time e Part Wait After receiving an answer telegram the program will only wait TA bittimes counted from the first byte of the answer telegram for another telegram recommended setting Retries Maximum number of retries until a request is cancelled M Bus default 3 UART FIFO If the UART of the computer system has an internal FIFO or not The operating system checks less often for new bytes if the FIFO is on and in use Therefore the
13. cusor never changed back to arrow e 1 03 Windows NT timing bugs also fixed for ListenOnly e 1 04 M Bus option Only VIFs without multiplier added see 2 2 3 2 e 1 05 M Bus VIF table corrected variable protocol VIF 08H 0FH DIF with variable length added DIF 0DH Column RC retry count added between request answer and date in data export file Script bug fixed if a script line with special address 256 257 or 258 was inserted immediatly behind another script line with special address the script was not executed correctly e 1 06 M Bus option Slave Search CI Field added see 2 2 3 2 Bug in secondary address slave search corrected e 1 07 If a collision appears during a secondary address slavesearch a 100 ms delay is inserted in front of the next request e 1 08 M Bus slave mode added The fabrication number is now correctly inserted into the slave list if the RSP UD answer of the slave contains a datarecord with the fabrication number e 1 10 Remote connection modem support added Minor bug in Edit Script dialog fixed e 1 11 MSB and LSB were mixed up during slave select in M Bus slave mode VIF values without multiplier contained a bug when receiving a BCD value e 1 12 Implementation of HEX characters in BCD values as proposed by the M Bus working group Note combination of HEX characters 0xDx are not supported e 1 13 Implementation of CPU Repeater Mode and CPU Repeater slav
14. f2400 bd gt from a CPURepeater medium of the slave l Add Remove Update arpe Rea Load slave list from a Use the contents of file the entry fields to fn Ge Medium Baud l BAC 1 07 2 Save slave list to a file create a new slave list UNI 02 3 entry Insert all the slaves from the main slave list Remove a slave from the list Change a slave list entry Save Get Close Help e To manually add a new slave to the list fill in the entry fields for the primary address PAdr the device ID the manufacturer code Man the generation Ge the medium and select the baudrate with which to read out the slave Press Add after all entries are made e To remove a slave from the list click on the primary address of the slave you want to remove first column of the list and press Remove e To change the data of an existing slave select the respective slave by clicking its primary address first column of the list Change the entry fields as appropriate and press Update afterwards e To write the slave list to a CPURepeater press Write Remember that you must be in M Bus CPURepeater mode for reading or writing the slave list e To read the slave list of a CPURepeater press Read Remember that you must be in M Bus CPURepeater mode for reading or writing the slave list e Using Load and Save you can save a slave list to a file and read it again e The Get button adds all the devices in the main slave list see 2 2 2 6 to the CP
15. if any is entered before you send the data records to the slave The following parapraph contains a step by step instruction on how to create a M Bus Command Lists with all baudrate change commands Edit Command Lists Ed BAUDRATES selected Entry Description Cl Field Expected Value None Data Record Dialog OIB B Description Baudrate 300 Bo Mone Baudrate 2400 BE Mone Baudrate 9600 BO Mone From the main menu select Tools gt Command Lists Press New Press Add Enter the description Baudrate 300 Enter Cl Field B9 Clear DIB VIB Expected Value is None Press Update 9 Press Add 10 Enter the description Baudrate 2400 11 Enter Cl Field BB 12 Clear DIB VIB 13 Expected Value is None 14 Press Update 15 Repeat step 4 to 8 until all baudrates are entered S T ae ee lt hlo nredefined command ri Jo pre define d command gt E lt Data record dialog Baudrate 300 Baudrate 2400 16 Press Save 17 Enter a unique name e g Baudrates Baudrate 3600 18 Press Save 19 Activate the command list Baudrates ee a PL KP L 20 Press OK 21 Select the baudrate command from the Command List of the main window 22 Enter the correct primary address and press SND UD Remember You have to press Update if you want to take the changes made M Bus Application Version 1 29 29 5 Using M Bus Scripts M Bus Scripts are useful if you have to
16. lines 17 M Bus SCDS sese e eee 7 M Bus Scripts 15 30 33 M Bus Slave CPURepeater I Fea ahem ee ere 10 M Bus Slave Mode 10 M Bus Timeouts 28 fe one ene ERE as E EE oe 6 NICO TT 18 Neda eho eek 6 16 Mode chess e NAR 9 10 Mode Genoa eee ner ee ene are 7 Mode eaa 7 Optical Synchronisation 31 ODUIONS sexs 29 yaer 04202 9 22 UOUpIO NSVYHC sees eee 31 Output Field 00008 5 Output E 5 8 Output Section 5 8 PORE 7 Parity Serg eaei nueina 26 Predefined Command 16 Primary Address 5 6 16 Primary Address Search 23 Program Functions 15 UESH ODS L gas 31 RC ote et a 8 Real aG 11 Recording sss sese eee eee eee IR Remote Connection 19 Remove Slave s 20 Repeat C D aZ maces 5 REPCHUONS a aa arat 15 REO UD h ronnsaron 7 17 REO UD E A Pale REQ UD2 lower line 7 NCCI T a 8 Reset Slave List 0 0000000 21 Reset slave list before slave T E eee ee eS ne 23 Reset Transmission List8 9 21 Reset WindowsiZe 6 21 Reseno 5 ReO A H OL I 31 RES OpuiOn iann 26 35 SCIPS E ana 30 33 SND UDD nie aa 7 UART FIFO 27 28 Secondary Address Search 23 Standard Secondary UART Break 0000008 24 Secondary Addressing 5 6 Addressing eee 16 Unit Number sss 12 Selecta Iae 6 Standard Secondary Selection 6 User Button 15 Dene x E EE 1
17. shows the answer of a slave The OW Es answer may be a simple E5 or an ES error but also a meter data telegram If a meter data telegram Long C 08 A 01 Cl 72 12345678 RAC 02 Heat_ inlef 01 00 0000 2 DRI e EO TEH the information of the telegrams Timeout ERROR header e Telegram Type Long LongC a long telegram or a long telegram with a another telegram to follow e C 08 value of the C field e A 01 primary address of the slave e CI 72 value of the Cl field e 12345678 device ID e RAC manufacturer code e 02 transmission count e Heat inlet medium e 01 generation number e 00 status e 0000 signature e 2 DR s number of data records contained in this telegram The data records are displayed in the Output List If the telegram contains any data records these are displayed in the Output List Value Funct U U U INT4 10 05 1998 01 11 Inst Time Point Date Time U U U INTZ d inst Hardware Version U U U INTZ 1002 Inst ootware Version The Output List has seven columns displaying the unit number tariff number storage number data type value function field and VIB of each data records variable M Bus protocol If a fixed protocol answer telegram is received unit tariff and storage are invalid set to and the function field is always instantaneous 2 1 6 Transmission Tracking List The Transmission Tracking List contains all M Bus transmissions done from the start of the prog
18. the predefined parameters The fifth selection COM off is used to close the serial port As long as one serial port is opened by M Bus Application this port is not available to other applications 2 1 4 Action Buttons ND NEE SIND LD GEU LID BEG NEE Slave Select Slave Search SREO IE Sie EI MeL ZTHRIG Empty Empty rifts e SND NKE sends a SND NKE initialization of slaves to the specified address expected answer E5 Only the primary address field is needed e SND_UD sends a SND UD send user data to slave to the specified address expected answer E5 You have to fill in the primary address Cl field DIF field if selected Value Type Field and Value Entry Field You may also use a predefined M Bus command from the Command List see 2 1 1 2 2 2 2 2 2 2 2 1 e REQ UDI sends a REQ UDI request for class 1 data to the specified address expected answer telegram with alarm data Only the primary address field is needed e REQ UD2 sends a REQ UD2 request for class 2 data to the specified address expected answer telegram with meter data Only the primary address field is needed e Slave Select sends a slave selection telgram using the entries in the secondary addressing section A standard or customer selection is sent see 2 1 2 The Slave Select button works only for Mode 1 M Bus slaves CI field 52H e Slave Search performs a search for all slaves connected to the bus All slaves found are listed in
19. the slave list Depending on the chosen option the search algorithm will first look for all possible primary addresses 0 250 and will afterwards perform a secondary address wildcard search You can interrupt the process by pressing the break button If the program is in primary search pressing the break button will skip to the secondary address search Pressing break again will terminate the slave search Starting a search will clear the slave list if the slave list reset option see 2 2 3 2 is chosen Slaves found in the primary and in the secondary address search will only be listed once The secondary address search is performed with standard or customer selection and works only for Mode 1 M Bus slaves ClI field 52H e REQ UD2 lower line same as REQ UD2 but with a repeat count see 2 2 2 3 Usually the repeat count is set to infinity therefore by pressing this button the REQ UD2 request is repeated until you press the break button Only the primary address field is needed e SND _UDL same as SND UD but does a listen only waiting for an spontaneous answer afterwards see YSIS ie Ws A Y e Empty There are four buttons for user defined M Bus scripts or program functions See 2 2 2 3 and 2 2 2 3 1 for more details Another twelve buttons are available on the right handside of the Serial Port Section M Bus Application Version 1 29 7 2 1 5 Output Section The output section contains the output field and the output list The output field
20. 6 Standard Secondary Selection User Defineable Buttons 15 Seral POM ste assiinsenchncntatiuns 7 with Fabrication Number 6 Serial Port Section 5 SLOPDItS esses scsstsnioseos aocass 26 Valeen a a 11 Show Buffer eccessi 9 Storage Number 00 12 Value Entry Field 6 Show Script Execution 27 Switch off FIFO 28 Value Information Block 11 12 Show slave list 20 Valys Type List ironista 6 Signed Integer sss 11 Tariff Number n 12 Value Field in Data Records Simulate M Bus Slaves 10 t RTT 8 with Error VIFE 23 Size of Data Record List Timeout Mode ccc cece 27 79 ETT 11 12 Uan LT 24 Timeout TA 26 28 VIF table selection 12 Slave Liste J Timeout TDB 27 28 BVA ee By ci eee ee 12 Slave Mode Properties 29 Timeout TO 26 28 Slave Search 7 16 23 TAS OUTS en ae 28 Wait until next 17 Slave Select cc ccseceeeee 6 7 16 Pez 9 10 WildCard TTT 6 Slave Selection ss 6 Tranmission Result 9 Slave Simulation sese 10 Transmission Tracking List 5 8 Zielen Prol Aisscessecescnencnsadesus 4 SOVE T SEa e 24 Troubleshooting se 31 ZVEL 31 SND NKE 7 16 Version History e 1 00 Initial release e 1 01 Slave search bug fixed if a slave has answered a selection telegram with a long telegram instead of ESH the slave search has stoped e 1 02 Windows NT timing bugs fixed echo canceling time Cursor problems fixed question mark
21. M Bus Application Version 1 29 File Mode Tools Options Help Device ID Ge mu Bs E F Fabrication DIF t F Customer Addr 2 ajo M Customer lt No predefined command gt lt All slaves SND NKE SIND LD REC OD BECHU Slave Select Slave Search a Flea ole 6 SND_UDL Eriet Eriet Sy Ert Tarif Storage Data Value Funct VIB RC Request ANSwer User Manual English Version 1 29 June 2012 C U 386400 Camel GS 1 3600 Camee l Ed Me 400 Come 1E fe 3 300 Comet lE f 4 COM Off Parameter License Agreement Company Site License The Software Product M Bus Application is protected by copyright laws The Software Product is licensed to the licensee not sold By installing copying or otherwise using this Software Product you agree to the following license agreement If you do not agree to the terms of this license agreement return the unused Software Product immediately for a full refund Copyright Licenser Licensee Grant of License Limited Warranty Miscellaneous 1997 2012 Michael Rac Entwicklung und Vertrieb von Computer Hard und Software 91522 Ansbach Germany Michael Rac Entwicklung und Vertrieb von Computer Hard und Software 91522 Ansbach Germany Your company at a single specified site The company and site are specified by ordering this Software Product The licensee of this Software Product is granted the following right
22. M GG AA secondary addressing D device ID M manufacturer code G empty Customer NNNNNNNNNNNN _ empty Slave select with customer AAAAAAAAAAAA secondary addressing N customer number A customer address empty empty Send HEX send data bytes without any M Bus telegram frame empty 1 next full minute empty Wait until the condition is met 2 next full two minutes based on computer system time 5 next full five minutes 10 next full ten minutes 15 next full fifteen minutes 20 next full twenty minutes 30 next full thirty minutes 60 next full hour 120 next full two hours 180 next full three hours 240 next full four hours 360 next full six hours 720 next full twelve hours 1440 next full day M Bus Application Version 1 29 p 5 primary address REQ_UD2 to primary address empty Standard DDDDDDDD Slave select with standard generation A medium empty empty empty Standard secondary addressing slave search time in 100 ms 1 10 second Delay script execution e ee Ln D Ww NO Ked l oOo Example script containing all possible M Bus script lines 0 COM2 300 8 1 E RTS Reset DTR_ Reset TA 330 TO 50 TB 4 PartWait Retries 3 DT 11 HS 0 lill 2 11 3 254 4 254 5 254 pll 7 254 51 01 02 8 Standard FFFFFFFF FFFF FF FF 9 Customer FFFFFFFFFFFF FFFFFFFFFFFF 10 11 11 12 13 01 02 14 5 15111 34 M Bus Application Version 1 29 In
23. OOOOH e DevicelID Device identity field hexadecimal BCD Default 12345678 e Man Manufacturer code hexadecimal Default 4823H e Ge Generation code hexadecimal Default 00H e Me Medium code hexadecimal Default OEH e Fabrication Fabrication number hexadecimal Default 12345678H e CustomerA Customer address hexadecimal Default 123456789000H e CustomerN Customer number hexadecimal Default 123456789999H e Answer to REQ UD2 with C Field 7BH The payload of the RSP UD answer to a REQ UD2 with set FCB You can enter any hexadeximal values up to the maximum size of 252 bytes If you want to put together your datarecords with a dialog use the Datarecord button which displays the Data Record dialog Any settings there will be added to the existing entries in this field M Bus Application Version 1 29 25 e Answer to REQ UD2 with C Field 5BH The payload of the RSP UD answer to a REQ UD2 with reset FCB The same as above If you do not want two different telegrams for each FCB setting check the box in front of Same as for C Field 7BH 2 2 3 5 COM Parameters Check to activate this Parameters for serial communication x COM parameter setting TN PEPE Saline a alice sAcwe ilies Toe ginni aaa R a come a come fi come Baudrate NT 3e400 Baud fl f 96008eud f 24006eud 3006au 2 Number of Databits DH sDatebits f 8Databis Zh 8Databis BDatebits gt Nu
24. TB timeout is automatically increased if this option is selected HighSpeed x8 Check this option if the UART of your computer system is a high speed UART works with 8 times the standard frequency Standard UARTs are able to generate baudrates between 300 and 115200 baud high speed UARTs are able to generate 600 to 921600 baud 2 2 3 6 Enable Slave Test Options You can globally enable or disable the slave test options see 2 2 3 3 for details 2 2 3 7 List Resizing Slider Switches the list resizing slider see 2 1 on or off 2 2 3 8 Show Script Execution During script execution time see 2 2 2 3 and 2 2 2 3 1 the output list of the main window see 2 1 can display the answer of a slave or the script in list form depending on how you set this option M Bus Application Version 1 29 ES 3 M Bus Timeouts A M Bus transmission is always a request answer sequence The master asks for data or sends a command and the slave has to transmit the requested data or acknowledge the command For a correct handshake there are some timeouts defined DT TA TO TB Time c o e TA TO TA is a timeout measured in bittimes and is therefore baudrate dependend TO is a timeout measured in milliseconds and is not baudrate depended The sum of both timeouts is the maximum allowed time between the end of the last stopbit of the outgoing request telegram and the first startbit of the incoming answer telegram If no answer i
25. URepeater slave list 2 2 2 8 Reset Slave List All slaves in the slave list are deleted 2 2 2 9 Reset Transmission List All entries of the transmission list are deleted 2 2 2 10 Reset Windowsize The size of the main window is reset to default M Bus Application Version 1 29 21 2 2 3 Options The menu point Options provides access to some useful configuration dialogs File Mode Tools Options Help Data Export R l M Bus M Bus Slave Test 5 slave Mode Properties DIF Iv UF COM Parameters List Resizing slider SND MKE Show Script Execution Prater FIPS 2 2 3 1 Data Exports You are able to specify the export format of the Transmission Tracking Lists entries You can export the entries of the Transmission Tracking List into the clipboard to a file or directly to Microsoft Excel see 2 1 6 for details The following options are available e Export Requests Check this option to export all Select what ee re M Bus master requests should be P e Export Answers Check this option to export format exported M Bus slave answers e Export E5 If the Export Answers option is selected you may also choose if you want to export single character acknowledge answers E5 or not e Export Errors If the Export Answers option is selected you may also choose if you want to export errorneous slave answers or not All entries can be exported as readable text Export as Text as HE
26. X bytes Export as HEX bytes or as S L ut decimal bytes Export as Decimal bytes FR For Microsoft Excel data exports you can enter a key Fo sequence which will be sent to Excel immediately after the data is exported To gain access to the menu of Microsoft Excel there is a special key which can OK cence Help be specified in the Microsoft Excel options dialog usually A P will be interpreted as an ENTER keypress Therefore you can control most functions of Microsoft Excel with this feature e g start a macro autoformat e Example tfl will autoformat the exported data using the german Microsoft Excel menu keys To start a macro it must be defined in your personal Microsoft Excel map which is loaded on program start and it must have an entry in the extras menu of Microsoft Excel Data Export Setting Transmission List W Export Bequests Export as Text IY Export Answers C Expot as HEx bytes iM ExpotE5 C Export as Decimal bytes W Export Errors Excel Key Sequences F None Enter a key sequence to send to Excel immediatly after data export 22 M Bus Application Version 1 29 2 2 3 2 M Bus There are several M Bus related options Check if M Bus Options FCB option for datarecords frota with an error Telegram Interpretation FCB SND_UD FCB HEU UU tel 8 e1egrams VIFE have a e Value ield in data records with error VIFE C FCB FCV reset C FCB
27. and Hsi predefined data Listor EEI Create a new records for user deactivated amp DemerList command list defined purposes e g programming a certain meter or sending the M Bus command to change the baudrate After installation of the M Bus Application program there is usually no command list available To define a new command list press New The Edit Command List Dialog appears which is described in detail in 2 2 2 2 1 If you have created one or more command lists their names appear in the Jnactive Command Lists window To activate one of these command lists select it in the list and press Activate or double click its name in the list or drag it from one list and drop it into the other To deactivate a command list select it and press Deactivate or double click its name in the list or drag it from one list into the other If you want to make changes to an existing command list select it and press Edit J MBUSLIST Cancel command lists F stokopt 2 2 2 2 1 Create a new M Bus command list or edit an existing one On the Activate or Deactivate M Bus Command Lists dialog press New to define a new command list or select an existing one and press Edit Either way the Edit Command Lists dialog appears A M Bus command consists of a description a value for the Cl field a data record DIB VIB only and a flag describing what kind of value the user has to enter when using this command M Bus Application Version 1 29 13 The description entr
28. changed You can initiate the slave mode by pressing Mode gt M Bus Slave M Bus Application is no longer a M Bus master then but behaves like a slave answers to M Bus request instead of initiating them Control Field for RSP_UD M Bus Slave Mode Properties 7 Control Information Field for RRP UD fase uom gt T CI Field RSP_UD ClField tik Cancel for Selection Cl Fafo 52H Hel comple Saa S ee He p Primary Address S Status field Device ID Man Ge Me a FD lt nue and customer Signature field 12345678 4823 00 0E Status 00 Fabrication 12345676 number and address Datarecords for answer to Signature 0000 CustomerA Customer REQ _UD2 with Invoke Data Record C 7BH EQ_UD2 with C Field 7BH dialog Datarecords for alate answer to C461 1B 20 00 00 00 02 86 22 E7 09 REQ UD2 with C 5BH Invoke Data Record Answer to UD2 with C Field 5BH dialog T Same as for C 7BH Use same datarecords for naiai all RSP UD e RSP UD C Field Control field of RSP UD answer hexadecimal Default 08H e RSP UD CI Field Control information field of RSP UD answer hexadecimal Default 72H e Selection CI Field What control information field stands for a slave select hexadecimal Default 52H e P Address Primary address decimal Default 1 e Status Status field hexadecimal Default 00H e Signature Signature field hexadecimal Default
29. csiss eas tynicuenantentysenares 31 DTR Opo sese 26 Edit Command Lists 13 FONDLY a 7 Enable Slave Test Options 27 Encryption DES 18 24 Excel Al annn 9 Excel Selection 666 9 Excel Key Sequence 15 e EEA Sistas EE ETE 9 EXPONO 22 Export AnSWGTS 22 Export as Decimal bytes 22 Export as HEX bytes 22 Export AS Text eee 22 EXPOM E T 22 Export Errors aienea 22 Export Requests 006 ZZ Fabrication Numbet 6 T TE E NE EN ESS 23 FCB SND UD FCB REO UD maon 29 FOV et eern ree 23 TO T 27 28 TC E eect ceene eee late 9 INS CAM T 9 File Selection abeg lt Tus 9 Function Field sss sese 12 E ais EE E E E E 6 Generation eee eee 16 Generation Number 6 HO ti cae sce ear Se seated dats 9 HighSpeed ciii 27 FNIS enti oi EH 31 Inactive Command Lists 13 Installation sese 4 Introduction 4 Key Sequence ccccceee 22 IB 23 List resizing slider E List Resizing Slider 9 Listen Only aches 17 Long Frame Telegram 11 M Diut hesret 8 M PSEC kessi a 8 I Pink eee 8 M reira 8 Main TGO 5 9 Main Sereen 5 MAM a CTE RETR CE ROTO 6 M Bus Application Version 1 29 I Ee L d Manufacturer e 16 Manufacturer Code 6 18 Manufacturer Specific Data 6 WES H 14 32 MD rendenin 17 33 M Bus Master Mode 10 M Bus Related Options 25 M Bus script
30. ct as a complete package The licensee may not licence distribute or grant any rights to any part of the Software Product 8 The licensee may not reverse engineer decompile or disassemble the Software Product or use any other method to get an insight view of the Software Product 9 Ifthe Software Product is an upgrade or update the licensee may use or transfer according to point 5 the Software Product only in conjunction with the original Software Product 10 The copyright to the Software Product including but not limited to all files examples documents in written or electronical form and all of its copies are owned by Michael Rac Entwicklung und Vertrieb von Computer Hard und Software 91522 Ansbach Germany 11 For any components of the Software Product which copyrights are not owned by the licenser but by a third party the license agreement of the third party is valid The licenser warrants that the Software Product will perform substantially in accordance with the accompanying written manuals and that the distribution medium CD ROM is free of defects under normal use and service for a period of 24 month The licensers entire liability and the licensees exclusive remedy shall be at the licensers option 1 either return of the price paid or 2 repair or replacement of the Software Product Any other liabilities for the Software Product with all its components are disclaimed The licenser disclaims especially all other warranties e
31. d only accepts decimal values You may reset all values of the DIB by pressing Reset If you change one of the values the DIB Edit Field is immediately updated and displays the DIB in hexadecimal form Instead of changing one of the values described above you may also enter the DIB into the DIB Edit Field in hexadecimal form The Value Information Block VIB contains information about the type of the data e g physical unit and is made up of one Value Information Field VIF and 0 10 Value Information Field Extensions VIFE There are three different VIF lists to choose from standard FBH and FDH You can cycle through the different lists by clicking the VIF table selection button Selecting a VIF is done by pressing the list and selecting one of its entries You can add VIFEs by checking the box on the left handside of the VIF VIFE lists Selecting a VIFE is also done by pressing the list and selecting one of its entries 12 M Bus Application Version 1 29 You may reset all values of the VIB by pressing Reset If you change one of the values the VIB Edit Field is immediately updated and displays the VIB in hexadecimal form Instead of changing one of the values described above you may also enter the VIB into the VIB Edit Field in hexadecimal form Each data record may or may not contain a value The checkbox on the left handside of the value field switches the value entry on or off Depending on the Data Field you have to en
32. d the progress bar will show you Phonenumbe TT the progress of the ongoing r to call connection process The status line Connectio Phonenumber f0 123456789 will display Connection established n status if the line is transparent and you can Establish a remote close the dialog The main window connection will now display a different picture to Cancel a PERRE show you that a remote connection is remote active You can work over the remote Disrupt current Settings connection the same ways you can action nitialisation ATX3 work using the direct M Bus Modem H connection To cancel the connection initalisatio open the Remote Connection dialog Touchtone or M Automatically Raise DTR line IZ Automatically Switch to No Parity again and press Hang Up M Bus pulse dialing T S Application uses the active COM User DTR to ad TORT mE settings for remote connections control However you can override three Glose Help parameters which will be explained Automatically Ss use Parity Off Increase Initialisation Enter an AT command for initialising the modem prior to sending the dial string Default ATX3 Touchtone Dialing Check this box if you want touchtone dialing the ATDT command is used Deselect it if you want pulse dialing the ATDP command is used Default checked Automatically Raise DTR Line If this box is checked the DTR line is raised prior to any command to the modem After a call
33. data record including the DIF is entered in the Value Entry Field Therefore uncheck the box on the left handside of the entry field However if you want to send manufacturer specific data which are coded as ASCII characters you may want to enable the D F Field and enter OF hexadecimal manufacturer specific data following because you are not able to enter OF hexadecimal using ASCII characters Primary Address Contains the primary M Bus address of the telegram to send Valid addresses range from 0 to 255 The address is automatically changed to 253 if you have used the Slave Selection button see 2 1 4 Value Type List The Value Type List gives the interpretation of the Value Entry Field see below Possible options are e HEX All entered characters are interpreted as hexadecimal values e g 0A FE 34 Any non hexadecimal characters are ignored e ASC All entered characters are used as they are ASCII characters e D T A date and time entry is expected e g 01 01 1998 12 00 e DAT A date entry is expected e g 01 01 1998 e Ix All entered characters are interpreted as one integer value If the length of the entry is longer or shorter than the choosen integer accuracy the value is extended or truncated e Bx All entered characters are interpreted as one BCD value If the length of the entry is longer or shorter than the choosen BCD accuracy the vlaue is extended or truncated e R4 All entered characters a
34. date afterwards will accept your changes Remember to press Update after you have finished entering the fields If you do not press Update and press Edit again all changes are lost e To permanently remove a M Bus command from the command list single click its description in the list and press Remove e To sort the M Bus commands in the list press Sort You will see two lists on the left and right handside respectively The left list contains the unsorted commands all commands in the order you entered them By double clicking single clicking and using gt or by dragging and dropping you can move commands from the left list to the right list Multiple selections using the CTRL or ALT keys are possible The order in the right list will be the new order of the commands Pressing Sort again accepts your changes After creating or editing your M Bus command list you have to save it to disk The command lists are simple text files with the file extension MBL see apendix for format specifications The M Bus Application program only recognizes command lists with the extension MBL which are present in the directory of the executable program file e g C PROGRAMS M BUSAPPLICATION You may save your command lists to any directory you want to but only those in the directory of the executable program are recognized and can be used within M Bus Application 14 M Bus Application Version 1 29 2 2 2 3 M Bus Scripts In M Bus Application
35. dex lt Data record dialog gt 6 lt No predefined command gt 6 PRO TTT 23 Action Buttons A INCUIONS secant eean 16 Adressing Mode 05 16 PINS WEE T 9 Assign to Again 17 Automatic REQ UD1 on ACD AAS EE S dren E EETA 23 Automatic REQ UD2 on DIF E A T 23 PAUOT ALC ss r 26 BOD TT 11 Calculation aes az cesses 18 CISFICIG ENE 5 16 COM OTT 7 COM Parameters 7 17 26 COM Polha 26 Comand Lists sse 32 Command Lists 13 29 Communication Parameters 7 Context Help Button 4 5 Control Information 5 LOT 9 Copy Selection sss 9 COUM copia ed race tot cements 8 CPURepeater Slave List 21 Custom Secondary Addressing E pee AEAN 16 Customer Address 0 6 Customer Number 6 Customer Selection 6 CUSTOINCLA ices 6 CUSIOMECEN ecscjwncmiuicdvcns 6 DT cy Gece tne aa ee ttre Breer aa eter ote 6 DA TTT 6 DANG E oscericeseeasocoses 16 Data Encryption Standard 18 24 Data EXPOMS soscescosacsarcesnats 22 Data GG 11 Data Information Block 11 Data Input Section 5 Data Records 6 8 11 IDALADIUS sea dednccnnctenicdiastenembewtes 26 Deadtime DT 27 28 Decryption DES 18 24 Delay KT 15 IR 17 DE Siera sities 18 24 Device LET 6 16 151 TTT 11 DIBI V IB inienn 14 OTE PII sisctasdecenctnen conden 5 6 ADR siu
36. e list functions Calculations dialog now contains DES encryption decryption ECB and CBC modes Automatic DES data decryption for certain meter types Fix mode data bug fixed if VIF units without multiplier was selected the value in fix mode telegrams was correctly calculated but the VIF unit was not set accrodingly Slave search funcion corrected so that manufacturer generation and medium run from 0 F and only the device ID runs from 0 9 Previously all fields were running from 0 9 e 1 14 Ifa slave has answered with a string VIF 7C the value was sometimes misinterpreted as date time value even though it was a 2 or 4 byte integer This bug is fixed 36 M Bus Application Version 1 29 LIS 1 16 1 17 1 18 1 19 1 20 1 21 1322 Using the edit command list dialog it was not possible to enter an empty DIB VIB field After saving the Cl field was copied to the empty DIB VIB field This bug is fixed The AT commands to initiate and cancel a phone connection are no longer sent with carriage return line feed ODH OAH but only with a carriage return ODH A minor bug in the slave search algorithm was fixed New media according to prEN13757 3 are implemented Non metric units according to prEN13757 3 are implemented VIFE 3DH If a telegram contains VIFE 39H the value will now be interpreted as Date Time The selection ASC for text is now available for entries of a command list If a date contains the flags e
37. for an answer for the specified timeout time Listen only requires no parameters e Recording You can export specified transmission results either to the clipboard directly to Microsoft Excel or into a file This depends on the selection you made in the M Bus script dialog 2 2 2 3 Only those transmission results are exported which are included in a RecStart RecStop bracket Press Start in front of the first script line which transmission results you would like to export and press Stop after the last script line you would like to export You may use more than one RecStart RecStop bracket After script execution the results are exported immediately e g the results are available in the clipboard e Delays Inserts a delay of specified duration between two script lines The delay is given in 1 10 of a second 100 ms e Wait until next Inserts a delay which goes until the next full minute system time next full two minutes next full five minutes and so on A delay until the next full twenty minutes e g will go until the computer system time is at 20 minutes past the full hour 40 minutes past the full hour or at full hour depending on the time the script line is executed With this option you can realize a readout at specified times e g every minute or every five minutes and so on e COM Parameters You can alter the COM parameter settings during the execution of your script After script execution has finished the COM parameters are rest
38. has been established lowering the DTR line is used to force the modem to hang up After hanging up the previous DTR line setting is restored Default checked Automatically Switch to No Parity Since most modern modems are not capeable of transmitting 8 databits and an additional parity bit e g 8E1 usually no parity is used during remote connections 8N1 By checking this box the parity is always disabled during a remote connection regardless of the COM port setting After the connection is canceled the previous parity setting is restored Default checked Additional TO ms The standard TO time is increased by the given value since remote connections usually have a lag After the connection is canceled the previous parity setting is restored Default 2000 ms M Bus Application Version 1 29 19 2 2 2 6 Show Slave List A list of all slaves found on the bus You can sort the list by pressing the header of a column You can remove a slave permanently from this list by selecting Remove Slave s from the lists context menu right click somewhere in the list See 2 2 2 3 1 for the special purpose of the slave list in M Bus scripts The slave list has the following columns Count index in list Addr primary address ID device ID Man manufacturer code Gen generation number Med medium Date the date the slave was first found on the bus Time the time the slave was first found on the bus Customer Addr customer address if n
39. ia Manufacturer ID Date Formats Available fixed protocol media Fixed Protocol Media DES Encryption Decryption Available 07 Water v Key 1 23456 SS04BCDEF variable protocol media Variable Protocol Media IV 0000000000000000 Entry fields 07 Water DES encrypt ater v dd ti Translate a throc Data EB90BD2A6F9D3F12 mci 21 character Calculate Manufacturer ID manufacturer code into 2 byte HEX HEX code and vice versa Calculate M Bus Dates Type F CP32 erza Dates Date DD MM YY HH MM M Bus Type F LSB First Ype 07 05 05 23 59 lt gt 38 17A7 05 Calculate Dates Calculate M Bus Dates Type G CP16 Type G Date DD MM YY M Bus Type G LSB First 12 07 05 lt OK Help A small dialog which displays all possible fixed and variable M Bus protocol media Press the media field to open the list The HEX code for each media is shown on the left handside of each list There is also the opportunity to calculate the M Bus manufacturer code from its three character form Enter three upercase letters in the left edit field and read the M Bus manufacturer HEX code in the right edit field and vice versa Although you can enter anything for a valid M Bus manufacturer code you have to enter upercase letters no numbers in the left edit field and HEX characters in the right one For calculating the M Bus Type F and G date types you may either enter the date in readable form DD MM YY HH MM or DD MM YY which is instanta
40. ion option is enabled and a 16 bytes 32 characters AES128 key is entered 2 2 3 3 M Bus Slave Test This dialog is used for testing M Bus slaves You can intentionally alter your request telegrams SND UD and REQ UD and see if a slave is still answering If so the slaves M Bus protocol decoding is not working properly Byte fields in Byte fields in SND UD SND_UD REQG_UD REQ UD telegrams 1 Startbyte F Wrong F Twice Startbyte T Wrong F Twice telegrams 1 Lengthbyte M Wrong FP Twice C Field T Wrong F Twice Replace byte field 2 Lengthbyte M Wrong P Twice Checksum T Wrong F Twice UART break with a random but 2 Startbyte Wrong FP Twice Stopbyte M Wrong Twice options always wrong C Field F Wrong F Twice value T Twice Enable or disable Checksum rong F Twice Send byte field Stopbyte F Wrong F Twice a eve re falas options regardless Reset Enable Disable OK of what is checked Reset all checks There are two ways to alter specified byte fields e g start byte address byte stop byte of the M Bus request telegrams Wrong the byte field is set to a random but always wrong value e g second length byte some slaves only decode the first length byte This is not correct since both length byte must be decoded and compared By sending a wrong second length byte you can recognize if a slave is not decoding both length bytes Twice the byte field is sent twice instead of o
41. ission Tracking List contains the following entries e Copy All copies the complete Transmission Tracking List into the clipboard e Copy Selection copies only the selected rows of the Transmission Tracking List into the clipboard 21 16 56 21 10 45 21 10 46 Sa fad 21 20 56 21 30 44 1 39 07 ekat 1 39 23 ER e zzzzzzzzzz more detailed view of the selected transmission results e Reset Transmission List clears the Transmission Tracking List ett et d d Dl te tet l Request RE TIS 7B AFE Sel RE SN SN RE SN SN SN RE Copy selection File Selection Excel Selection Reset Transmission List List Resizing slider File All copies the complete Transmission Tracking List into a file which can be specified File Selection copies only the selected rows of the Transmission Tracking List into a file which can be specified Excel All copies the complete Transmission Tracking List directly to Microsoft Excel Excel Selection copies only the selected rows of the Transmission Tracking List directly to Microsoft Excel Show Buffer invokes a dialog with a e List Resizing Slider the List Resizing Slider on the lower right of the main window can be switched on or off 2 1 7 Show Buffer If you want a more detailed view of a single transmission result you can select it from the Transmission Tracking List remember to click the first column count you are not able to select an entry using
42. ither expressed or implied including but not limited to the fitness of the Software Product for a particular purpose The licenser is not liable for any incidental indirect or consequential damages whatsoever including but not limited to damages for loss of business profits business interruption loss of business information or any other pecuniary loss If one or more points of this license agreement are for any reason whatsoever not valid the validity of the rest of the license agreement is not affected Customer Support If you have any question regarding this Software Product you can contact the author E Mail FAX Mail WWW MichaelRac MichaelRac com 49 981 9775686 Michael Rac Am Hirtenfeld 51 91522 Ansbach Germany www MichaelRac com M Bus Application Version 1 29 Contents 1 Introduction 1 1 Installation and De Installation 1 2 Manuals 1 3 Using the Program 2 Functional Description 2 1 Main Window 2 1 1 Data Input Section 2 1 2 Secondary Addressing Section 2 1 3 Serial Port Section 2 1 4 Action Buttons 2 1 5 Output Section 2 1 6 Transmission Tracking List 2 1 7 Show Buffer 2 2 Main Menu 2 2 1 Mode 2 2 2 Tools 2 2 2 1 Data Records 2 2 2 2 Command Lists 2 2 2 2 1 Create a new M Bus command list or edit an existing one 2 2 2 3 M Bus Scripts 2 2 2 3 1 Edit M Bus Scripts 2 2 2 4 Calculations 2 2 2 5 Remote Connection 2 2 2 6 Show Slave List 2 2 2 7 CPURepeater Slave List 2 2 2 8 Re
43. l in the Cl field the primary address field the value type list and the request edit field Slave Select This button is only available if the secondary or customer selection mode is selected in the data section Slave Select sends a selection telegram to the slave Whether you choose a standard selection or a customer selection you have to fill in the device ID manufacturer generation and medium field or the number and address field Slave Search Searches for all available slaves on the bus Depending on the selection mode in the data section a primary a standard secondary or a customer secondary address search is performed The slave list is updated Therefore you may use the special primary addresses 256 257 258 see above after a Slave Search Send Hex Sends the HEX bytes in the request edit field to the slave No M Bus frame is added but only the entered bytes are sent Be sure that the value type is HEX while using this command SND_NKE sends aSND_NKE to the slave You have to fill in the primary address field M Bus Application Version 1 29 300Beud ATSReset 5044 TO ms Start Stop Excel or File Context help used script lines to this button e REQ UDI sends a REQ UDI request for alarm protocol data to the slave You have to fill in the primary address field e REQ UD2 sends a REQ UD2 request for user data to the slave You have to fill in the primary address field e Listen Only sends nothing but waits
44. ld M Bus Application Version 1 29 11 Select Data Record Data Information Block Data Type Field Function Field Reset DIB values VIF table selection standard FBH FDH Add 0 10 VIF Extensions VIFE Reset VIB values Select whether to insert a value or not Context help Remove the currently displayed Data Record Tariff Number Unit Number Storage Number Data Record DRO jori DIB Data Field Funct Field Inst orage Number Reset WS a YIB VIF 16 Volume m3 X VIFE 1 Z 10C Add to ReadoutList v yFES J Reset 96 0C aye 3452 XV i 96 0C 7C 0D Remove DR B New DR cancer Add a new Data Record e The Function Field describes what kind of value is transmitted Possible values are e Inst e Max e Min e Frr Instantaneous value Maximum value Minimum value Errorneous value DIB Edit Field DIB in hexadecimal form Select VIF from list Select VIFE from list VIB Edit Field VIB in hexadecimal form Value usually in decimal form depending on Data Type Field Complete Data Record in hexadecimal form e The Unit Number is a value in the range of 0 1023 The entry field only accepts decimal values e The Tariff Number is a value in the range of 0 1048575 The entry field only accepts decimal values e The Storage Number is a value in the range of 0 2199023255551 The entry fiel
45. mber of Stopbits gt 1 Stopbit Ef 1 Stopbit f 1 Stopbit 1 Stopbit Parity bit Parity Even Parity Even Parity Even Parity Even RTS line ad RTSRese Sh ATSReset ATSReset Fl ATSReset DTR line e_DTRReset EI OTRReset HI OTRReset FI f DTRReset 2 T 3304 Tapit 3304fTAfbits f 3304 TAPpits 330 TA bits Timeout so fToms f so fToms T 502 Tofms 50 T0 ms Timout offset Tf 424reppitsy 4b 14 TBpits f 1476 bits Timeout byte R DT bis 14DTfis T oT pits T 114DT bits D adtim PartWait sl Parwat Partweit Partweit 3 Reties 344 Retries 34retries 3Reties Timeout option UART FIFO S UART FIFO UART FIFO UART FIFO Number of retries F HighSpeed x8 M HighSpeed x8 F HighSpeed x8 M HighSpeed x8 UART buffer L High speed UART The COM parameter setting dialog lets you define four sets of transmission parameters for serial communication You can activate one of the parameter sets using the activate box or selecting it on the main window see 2 1 The following options are available e Active Check this box to activate one of four parameter settings e COM port Selects the COM port to use COM1 COM20 e Baudrate Selects the baudrate Available baudrates are 300 600 1200 2400 4800 9600 19200 38400 57600 115200 230400 460800 and 921600 baud Baudrates above 115200 are only available with high speed
46. n is checked Default Checked Only VIF Units without multiplier If you check this option all VIFs containing a multiplier are replaced by VIFs without multiplier The value is recalculated accordingly e g 3244 Energy 100 Wh will be replaced by 324400 Energy Wh This feature is not working with VIFs from table FB with an index smaller 50 decimal If this option is not checked all VIFs are returned as they are Alternate VIF 0x7C Interpretation If you check this option for VIF with strings and VIF extensions a different decoding is used used by few meters FCB SND_UD FCB REQ UD How to handle the File Control Bit FCB and the File Control Valid Bit FCV in SND_UD and REQ UD telegrams e FCB FCV reset FCB and FCV are always reset FCB toggle Standard M Bus FCB handling Default FCB inverted Same as FCB toggle but with inverted FCB FCB set FCB and FCV are always set FCB reset FCB is always reset FCV is always set M Bus Application Version 1 29 23 FCB FCV reset for address 255 Check this option if you want to reset FCB and FCV always in REQ UD and SND_UD telegrams to address 255 If this option is not checked the address 255 is treated the same as any other address in respect to FCB FCV handling Default Checked NOTE The internal FCB backup bits are not altered after changing the FCB options You have to issue a SND NKE to address 255 to reset all FCBs if you have changed one of the FCB options
47. nce e g stop byte some slaves only read a telegram until they recognize the stop byte 16H This method is not correct since the end of a telegram must be recognized by a timeout By sending the stop byte twice you can recognize this There is also the possibility to send an UART break TX continously active On an UART break each slave has to stop sending immediately Three options are available 24 UART break off no UART break UART break after request after all request bytes are sent and the deadtime usually 11 bittimes is over an UART break is asserted The UART break is active until timeout time UART break after first received byte an UART break is asserted after the first byte of a slave is received The UART break is active until timeout time M Bus Application Version 1 29 You can globally enable and disable the slave test options by pressing Enable or Disable Therefore if you have checked more than one byte field you do not have to uncheck and check them all if you want to switch from enabled to disabled slave test or vice versa Options gt Enable Slave Test Options from the main menu is doing the same By pressing Reset you can reset all slave test options If a slave test option is active the window title of the main window is showing a warning message 2 2 3 4 Slave Mode Properties This dialog defines the behavior of M Bus Application in slave mode All important byte fields addresses and other settings can be
48. nd Output List see 2 1 5 Transmission Tracking List bottom see 2 1 6 2 1 1 Data Input Section The Data Input Section contains the following elements Context Help Button Whenever you want to know what a certain button or item does press the context help button and see how the cursor shape is changed to a question mark Press any button or item and the upcoming help window will give you more information about it Repeat Count The number of retries for one M Bus request During a M Bus communication this number is counted up for each failed transfer You can set the maximum number of retries for one M Bus request using the dialog see 2 2 3 5 The default is 3 retries per M Bus request computer to the meter or vice versa the data is transmitted from master to slave or vice versa Picture The picture shows an ongoing transmission by a moving M Whether the M moves from the CI Field The C Field is only used in conjunction with a SND UD request see 2 1 4 The entry is interpreted as one HEX byte and used as Control Information field in the telegram The default for a M Bus Application Version 1 29 5 SND_UD is 51 hexadecimal The C Field is not used in conjunction with a Slave Selection telegram see 2 1 4 A slave selection is alway done with CI 52 DIF Field This entry may contain the first byte of the first data record to send with a SND_UD Usually this field is not needed because a complete
49. neously translated to the respective M Bus coded form or you may enter the M Bus coded date in HEX format LSB first and the program gives the date in readable form If you want to set the summertime bit in type F write an S in front of the date e g S31 12 05 23 59 If you want to set the invalid bit in type F write an I in front of the date e g 131 12 05 23 59 Additionally this dialog provides a DES Data Encryption Standard encryption decryption calculator A DES encryption is used with some meter devices For more information on the DES algorithm see e g http www abisoft net des html You may encrypt decrypt using the ECB Electronic Codebook mode or the CPB Cipher Block Chaining mode The DES algorithm is based on 64 bit 8 byte words Enter the 64 bit key in hexadecimal form into the Key entry field If you want to use the CPB mode enter the 64 bit initialisation vector in the IV entry field For ECB mode enter zeros Enter the 64 bit data word to encrypt decrypt into the Data entry field Press Encrypt or Decrypt to perform the desired operation and the contents of the Data entry field is replaced by the result of the operation 18 M Bus Application Version 1 29 2 2 2 5 Remote Connection This dialog is used to initiate and cancel a remote connection via modem devices AT Hayes compatible command set You have to enter a phonenumber and press the Connect button to initiate a call The status line an
50. nt below if you are using Windows NT 4 0 Service Pack 3 e Iwas able to communicate with my slave but now it is no longer responding e Check if the primary address is still correct If you for example have pressed Slave Select or Slave Search the primary address is automatically changed to 253 e Check if the COM parameters are not changed e Check the cable and the M Bus repeater e Jam not able to communicate with my slave using an opto tranceiver e Check if the RTS and DTR line settings are correct see 2 2 3 5 Some opto transceiver are using these serial port lines for their power supply e Some slaves need an optical synchronisation before you are able to communicate via opto transceiver see below e My slave needs an optical synchronisation before I am able to communicate via opto transceiver e A ZVEI opto sync consists of a two second on off sequence The on off time is usually 417 us respectively one bittime at 2400 baud You can generate an opto sync using a M Bus Script Insert a SendHex line with 240 times AA in the data section baudrate is 2400 If this is repeated three times standard retry setting it is not exactly an opto sync but it works equally Usually slaves using this method fell asleep rather quickly after receiving an opto sync 1 second Therefore you may want to insert the action you want to perform e g REQ UD2 directly after the opto sync line into the M Bus script e Using Windows NTO 4 0 Ser
51. ocu german MBusApp pdf german manual in Acrobat Reader Format 1 3 Using the Program M Bus Application 1s a native 32 bit Windows 95 98 NT program The usage is similar to all other standard Windows programs However here are some tips e M Bus Application has a context sensitive help system Whenever you want to know what a certain button or item does look for the context help button R Press this button and you will see how the cursor shape is changed Press the button or item you want to know more about and a help window will appear In some dialogs there is no context help button but a standard help button e All lists and some other items in M Bus Application have context menus Single click with the right mouse button somewhere on the list and a context menu will appear e The contents of all lists in M Bus Application can easily be exported into the clipboard or directly to Microsoft Excel Select the appropriate option from the context menu of the list e Select list entries by single clicking the entries first column Select more than one entry by using the CTRL and ALT keys e Entry fields with a yellow background are read only 4 M Bus Application Version 1 29 2 Functional Description A picture of the main window after installation is shown below You may resize or maximize the window to enlarge the output list and the transmission tracking list In this chapter the elements of the main screen are described in detail
52. of a header start signs and length fields control field address field control information field the user data checksum and stop sign The user data consists of zero or more data records Each data records contains a DIB data information block a VIB value information block and a value Using the Data Record Dialog you can enter and modify all shaded blocks the user data C A CI Field U Checksum and Stop Sign T The Value optional Data Field Function Field Value Information Field VIF Unit Number Tariff Number 1 10 VIF Extensions VIFE Storage Number The Data Information Block DIB contains the following information e The Data Field describes how the value is encoded Possible values are e None No value in this data record e 11 12 I3 14 16 I8 Signed integer values with the given number of bytes e R4 Real value with 4 bytes e Sel No data but a selection telegram e B2 B4 B6 B8 B12 BCD values with the given number of digits e Var Value of variable length e Spl Special 1 DIF OF manufacturer specific with no telegram following e D T Integer with 4 bytes representing a date and time value type F e DAT Integer with 2 bytes representing a date value type G e Sp2 Special 2 DIF 1F manufacturer specific with more telegrams to follow e Idle Idle filler e Glob Global readout request If Spl Sp2 Idle or Glob is selected all etnry fields are disappearing except DIB Edit Fie
53. ored to the values before script execution Use the Set button to insert a COM parameter change in your script For a better explanation see the COM Parameter dialog description All M Bus script lines are displayed in the list If you want to remove a script line select it by single clicking the first column of the line and press Remove If there is a M Bus action you have to insert rather often you may assign this action to the button Again Select the specified script line and press the right mouse button Select Assign to Again from the upcoming context menu The button Again will no longer be disabled and every time you press Again the selected line will be inserted After you have finished editing your script you can save it to disk Press Save and enter a unique name for your script The default name Unnamed is not a valid name for a M Bus script therefore you have to change it The M Bus scripts are simple text files with the file extension MBS see apendix for format specifications The M Bus Application program only recognizes M Bus scripts with the extension MBS which are present in the directory of the executable program file e g C PROGRAMS M BUSAPPLICATION You may save your M Bus scripts to any directory you want to but only those in the directory of the executable program are recognized and can be used within M Bus Application M Bus Application Version 1 29 17 2 2 2 4 Calculations M Bus Med
54. ot available FFFFFFFFFFFF Customer Num customer number if not available FFFFFFFFFFFF Fab Num fabrication number if not available FFFFFFFF Slave list in standard selection mode primary address column first E Slave List Slave List Resize Qose Count Addr D Man Gen Mediun Date Time CustomerAdar O01 12345676 RAC UZ Heal niet 09 09 1996 21 18 48 0090009000000 111111111111 FFFFFFFF Slave list in customer selection mode customer address first W Slave List Slave List Resize CustomerAddr CustomerNum Date _Time Addr ID Man l Gen Medium 1 Fab Mum 1 DDD900D0089 0 111111111111 09 09 1990 21 18 48 O01 12345676 RAC UZ Heal niet FFFFFFFF 20 M Bus Application Version 1 29 2 2 2 7 CPURepeater Slave List Using this tool you can administrate the slave list whithin a CPURepeater You must be in M Bus CPURepeater mode to read or write the slave list from or to a CPURepeater You can manually add slaves to the list remove slaves from the list and change existing entries You may also read or write the slave list to a file Another option is to get all the slaves from the main slave list File name of the slave Baudrate for reading list slave Enter primary CPU Repeater Slave List Write the slave list to address device ID Defauk LZ a CPURepeater manufacturer PAd DeviceID Man Ge Medium Read the slave list generation and ZI fros3o0n1 frac fi for Water
55. ram The maximum number of entries depends only on your computer systems memory capacity You may clear the Transmission Tracking List using Tools gt Reset Transmission List see 2 2 2 9 or selecting the respective entry in the context menu right click the Transmission Tracking List To select an entry you have to click on the respective item in the first column count If you click in another column the selection is not changing Count Time RAC Request ANSWEr NM 2 21 10 43 1 Select C 53 AFD Cl 52 Cust amp ddr FFFFFFFFFF E5 MA 3 2118 4858 1 REQ _UD C 7B A FD Long C 08 A 01 Cl 2 12345670 NM d 212832 1 SNO_NEE C 40 A 0 ES NM b 21 20 56 7 SD NKE C 40 A 00 Timeout ERROR M b 21 38 44 1 REQ_UD C 7B A 01 Long C 08 A 01 Cl 2 12345678 NM 7 213902 1 SD LID C 73A 01 Cl 51 Data 003 Readout O E5 i S O 91 90 17 qd Ohl Lia robo ALA lE Mate wn Me ee ed n k L CC all The Transmission Tracking List contains the following columns e Count an index starting from at programstart e M green received a correct answer with the first attempt e M blue received a correct answer with the second attempt e YI pink received a correct answer with the third or with more attempts e M red did not receive a correct answer e Time time of transmission e RC request count number of attempts until the request succeeds Request request telegram 8 M Bus Application Version 1 29 e Answer answer telegram The context menu of the Transm
56. re interpreted as one four byte real value The entered value is extended or truncated to fit in a four byte real number Value Entry Field The Value Entry Field is used together with a SND_UD request Depending on the Value Type List you can enter a complete data record DIB VIB value as HEX bytes or enter manufacturer specific data e g as ASCII character which should be send with the next SND UD request If you have defined M Bus commands you may want to enter integer or BCD values Command List In M Bus Application you are able to predefine data records which can be send in a SND_UD request see 2 2 2 2 and 2 2 2 2 1 The command list contains the description of all of these predefined data records By selecting one of them and pressing SND UD you can send it to the slave However after installation of M Bus Application there are no predefined commands available but the command list contains two default entries e lt No predefined command gt If you choose this entry you have to enter the complete data record DIB VIB value to send with the next SND UD request Check if the value type list contains the correct type usually HEX e lt Data record dialog gt If you choose this entry the Data Records dialog appears you may also choose Tools gt Data Records from the main menu With this dialog you can put together the data records to send with a SND UD request very simply See 2 2 2 1 for more details about the Data Records dialog 2 1 2
57. s expressed by 01 02 Field 4 F4 contains an index of the value type to use with this command Possible value types are 3 byte signed integer 8 6 bytesigned integer __ 9 8 byte signed integer _ Bi4digitBCD gt o D 8digtBC0D o Example command list Comandl 51 02 13 5 DemoCommand 51 84 CO 40 96 OC 7 DoSomething 51 01 02 N 32 M Bus Application Version 1 29 7 2 M Bus Script File Format All M Bus Scripts are saved in a text file which contains only printable ASCII characters except carriage return line feed The extension is alway MBS If you want to use a script with M Bus Application it has to be in the installation directory of M Bus Application The following table shows the possible M Bus script lines and an example script Each script line consists of four fields separated by a 7CH 124D Therefore never use a as parameter At the end of each line is a carriage return and a line feed CR LF 0ODH 0AH 13D 10D F1 F2 F3 F4CRLF Field 1 F1 contains the index of the M Bus command Field 2 F2 contains the primary M Bus address to use with the command Field 3 F3 contains a description Field 4 F4 contains data in hexadecimal ASCII format e g 01H 02H is expressed by 01 02 ae ae comma see example results results 4 7 primary address empty Cl field SND_UD to primary address with data records Cl field first byte and following data bytes MMM
58. s received whithin this time the request is cancelled and a timeout is reported The default value for TA is 330 bittimes and for TO 50 ms communicating over a direct connection However if the communication is for example going over a modem modem connection TO must be increased to compensate for the additional transmission delay e g TO 1000 2000 ms e DT The deadtime is the time between the end of the last stopbit of the outgoing request telegram and the time after the master is able to receive anything All bytes received whithin the deadtime are discarded The deadtime is used for echo cancelling some M Bus repeater and optical transceiver are echoing all bytes The default value for DT is 11 bittimes e TB In M Bus the end of a telegram is only recognized by a timeout TB If there is not another startbit after TB has run out the end of the telegram is recognized The default value for TB is 1 bittime In M Bus Application all timespans are only measured with 1 millisecond precision This is due to the limitations of the Windows operating systems Therefore and because Windows is not a real time operating system guaranteeing a maximum reaction time there are some problems arising 1 TA TO might be longer than specified 2 The TB timeout is usually to small to be guaranteed under all circumstances At higher baudrates TB is significantly smaller than 1 millisecond however 1 millisecond is the smallest possible TB time
59. s to use the Software Product throughout his company at one specific site 1 The licensee may install the Software Product throughout the licensed company on as many computer systems as the licensee wants to and use this Software Product for an unlimited amount of time in parallel The licensee may make unlimited backups of this Software Product provided that these backups are used only for internal purposes 2 The licensee may use the Software Product on as many portable computer systems throughout the world as the licensee wants to provided that only employees of the licensed company working at the specified site are using the Software Product 3 The licensee may install the Software Product on computer networks as long as point 1 and 2 of this license agreement are obeyed 4 Point 1 2 and 3 are valid for the complete Software Product for the software and all documents files and examples delivered with this Software Product 5 The licensee may transfer the license to this Software Product permanently provided that the licensee retains no copies and transfers all of the Software Product software documents files and examples and the recipient agrees to the terms of this license agreement 6 The licensee may not license distribute or grant any rights to the Software Product for any other purpose than described under point 5 The licensee may not rent or lease the Software Product 7 The license agreement includes the Software Produ
60. send a special command sequence more than once e g selecting and reading out a set of slaves send a set of parameters to a slave and check if the parameters are correctly taken With M Bus Scripts this can be done with the press of one button The following parapraph contains a step by step instruction on how to create a M Bus Script which selects three slaves two with standard secondary addressing and one with customer addressing and reads their meter data 1 From the main menu select Tools gt M Bus Scripts 2 Press New Device ID Man Ge Me i i 12345678 423 oof o6 Enter the device ID manufacturer code generation and ARNAN LAA medium of the first slave to select Press Slave Select Change primary address to 253 Press REQ UD2 Enter the device ID manufacturer code generation and medium of the second slave to select Press Slave Select 9 Change primary address to 253 10 Press REQ UD2 11 Press the checkbox on the left handside of the device ID once Number Address 12 Enter the customer number and address of the slave Zee IEEE eit 13 Press Slave Select 14 Change primary address to 253 15 Press REQ UD2 16 Press Save 17 Enter a unique name e g SlaveRead 18 Press Save 19 From the list of M Bus Scripts drag SlaveRead to a button of your choice 20 Press OK 21 Now you have assigned the M Bus Script SlaveRead to the specified button and you can execute the script by pressing
61. set Slave List 2 2 2 9 Reset Transmission List 2 2 2 10 Reset Windowsize 2 2 3 Options 2 2 3 1 Data Exports 2 2 3 2 M Bus 2 2 3 3 M Bus Slave Test 2 2 3 4 Slave Mode Properties 2 2 3 5 COM Parameters 2 2 3 6 Enable Slave Test Options 2 2 3 7 List Resizing Slider 2 2 3 8 Show Script Execution 3 M Bus Timeouts 4 Using M Bus Command Lists 5 Using M Bus Scripts 6 Questions Troubleshooting and Hints 7 Appendices 7 1 M Bus Comand List Format 7 2 M Bus Script File Format M Bus Application Version 1 29 Nn OW ON NDNA 10 11 13 13 15 16 18 19 20 21 21 21 21 22 22 23 24 29 26 2j 2i 21 28 29 30 31 32 32 33 1 Introduction Welcome to M Bus Application a program capable of doing most anything regarding the Meter Bus M Bus The M Bus is a low cost bus system used for reading consumption meter devices such as watermeter heatmeter electricitymeter and much more It was developed by Prof Ziegler of the University of Paderborn together with Texas Instruments and Techem For all meters except electricitymeters it has become an european standard To understand this manual and the program you should be familiar with the main features of the M Bus Especially useful are The M Bus A Documentation and other documents found at the official M Bus web site http www m bus com 1 1 Installation and De Installation For installing M Bus Application do the following steps 1 Insert the
62. ster mode Remember though that there is no confirmation if the login succeeded therefore you have to issue a test request To enter another password enter the M Bus Master mode and then the M Bus CPURepeater mode again To leave the M Bus CPURepeater mode select the M Bus Master mode There is only one special function you can only use in M Bus CPURepeater mode This function is the slave list administration of the CPURepeater see 2 2 2 7 CPURepeater Slave List Please note that you have to increase the timeout offset time TO to approx 1000 2000 ms if you want to communicate using a CPURepeater Increase the timeout byte time TB also to approx 200 500 bittimes 2 2 2 Tools The tools menu contains some useful dialogs Fille Mode Tools Options Help Data Records Command Lists M Bus Scripts Calculations Remote Connection Show Slave List CPURepeater Slave List Reset Slave List Reset Transmission List Reset Windowsize 10 M Bus Application Version 1 29 2 2 2 1 Data Records By pressing Tools gt Data Records the Data Record Dialog appears You may also choose lt Data record dialog gt from the command list of the main screen A M Bus long frame telegram sent from Master to Slave usually contains one or more data records The Data Record Dialog provides a convenient method to put together these data records The picture below shows a M Bus long frame telegram variable protocol consisting
63. t check this option if no value follows a slave record error VIFE Default Checked M Bus VIF VIFE language Selects if the VIFs and VIFEs are displayed in English or German All transmission error messages are also displayed in the selected language Slave Search e Primary Address Search Check this option if you want to perform a primary address search using the Slave Search Button Default Checked e Secondary Address Search Check this option if you want to perform a secondary address search using the Slave Search Button Default Checked If both search options are checked a primary address search will be performed first followed by a secondary address search If both options are de checked no slave search will happen e CI Field Selects which CI Field value should be used with a slave selection telegram Do not alter the default setting CI 52H unless you are using an older M Bus slave Reset slave list before slave search Check this option if you want the slave list to be cleared before a new slave search Do not check this option if the slave list should not be cleared before a slave search Default Checked Automatic REQ UDI on ACD If a RSP UD telegram with Access Demand Bit ACD set is received a REQ UD is autmatically sent if this option is checked Default Checked Automatic REQ UD2 on DIF IF If a RSP UD telegram with a data record containing DIF IF is received another REQ UD2 is autmatically sent if this optio
64. ter a value in the following form e None No value to enter e 11 12 13 14 16 18 Value in decimal form e g 3234 e R4 Value as real value e g 2 34 e Sel No value to enter e B2 B4 B6 B8 B12 Value in decimal form e g 3234 e Var Variable length value in hexadecimal form e g 12AE4F e Spl No value to enter e D T Date and time value e g 01 01 1997 12 00 e DAT Date value e g 01 01 1997 e Sp2 No value to enter e Idle No value to enter e Glob No value to enter The entry field below the value field displays the complete data record in hexadecimal form You cannot enter anything in here As described above the user data of a variable protocol M Bus telegram may contain more than one data record To add a data record press New DR A new page with entry fields appears and you may enter the next data record Although the number of data records is not limited by the M Bus protocol the Data Record Dialog can only handle a maximum of 10 data records To remove the currently displayed data record press Remove DR 2 2 2 2 Command Lists By pressing Tools gt Command Lists the List of activated ETETEA HET eE nan E S dialog for activating command lists Activate a command list l Activate or deactivating es ae N l Deactivate a M Bus command lists i ea the Sees command list appears A M Bus command list on Edit l command list a EEE T Eata l contains a set of com
65. the button aio ad er ae Description Data Select Standard 12345676 4023 00 06 REQ UD 253 3 Select standard 87654321 4623 20 07 d REQ UD 253 S select Customer 3904753549759 3240 ap REQ UD 253 30 M Bus Application Version 1 29 6 Questions Troubleshooting and Hints e Jam sure that my slave answers correctly but M Bus Application always reports that there is something wrong timeout wrong length startsign or stopsign e Examine the answer closely by using the Show Buffer dialog If the beginning is correct but the end is completely missing there might be a problem with the byte timeout or the FIFO buffer setting TB see 2 2 3 5 3 Set the FIFO buffer to on and set TB to 40 bittimes If the problem 1s still present the slave is definitely not working correctly e Examine the answer closely by using the Show Buffer dialog If there are some wrong bytes in front of a correct answer telegram there might be a problem with the deadtime DT see 2 2 3 5 3 Increase the deadtime from 11 bittimes to approximately 15 20 bittimes until the wrong bytes are disappearing Do not increase the deadtime to much since the first bytes of the correct answer telegram could be suppressed e Examine the answer closely by using the Show Buffer dialog If nothing is received the slave might be to slow for answering within the standard M Bus timeout time Increase the timeout TA or TO see 2 2 3 5 3 Please read the troubleshooting hi
66. ton 3 Deactivate a Select export destination Clipboard Excel or File Button 4 Button 1 Hu D Delay 100 ms REQ_UD2 lt ln DDOL Send between each n 044 R 1 p script repetition D o2 ED 091 J3 l s Clipboard Edit a script Eh ii C Excel None Activate a script _Deactvate Fie Edit Activate or Deactivate M Bus Scripts Assign Program Functions to Buttons Button 5 Button 6 Or function Available Scripts Program Functions F Exit List of available F Data Rec x F Com Lists M Bus scripts S F Scripts E Slave List and program Res SI List functions F ee Use slider to cycle through user buttons YR I ETETETT User BUUUT I Show SR ser Uwn List Slider Cancel Help Ph The button fields on top of the dialog Button 1 Button 6 are corresponding to the six lower action buttons in the main window The two button fields below User Button 1 User Button 2 are corresponding to another 12 buttons on the right handside of the COM parameter setting which are only visible if you enlarge the main window You may use the slider to switch from User Button 1 and 2 to User Button 3 and 4 and so on Button I and Button 2 are containing predefined scripts namely REQ UD2 with repeat count and SND_UD with listen only For each script you may define the n
67. umber of repetitions R 0 32768 and the delay time between each repetition D in 100 ms If you set the repeat count to 0 the script is repeated until you press the break button You may also define where to send the output of the script into the clipboard directly to Microsoft Excel or into a file If you select the Excel option you may also select the key sequence to send to Excel see Options gt Data Export for details by simply pressing the Excel radio button repeatedly M Bus Application Version 1 29 15 2 2 2 3 1 Edit M Bus Scripts You may press New to create a new M Bus script or select an existing script and press Edit Either way the Edit M Bus Scripts dialog appears Data Section Set new COM parameters Script name List of script lines Remove a script line Edit M Bus Scripts D Data Actions Adar 2544 HEX SND_UD SND_NKE Action buttons Cl 51 lt No predefined command gt Slave Select REQ_UD1 uit Device ID Man Ge Me Slave Search F 1 Record j M Secondary FFFFFFFF FFFF FF FF Ee transmission S p end Hex isten On COM Parameters results for export COM2 Parity Even 3304 TA bits Recording to Clipboard i 8 Databits DTR Reset cS TB bits Delays Wait until next 1 Stopbit PartWait af aprel 5 40g Insert delays Set I HighSpeed x8 ga Retries agn insert Wait until a
68. very day every month or every year the respective value within the date is replaced by Bug in Datarecord dialog value entry fixed for BCD values the entry was MSB first now corrected to LSB first PRIOS radio device decryption support added New VIF units according to prEN 13757 3 2003 4 added Calculation of M Bus date data types F and G in dialog Calculations added The CI fields 0x7A RSP UD with 4 byte header and 0x78 RSP_UD without Header are now also interpreted The one byte answer 0xA2 NAK not acknowledged is now also recognised 1 23 The VIF 0x7C VIF in following string may now be interpreted in two different ways The user may choose one of the two interpretations by selecting the option in the options dialog Standard interpretation is VIF VIFE AsciiUnit the alternate interpretation is VIF AsciiUnit VIFE 1 24 AES 128 telegram decryption added 1 25 M Bus time format type J interpretation added 1 26 NIST AES key wrapping added 1 27 Direct log file writing to a file added Automatic current date inserting added 1 28 1 29 New M Bus media device types 0x20 0x3F added ClI fields 0x70 0x71 and 0x7F added VIFE table OxFC added M Bus Application Version 1 29 37
69. vice Pack 3 I recognize Timeout Errors very often especially with 9600 baud However I am very sure that my M Bus slave is working correctly e The serial device driver of Windows NT 4 0 is completely different from Windows 95 98 Especially if the UARTs FIFO buffer is switched on it is not guaranteed that the M Bus telegrams are sent without pauses between two bytes Therefore the FIFO buffer should be switched off while using Windows NT 4 0 use the serial port settings in the control panel and switch off the checkbox in front of FIFO buffer In some cases you might also increase TB and decrease DT sce 2 2 3 5 3 M Bus Application Version 1 29 31 7 Appendices 7 1 M Bus Comand List Format All M Bus Command Lists are saved in a text file which contains only printable ASCII characters except carriage return line feed The extension is alway MBL If you want to use a command list with M Bus Application it has to be in the installation directory of M Bus Application Each command consists of four fields separated by a 7CH 124D Therefore never use a as parameter At the end of each line is a carriage return and a line feed CR LF 0DH 0AH 13D 10D Fl F2 F3 FACRLF Field 1 F1 contains the description of the M Bus command Field 2 F2 contains the CI field in hexadecimal ASCII format e g 51H is expressed by 51 Field 3 F3 contains data in hexadecimal ASCII format e g 01H 02H i
70. y field accepts up to 60 characters cannot be entered The Cl field accepts only hexadecimal characters 1 byte Non hexadecimal characters will be rejected The DIB VIB field also accepts only hexadecimal characters If you do not want to enter the DIB and VIB manually you can press Data Record Dialog and use the upcoming dialog to compile a data record see 2 2 2 1 for details Value type Go to Data Record Dialog Xx Name of the command list Command EEEE description Sz Demo List p Data Record Dialog Selected Ent Description Cl Field to use Cl Field DIB VIB DIB VIB sn a we e PE List of already TE ld DIB VIB Value 51 0213 2 defined 51 84 C0 40 960C l4 commands Add a command Remove a command Accept changes Sort commands If the data record should contain a value you can specify what kind of value the user has to enter None no value Ix Integer value Bx BCD value D T Date and Time DAT Date see also 2 2 2 1 e To add a new M Bus command entry press Add and fill in all entry fields Description CI DIB VIB and Expected Value Pressing Update afterwards will accept your changes Remember to press Update after you have finished entering the fields If you do not press Update and press Add again all changes are lost e To edit an existing M Bus command single click its description in the list and edit the entry fields Pressing Up
71. you are able to define your own M Bus scripts a list of M Bus actions which will be executed sequentially see apendix for format specifications You can assign your scripts to one of 16 user defineable buttons You may also assign all program functions to one of the user defineable buttons On the M Bus Script Dialog there is a list of all user defined scripts S and program functions F on the left handside of the dialog After program installation there are usually no scripts but only functions available To assign a script or a function to a button you can select the name and press Activate o 38400 E Sl s D Ej 1 49600 Lome 6 1 E 3 m2 2400 Coma lE a ie 35 300 ate ots C 4COM Off Parameter show Script Opt Test Opt Export Res vd Size Slawe List BLEI E List Slider Opt hd Bus Res Tr List Res Sl List Exit the next available button is assigned to the specified script or function or double click the name or drag the name from the list to the button you would like to use To deactivate a script or function single click the button field an press Deactivate To create a new script press New To edit an existing script select the script either in the list or in one of the button fields and press Edit Predefined script SND UD Predefined script with listen only REQ UD2 with afterwards repeat count Make a new script script Repeat count 0 continous But

M-Bus Application Manual (English)

Contents

Download Pdf Manuals

Related Search

Related Contents