APPLICATION NOTE. OJ-DV Modbus protocol. OJ Drives A DRIVES PROGRAMME DEDICATED TO VENTILATION SOLUTIONS E 03/18 (PDJ) 2018 OJ Electronics A/S

Transcription

1 APPLICATION NOTE 67467E 03/18 (PDJ) 2018 OJ Electronics A/S OJ-DV Modbus protocol OJ Drives A DRIVES PROGRAMME DEDICATED TO VENTILATION SOLUTIONS

2 Introduction This protocol contains the Modbus addresses and registers which are available in OJ-DV. Modbus can access single addresses or several addresses simultaneously, either reading or writing 1-bit or 16-bit values. A Modbus address contains either a 1-bit value or a 16-bit integer. Modbus connection Figure 1 OJ-DV is equipped with four connectors for Modbus communication: three RJ12 connectors and one set of spring terminals. On the strip of spring terminals for control signals (A/D I/O), the terminals for Modbus connection are marked Bus A, Bus B and GND. See figure 1. Bus A Bus B GND +10Vdc A B -V+ -Add. Pin1 -Bus B -Bus A -Add. Pin2 -Gnd - -Add. Pin1 -Bus B -Bus A -Add. Pin2 -Gnd BR1014A16a 2015 OJ Electronics A/S The Modbus terminals are internally connected in parallel to the Modbus pins in the RJ12 connectors marked A and B. The RJ12 connector marked C is solely for the connection of external sensing devices. C -V+ -Gnd -Bus B -Bus A -V+ -Gnd BR1014A16a The three RJ12 connectors are marked A, B and C : A : Modbus connector, slave, +24VDC voltage supply in connector, for connection of a hand terminal (OJ-DV-HTERM), etc. B : Modbus connector, slave, no voltage supply in connector, for connection of a PC (OJ-DV PCTool), etc. C : Modbus connector, master, +24VDC voltage supply in connector (V+), for connection of an external sensing device, e.g. PTH/VOC. Modbus cable The following can be used for the Modbus communication cable: Round communication cable, which should be connected to the OJ-DV terminals marked Bus A and Bus B. Ribbon/telecom cable, 6-core, unshielded, 30 AWG, mm² or similar ribbon cable. Note If ribbon/telecom cable is used, RJ12 connectors must be attached to both ends of the cable using a special-purpose tool. Note Figure 2 Samme farverækkefølge BR1014A02a 2015 OJ Electronic A/S IMPORTANT! The RJ12 connectors must be attached to both ends in such a way that the two connectors follow the same sequence of wire colours in the cable. See figure 2 Modbus register types: BR1014A02a Modbus Type Description Reference Coil Status (R/W) Discrete Output 0x Input Status (R) Discrete Input 1x Input Register (R) 16-bit Input Register 3x Holding Register (R/W) 16-bit Output Register 4x R=Read only R/W = Read / Write 2018 OJ Electronics A/S 2

3 Supported Modbus commands Function code Description 1 Read Coil Status 2 Read Input Status 3 Read Holding Registers 4 Read Input Registers 5 Force Single Coil 6 Preset Single Registers 8 Diagnostics. Sub-function 00 Only - Return Query Data (loop back). 15 Force Multiple Coils 16 Preset Multiple Registers Modbus addressing Modbus addressing of the OJ-DV controls can be accomplished in three different ways. Via the addressing pins of connector A or B (Add. Pin 1 + Add. Pin 2) see figure 1 for pin location. The addressing pins can be used to assign the OJ-DV controls the address range: 0x36 (dec.54), 0x37 (dec.55), 0x38 (dec.56) and 0x39 (dec.57), see table 1. Table 1 Add. Pin.no. 0X36 (54 dec) 0X37 (55 dec) 0X38 (56 dec) 0X39 (57 dec) Add.Pin1 Add.Pin2 = No connection between GND and Add.Pin1/ Add.Pin2 = Connection between GND and Add.Pin1/ Add.Pin2 Via OJ-Air2 FanIO through connector B (see instructions for OJ-Air2 FanIO). Via the OJ-DV HTERM menu (see instructions for OJ-DV HTERM). Via OJ-DV PC-Tool by writing to Modbus Holding Register 4x0017 (see instructions for OJ-DV PC-Tool) Communication parameters Communication parameters can be set using OJ-DV HTERM or via OJ-DV PC-Tool. For factory settings and setting ranges, see table 2. Table 2 Range Unit Factory setting Alternative factory settings: Address n/a 54 dec. 54 dec. Baud rate 9.600, , , , bps Parity None, even, odd n/a None Even Stop bit(s) 0, 1, 2 n/a 2 2 Communication timeout Sec n/a=not applicable Contact OJ Electronics A/S for additional information OJ Electronics A/S 3

4 Values in this protocol is to be changed at your own risk. It is your own responsibility that changes of values and settings, do not cause any overload or damage to the product, motor or fan. Coil Stat Bits Available Coil Stat Bits are shown in table 3 below. Standard Modbus (RTU) Coil Stat Bits: 13 (R/W) 0x01: Read 0x05: Write Single Coil (NOTE: ON => output value = 0xFF00) 0x0F: Write Multiple Coils Table 3 Register Address Function Range Active state 0x Motor ON/OFF = ON 0x Reset Alarms = Reset 0x FireMode = Active 0x Rotation = ClockWise 0x Disable V_Ripple protection = Disable 0x Control = Modbus 1 = 0-10V 0x Alternative Comm = Enable 0x Autodetect communication = Enable 0x Analog start signal = Enable 0x Invert analog speed input = Invert 0x Allow using Field Weakening = Allow FW 0x Allow using Cooling Fan = Allow Fan 0x x 230V config = UV value from CCF 1 = Fixed value for 3x230V 0x V start voltage = 2V 1 = 1V 0x Very High Switch Frequency = 8 khz as HI SF 1 = 10 khz as HI SF 0x Write protect config = Allow change via Modbus 1 = Lock configuration 0x Clear PowerLog (Wh, kwh, MWh) = Clear Power Log 0x Motor output off = Keep motor output off 0x Autodetect control mode = Analog control with temporary Modbus override Input Stat Bits Available Input Stat Bits are shown in table 4 below. Input Stat Bits: 27 (R) 0x02: Read Table 4 Register Address Function Range Active state 1x V LO Alarm = Alarm 1x V HI Alarm = Alarm 2018 OJ Electronics A/S 4

5 Table 4 Register Address Function Range Active state 1x I HI Alarm (Motor out short) = Alarm 1x Temperature High = Warning 1x Input Phase Error = Error 1x Rotor Blocked = Error 1x Limit = Warning 1x Internal HW Fault = Alarm 1x Rotor Direction = Alarm 1x EEPROM Error = Warning 1x Internal Stop = Alarm (Stop) 1x Motor Phase Error = Alarm 1x Communication error MOC = Alarm 1x V Ripple = Warning 1x Digital Input = HI 1x Digital Input = HI 1x Ext. 24V supply overload = Overload 1x MOC in bootloader = Alarm 1x Digital input 3 (IOM) = HI 1x Digital input 4 (IOM) = HI 1x Commucation error (IOM) = Warning 1x Motor Overheat (IOM) = Alarm 1x Windmilling = Warning 1x Rotation OK = Rotation OK 0x IO Config mismatch = Warning 0x Config write attempt = Detected Input Registers Available Input Registers are shown in table 5 below. Input Registers: 32 (R) 0x04: Read Table 5 EC configuration FC configuration Register Address Function Range Resolution Unit Resolution Unit 3x Drive Type ? 1 n/a 1 n/a 3x AOC SW Version 0 -? 0.01 n/a 0.01 n/a 3x MOC SW Version 0 -? 0.01 n/a 0.01 n/a 3x PrcOut % 0.01 % 3x RPMOut RPM 0.01 Hz 3x Intern Temp ºC 0.01 ºC 3x V In V 1 V 3x I Out ma 1 ma 3x Power In W 1 W 3x I Ripple ma 1 ma 3x Operation Minutes Min 1 Min 3x Operation Days Days 1 Days 3x V Ripple V 1 V 3x Config. File Variant AA - ZZ 2 ASCII characters 2 ASCII characters 3x Config. File Version n/a 0.01 n/a 3x ExternSet mv 1 mv 3x AOC SW Variant n/a n/a n/a n/a n/a 3x AOC Boot SW 0 -? 0.01 n/a 0.01 n/a 2018 OJ Electronics A/S 5

6 Table 5 EC configuration FC configuration Register Address Function Range Resolution Unit Resolution Unit 3x MOC Boot SW 0 -? 0.01 n/a 0.01 n/a 3x Motor Config. Variant n/a 1 n/a 3x Motor Config. Version n/a 0.01 n/a 3x Fan Config. Variant n/a 1 n/a 3x Fan Config. Version n/a 0.01 n/a 3x User Data Variant n/a 1 n/a 3x User Data Version n/a 0.01 n/a 3x IOM SW version 0 -? 0.01 n/a 0.01 n/a 3x V DC Bus (Peak) V 1 V 3x V Motor (Peak) V 1 V 3x Power In (unfiltered) W 1 W 3x Power Consumption Wh 1 Wh 3x Power Consumption kwh 1 kwh 3x Power Consumption MWh 1 MWh n/a= not applicable Input Registers: 19 0x04: Read Table 6 EC configuration Register Address Function Resolution Resolution Unit 3x Production week WWYY 3x Production order number LO x Production order number HI x Serial number of batch x Product name length + Char x Ascii char 3x Char1 + Char x Ascii char 3x Char3 + Char x Ascii char 3x Char5 + Char x Ascii char 3x Char7 + Char x Ascii char 3x Char9 + Char x Ascii char 3x200A 2009 Char11 + Char x Ascii char 3x200B 200A Char13 + Char x Ascii char 3x200C 200B Char15 + Char x Ascii char 3x200D 200C Char17 + Char x Ascii char 3x200E 200D Char19 + Char x Ascii char 3x200F 200E Char21 + Char x Ascii char 3x F Char23 + Char x Ascii char 3x Char25 + Char x Ascii char 3x Char27 + NULL x Ascii char Holding Registers Available Holding Registers are shown in table 7 below. Holding Registers: 32 (R/W) 0x03: Read 0x06: Write Single 0x10: Write Multiple Table 7 EC-configuration FC-configuration Register Address Function Range Resolution Unit Range Resolution Unit 4x Setpoint / PrcSet % % 2018 OJ Electronics A/S 6

7 Table 7 EC-configuration FC-configuration Register Address Function Range Resolution Unit Range Resolution Unit 4x Min. RPM 0 -? 1 RPM 0 -? 0.01 Hz 4x Max. RPM 0 -? 1 RPM 0 -? 0.01 Hz 4x UpRampTime Sec Sec. 4x DownRampTime Sec Sec. 4x Max I Out 0 -? 1 ma ma 4x I Out Alarm Limit n/a n/a n/a ma 4x SwitchMode 0 Auto 0 Auto 1 4 khz 1 4 khz 2 8 khz 2 8 khz 4x U minhz n/a n/a n/a 0 -? 1 V 4x Freq Umax n/a n/a n/a 0 -? 0.01 Hz 4x Auto SF Change % % 4x ExpSet n/a n/a n/a n/a 4x Drive Type ? 1 n/a n/a 4x Modbus ID n/a n/a 4x Number of retries n/a n/a 4x CommTimeout Sec Sec. 4x CommRate bps bps bps bps bps bps bps bps bps bps 4x Parity 0 None n/a 0 None n/a 1 Odd n/a 1 n/a n/a 2 Even n/a 2 n/a n/a 4x Stop Bits n/a INVALID n/a n/a INVALID n/a 1 1 n/a 1 n/a n/a 2 2 n/a 2 n/a n/a 4x DigIn1 config n/a Disabled n/a n/a Disabled n/a 1 Start/stop n/a 1 n/a n/a 2 AlarmReset n/a 2 n/a n/a 3 MB_IDs_2 n/a 3 n/a n/a 4 Invert 10-0V n/a 4 n/a n/a 5 Rotation n/a 5 n/a n/a 6 Firemode n/a 6 n/a n/a 7 Moter Overheat n/a 7 n/a n/a 8 Invert 0-10V n/a 8 n/a n/a 9 Motor output off n/a 9 n/a n/a 4x DigIn2 config n/a Disabled n/a n/a Disabled n/a 1 Start/stop n/a 1 n/a n/a 2 AlarmReset n/a 2 n/a n/a 3 MB_IDs_2 n/a 3 n/a n/a 4 Invert 10-0V n/a 4 n/a n/a 5 Rotation n/a 5 n/a n/a 6 Firemode n/a 6 n/a n/a 7 Moter Overheat n/a 7 n/a n/a 8 Invert 0-10V n/a 8 n/a n/a 9 Motor output off n/a 9 n/a n/a 4x DigOut config 0 Disabled n/a n/a Disabled n/a 1 TachoOut n/a 1 n/a n/a 2 Running n/a 2 n/a n/a 3 AlarmOut n/a 3 n/a n/a 4 Running spin n/a 4 n/a n/a 4x MotorConfigVar n/a n/a 4x FanConfigVar n/a n/a 4x DigIn3 config (IOM) 0 Disabled n/a 0 Disabled n/a 2018 OJ Electronics A/S 7

8 Table 7 EC-configuration FC-configuration Register Address Function Range Resolution Unit Range Resolution Unit 1 Start/Stop n/a 1 Start/Stop n/a 2 Alarm reset n/a 2 Alarm reset n/a 3 Disabled n/a 3 Disabled n/a 4 Invert 10-0V n/a 4 Invert 10-0V n/a 5 Rotation n/a 5 Rotation n/a 6 Firemode n/a 6 Firemode n/a 7 N/A 8 Invert 0-10V n/a 8 Invert 0-10V n/a 9 Motor output off n/a 9 Motor output off n/a 4x DigIn4 config (IOM) 0 Disabled n/a 0 Disabled n/a 1 Start/Stop n/a 1 Start/Stop n/a 2 Alarm reset n/a 2 Alarm reset n/a 3 Disabled n/a 3 Disabled n/a 4 Invert 10-0V n/a 4 Invert 10-0V n/a 5 Rotation n/a 5 Rotation n/a 6 Firemode n/a 6 Firemode n/a 7 N/A 8 Invert 0-10V n/a 8 Invert 0-10V n/a 9 Motor output off n/a 9 Motor output off n/a 4x Relay1 config (IOM) 0 Disabled n/a 0 Disabled n/a 1 N/A n/a 1 N/A n/a 2 Running start n/a 2 Running start n/a 3 Alarm out n/a 3 Alarm out n/a 4 Running spin n/a 4 Running spin n/a 100 Disabled n/a 100 Disabled n/a 101 Start/Stop n/a 101 Start/Stop n/a 102 Alarm reset n/a 102 Alarm reset n/a 103 Disabled n/a 103 Disabled n/a 104 Invert 10-0V n/a 104 Invert 10-0V n/a 105 Rotation n/a 105 Rotation n/a 106 Firemode n/a 106 Firemode n/a 107 N/A 108 Invert 0-10V n/a 108 Invert 0-10V n/a 109 Motor output off n/a 109 Motor output off n/a 4x Relay2 config (IOM) 0 Disabled n/a 0 Disabled n/a 1 N/A n/a 1 N/A n/a 2 Running start n/a 2 Running start n/a 3 Alarm out n/a 3 Alarm out n/a 4 Running spin n/a 4 Running spin n/a 100 Disabled n/a 100 Disabled n/a 101 Start/Stop n/a 101 Start/Stop n/a 102 Alarm reset n/a 102 Alarm reset n/a 103 Disabled n/a 103 Disabled n/a 104 Invert 0-10V n/a 104 Invert 0-10V n/a 105 Rotation n/a 105 Rotation n/a 106 Firemode n/a 106 Firemode n/a 107 N/A 108 Invert 0-10V n/a 108 Invert 0-10V n/a 109 Motor output off n/a 109 Motor output off n/a 4x AnalogOut1 config (IOM) 0 Disabled n/a 0 Disabled n/a 1 ActSpeed n/a 1 ActSpeed n/a 2 TBD n/a 2 TDB n/a 4x Thermistor config (IOM) 0 Disabled n/a 0 Disabled n/a 2018 OJ Electronics A/S 8

9 Table 7 EC-configuration FC-configuration Register Address Function Range Resolution Unit Range Resolution Unit 1 Motor Overheat PTC n/a 1 Motor Overheat PTC n/a 2 TBD n/a 2 TBD n/a 4x AnalogIn2 config (IOM) 0 Disabled n/a 0 Disabled n/a 1 TDB n/a 1 TDB n/a 2 TBD n/a 2 TBD n/a 4x Thermistor threshold Ω Ω 4x Max Windmilling Time Sec Sec 4x AC notor boost current 0-? 1 ma ma? = Value depends on hardware variant n/a = not applicable OJ Electronics A/S Stenager 13B DK-6400 Sønderborg Tel. : Fax oj@ojelectronics.com 9 The trademark is a registered trademark belonging to OJ Electronics A/S 2018 OJ Electronics A/S