- Home
- Modbus register maps
- Bonfiglioli
- Agile frequency inverter (Modbus RTU/ASCII)
Variable frequency drive · Modbus register map
Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) Modbus register map
Updated 17 November 2026
Bonfiglioli's Agile general purpose inverter speaks Modbus RTU or ASCII on its X21 RJ45 port. The register address is the parameter number in the low 12 bits plus the data set number in the top 4 bits, and 32-bit parameters are read as two registers at a single parameter address. This map covers the control and status words, the RAM frequency and percentage references, error and warning readouts and the Modbus settings.
This page lists 17 Modbus registers for the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) — 11 writable — with the table, 0-based wire address, data type, word order, scale, units and access of each, re-typed from Bonfiglioli’s own free documentation (linked below) and checked against it.
- Manufacturer
- Bonfiglioli
- Model
- Agile frequency inverter (Modbus RTU/ASCII)
- Equipment type
- Variable frequency drive
- Registers
- 17 (11 writable)
- Transport
- Modbus RTU, Modbus ASCII
- Default unit ID
- 1
- Documented addressing
- 0-based (the number printed is the address on the wire)
- 32-bit word order
- ABCD high word first (big-endian)
- Also known as
- Agile, AGL, Bonfiglioli Agile
Integration notes: Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII)
Set 395 so Modbus is on the port you use, set 1376/1504/1375, then 412 = 1 to control by statemachine. Write 484 (2 registers, 0.01 Hz) and drive control word 410 through Shutdown (0x0006), Switch on (0x0007) and Enable operation (0x000F); poll 411 status and 260 actual error.
Minimum registers to map
Addresses are 0-based wire addresses. Enough to monitor and run the unit; map more as the job needs.
| Register | Name | Type | Why | Access |
|---|---|---|---|---|
| HR 410 | Control word | BITMAP16 | Control word | Read/write |
| HR 411 | Status word | BITMAP16 | Status word | Read |
| HR 484 | Reference frequency RAM | INT32 ABCD | Frequency reference, 0.01 Hz (32-bit) | Read/write |
| HR 412 | Local/Remote | UINT16 | Local/Remote: 1 = statemachine | Read/write |
| HR 260 | Actual error | UINT16 | Actual error | Read |
| HR 270 | Warnings | BITMAP16 | Warnings | Read |
| HR 11 | VABus SST error register | UINT16 | Modbus error register | Read |
Enable Modbus control & writes
Parameter 395 Protocol picks which port runs Modbus (factory 1: X21 RJ45 = Modbus). Set 1503 mode (RTU/ASCII), 1504 baud, 1375 parity and 1376 address; these take effect immediately without a restart. Set 412 Local/Remote = 1 for control-word operation (or 2 for remote contacts). The hardware release (STOA/STOB) and a Start Right/Left digital input must still be present to reach Operation enabled.
Communication loss & watchdog
1505 Modbus watchdog timer in seconds (factory 0 = off). If no correct exchange occurs within that time the inverter trips with a fault.
Byte order & addressing
- Address = parameter number + 0x1000 x data set. Data set 0 writes all four EEPROM sets; data sets 5-9 write RAM only (set + 5). Control word 410 and references 484/524 always use data set 0.
- 32-bit values are high word first and are read as 2 registers at one parameter number.
- Leave 2 ms after each response before the next request; response time can exceed 500 ms at high CPU load.
Network setup
- Modbus runs on the X21 RJ45 connection or on a CM-232 / CM-485 communication module, as selected by 395.
- Control word 410 and references 484/524 live in RAM; address them in data set 0.
Watch out for
- A write error blocks further writes until register 11 is read.
- Transition to Switched on only happens while status bit 4 (voltage enabled) is set.
Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) Modbus registers
Address = 0-based wire address (the documented number is shown under it when it differs) · Order: ABCD = high word first, CDAB = low word first · Scale: engineering value = raw × scale.
| Table | Address | Name | Description | Type | Order | Scale | Units | Access | Values / bits |
|---|---|---|---|---|---|---|---|---|---|
| HR | 11 | VABus SST error register | Modbus/VABus error code (0-15); read it to acknowledge write errors. | UINT16 | Read | ||||
| HR | 249 | Active data set | Currently active data set 1-4. | UINT16 | Read | ||||
| HR | 260 | Actual error | Code of the current fault (0-0xFFFF). | UINT16 | Read | ||||
| HR | 270 | Warnings | Bit-coded warnings; several can be set at once. | BITMAP16 | Read | bit 0 = Warning Ixt (set with bit 1 or 2); bit 1 = Short-time Ixt; bit 2 = Long-time Ixt; bit 3 = Heat sink temperature; bit 4 = Inside temperature; bit 5 = Current limit; bit 6 = Init; bit 7 = Motor temperature; bit 8 = Mains phase failure; bit 9 = Motor protective switch; bit 10 = Fmax; bit 11 = Analog input MFI1A; bit 12 = Analog input MFI2A; bit 13 = Systembus slave in fault; bit 14 = DC link voltage (Udc); bit 15 = Application warning (see 274) | |||
| HR | 274 | Application warnings | Application warning status bits. | UINT16 | Read | ||||
| HR | 395 | Protocol (CM / X21) | UINT16 | Read/write | 0 = CM: VABus / X21: VABus; 1 = CM: VABus / X21: Modbus; 2 = CM: Modbus / X21: VABus | ||||
| HR | 410 | Control word | Used when Local/Remote 412 = 1 (statemachine); write in data set 0. | BITMAP16 | Read/write | bit 0 = Switch on; bit 1 = Enable voltage; bit 2 = Quick stop (0 = quick stop); bit 3 = Enable operation; bit 7 = Reset fault (rising edge) | |||
| HR | 411 | Status word | BITMAP16 | Read | bit 0 = Ready to switch on; bit 1 = Switched on; bit 2 = Operation enabled; bit 3 = Error; bit 4 = Voltage enabled (mains present); bit 5 = Quick stop; bit 6 = Switch on disabled; bit 7 = Warning (see 270); bit 9 = Remote; bit 10 = Reference value reached; bit 11 = Limit value reached; bit 15 = Warning 2 (fault switch-off imminent) | ||||
| HR | 412 | Local/Remote | UINT16 | Read/write | 0 = Control via contacts; 1 = Control via statemachine (control word 410); 2 = Control via remote contacts | ||||
| HR | 414 | Data set selection | 0 = digital inputs; 1-4 = set by bus; 5 = switch only when not released. | UINT16 | Read/write | ||||
| HR | 484 | Reference frequency RAM | Long, two decimals: -999.99 to 999.99 Hz. Read/write 2 registers at 484. | INT32 | ABCD | × 0.01 | Hz | Read/write | |
| HR | 524 | Reference percentage RAM | Long, two decimals: -300.00 to 300.00 %. Read/write 2 registers at 524. | INT32 | ABCD | × 0.01 | % | Read/write | |
| HR | 1375 | Modbus parity | UINT16 | Read/write | 0 = Even; 1 = Odd; 2 = None | ||||
| HR | 1376 | Modbus address | 1-247, factory 1. | UINT16 | Read/write | ||||
| HR | 1503 | Modbus mode | UINT16 | Read/write | 0 = RTU; 1 = ASCII | ||||
| HR | 1504 | Modbus baud rate | UINT16 | Read/write | 1 = 2400; 2 = 4800; 3 = 9600; 4 = 19200; 5 = 57600; 6 = 115200; 7 = 230400 | ||||
| HR | 1505 | Modbus watchdog timer | 0 = off (factory); fault if no valid exchange in this time. | UINT16 | s | Read/write |
Notes on this map
- Word order comes from the manual's 32-bit examples: writing 44.50 Hz to parameter 482 sends 00 00 11 62 and an out-of-range value sends 00 03 0D 40, i.e. high word first.
- A 32-bit parameter occupies one parameter number: request 2 registers starting at that number (function 3 or 16); a 32-bit read with register count 1 is rejected. Function codes 100/101 also read/write 32-bit values.
- Values with decimals are sent as integers (10.3 A -> 103); the scale for 484 and 524 follows their two-decimal ranges.
- Parameters that exist in four data sets return error 9 in register 11 when read with data set 0 and the sets differ; register 11 must be read to clear an error before the next write is accepted.
- The manual does not state factory baud rate or parity, so those defaults are left null. It lists the watchdog range as 0-1000 s in one table and 0-10000 s in another.
- Left out: 282/283 reference bus/ramp frequency (actual values with no stated data type) and 392 state-transition 5 (selection list not given in this manual).
Check it against the live device. A register map tells you what the controller can expose; the unit in front of you may differ by firmware or options. Read a few registers and compare them with the unit’s own display; for a 32-bit value the float and byte-order decoder shows all four word orders at once, so a wrong word order or scale is obvious. New to this? Read what a register map is and why addresses are off by one.
Questions about the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII)
What Modbus registers does the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) have?
This map lists 17 registers: 17 holding registers. 11 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.
Are the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) Modbus addresses 0-based or 1-based?
The manufacturer's document numbers registers 0-based (the number printed is the address on the wire). Every address on this page is the 0-based wire address you put in the request; the documented number is shown under it where it differs. The start address field carries the parameter number (0-1599) in bits 0-11 and the data set (0-9) in bits 12-15, sent as-is: parameter 481 in data set 1 is 0x11E1, in data set 0 it is 0x01E1 (= 481). This map lists data set 0 addresses (parameter number). For another data set add 0x1000 x data set (data set 2 of parameter 372 = 0x2174).
What byte order does the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) use for 32-bit values?
Multi-register values in this map use ABCD (high word first (big-endian)). Set your client to this order for every 32/64-bit value in the table.
What are the minimum Modbus registers to integrate the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII)?
Start with HR 410 Control word (Control word); HR 411 Status word (Status word); HR 484 Reference frequency RAM (Frequency reference, 0.01 Hz (32-bit)); HR 412 Local/Remote (Local/Remote: 1 = statemachine); HR 260 Actual error (Actual error); HR 270 Warnings (Warnings); HR 11 VABus SST error register (Modbus error register).
How do I enable Modbus control of the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII)?
Parameter 395 Protocol picks which port runs Modbus (factory 1: X21 RJ45 = Modbus). Set 1503 mode (RTU/ASCII), 1504 baud, 1375 parity and 1376 address; these take effect immediately without a restart. Set 412 Local/Remote = 1 for control-word operation (or 2 for remote contacts). The hardware release (STOA/STOB) and a Start Right/Left digital input must still be present to reach Operation enabled.
What happens when the Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) loses Modbus communication?
1505 Modbus watchdog timer in seconds (factory 0 = off). If no correct exchange occurs within that time the inverter trips with a fault.
Where is the official Bonfiglioli Agile frequency inverter (Modbus RTU/ASCII) Modbus documentation?
The source is Modbus Communication manual - Frequency inverter 230V / 400V Agile (VEC 691 R1), revision 2011-02, published free by Bonfiglioli at https://www.bonfiglioli.com/_default_upload_bucket/AGL_Modbus_EN_VEC691R1.pdf.
More Bonfiglioli Modbus register maps
Other variable frequency drives register maps
- Variable frequency drive
Danfoss VLT HVAC Drive FC 102 (Modbus RTU)
VLT HVAC Drive FC 102 using the built-in RS-485 (FC) port with 8-30 Protocol = Modbus RTU and the FC control profile; parameter scaling checked against the software 7.61 programming guide.
Also known as: VLT HVAC Drive, FC102, FC-102 - Variable frequency drive
Eaton PowerXL DC1 compact drive (Modbus RTU)
Eaton PowerXL DC1 per the Modbus RTU communication manual MN040018EN, edition 12/22.
Also known as: DC1, PowerXL DC1, DC1-1D, DC1-12, DC1-32, DC1-34, DC1-S2 - Variable frequency drive
Hitachi WJ-C1 series inverter (Modbus RTU)
Hitachi WJ-C1 inverters using the built-in RS485 port in Modbus-RTU mode; User's Guide NT361X, chapters 11 and 18.
Also known as: WJ-C1, WJ-C1 series - Variable frequency drive
Invertek Drives Optidrive P2 (built-in Modbus RTU)
Invertek Optidrive P2 drives (0.75-250 kW) using the built-in RJ45 RS-485 Modbus RTU port, per user guide 82-P2MAN-IN V3.10.
Also known as: ODP-2, Optidrive P2 IP20, Optidrive P2 IP55, Optidrive P2 IP66 - Variable frequency drive
INVT Goodrive350 (GD350) high-performance multifunction VFD
INVT Goodrive350 drives (not GD350A) using the built-in RS-485 Modbus RTU port, per the GD350 manual V1.1 (communication chapter).
Also known as: GD350, Goodrive350, GD350 series - Variable frequency drive
Lenze SMVector drive with ESVZAR0 RS-485 Modbus module
Lenze AC Tech SMVector drives up to 10 HP with the ESVZAR0 RS-485 Modbus module, module software 1.01 / 1.10 / 1.30 (guide CMVMB401C).
Also known as: SMVector, SMV, ESVZAR0, Lenze AC Tech SMV, CMVMB401C
All variable frequency drives Modbus register maps →
Source: Modbus Communication manual - Frequency inverter 230V / 400V Agile · VEC 691 R1 · rev. 2011-02. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.