#include <modbus_controller.h>

Public Member Functions
bool	send ()

bool	is_equal (const ModbusCommandItem &other)

Static Public Member Functions
static ModbusCommandItem	create_read_command (ModbusController *modbusdevice, ModbusRegisterType register_type, uint16_t start_address, uint16_t register_count, std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&handler)
	factory methods More...

static ModbusCommandItem	create_read_command (ModbusController *modbusdevice, ModbusRegisterType register_type, uint16_t start_address, uint16_t register_count)
	Create modbus read command Function code 02-04. More...

static ModbusCommandItem	create_write_multiple_command (ModbusController *modbusdevice, uint16_t start_address, uint16_t register_count, const std::vector< uint16_t > &values)
	Create modbus read command Function code 02-04. More...

static ModbusCommandItem	create_write_single_command (ModbusController *modbusdevice, uint16_t start_address, uint16_t value)
	Create modbus write multiple registers command Function 16 (10hex) Write Multiple Registers. More...

static ModbusCommandItem	create_write_single_coil (ModbusController *modbusdevice, uint16_t address, bool value)
	Create modbus write single registers command Function 05 (05hex) Write Single Coil. More...

static ModbusCommandItem	create_write_multiple_coils (ModbusController *modbusdevice, uint16_t start_address, const std::vector< bool > &values)
	Create modbus write multiple registers command Function 15 (0Fhex) Write Multiple Coils. More...

static ModbusCommandItem	create_custom_command (ModbusController *modbusdevice, const std::vector< uint8_t > &values, std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&handler=nullptr)
	Create custom modbus command. More...

static ModbusCommandItem	create_custom_command (ModbusController *modbusdevice, const std::vector< uint16_t > &values, std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&handler=nullptr)
	Create custom modbus command. More...

Data Fields
ModbusController *	modbusdevice

uint16_t	register_address

uint16_t	register_count

ModbusFunctionCode	function_code

ModbusRegisterType	register_type

std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)>	on_data_func

std::vector< uint8_t >	payload = {}

uint8_t	send_countdown {MAX_SEND_REPEATS}

Static Public Attributes
static const size_t	MAX_PAYLOAD_BYTES = 240

static const uint8_t	MAX_SEND_REPEATS = 5

Detailed Description

Definition at line 296 of file modbus_controller.h.

Member Function Documentation

◆ create_custom_command() [1/2]

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_custom_command	(	ModbusController *	modbusdevice,
		const std::vector< uint8_t > &	values,
		std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&	handler = `nullptr`
	)

static

Create custom modbus command.

Parameters

modbusdevice	pointer to the device to execute the command
values	byte vector of data to be sent to the device. The complete payload must be provided with the exception of the crc codes
handler	function called when the response is received. Default is just logging a response

Returns: ModbusCommandItem with the prepared command

Definition at line 461 of file modbus_controller.cpp.

◆ create_custom_command() [2/2]

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_custom_command	(	ModbusController *	modbusdevice,
		const std::vector< uint16_t > &	values,
		std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&	handler = `nullptr`
	)

static

Create custom modbus command.

Parameters

modbusdevice	pointer to the device to execute the command
values	word vector of data to be sent to the device. The complete payload must be provided with the exception of the crc codes
handler	function called when the response is received. Default is just logging a response

Returns: ModbusCommandItem with the prepared command

Definition at line 480 of file modbus_controller.cpp.

◆ create_read_command() [1/2]

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_read_command	(	ModbusController *	modbusdevice,
		ModbusRegisterType	register_type,
		uint16_t	start_address,
		uint16_t	register_count,
		std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&	handler
	)

static

factory methods

Create modbus read command Function code 02-04

Parameters

modbusdevice	pointer to the device to execute the command
function_code	modbus function code for the read command
start_address	modbus address of the first register to read
register_count	number of registers to read
handler	function called when the response is received

Returns: ModbusCommandItem with the prepared command

Definition at line 342 of file modbus_controller.cpp.

◆ create_read_command() [2/2]

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_read_command	(	ModbusController *	modbusdevice,
		ModbusRegisterType	register_type,
		uint16_t	start_address,
		uint16_t	register_count
	)

static

Create modbus read command Function code 02-04.

Parameters

modbusdevice	pointer to the device to execute the command
function_code	modbus function code for the read command
start_address	modbus address of the first register to read
register_count	number of registers to read

Returns: ModbusCommandItem with the prepared command

Definition at line 356 of file modbus_controller.cpp.

◆ create_write_multiple_coils()

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_write_multiple_coils	(	ModbusController *	modbusdevice,
		uint16_t	start_address,
		const std::vector< bool > &	values
	)

static

Create modbus write multiple registers command Function 15 (0Fhex) Write Multiple Coils.

Parameters

modbusdevice	pointer to the device to execute the command
start_address	modbus address of the first register to read
value	bool vector of values to be written to the registers

Returns: ModbusCommandItem with the prepared command

Definition at line 410 of file modbus_controller.cpp.

◆ create_write_multiple_command()

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_write_multiple_command	(	ModbusController *	modbusdevice,
		uint16_t	start_address,
		uint16_t	register_count,
		const std::vector< uint16_t > &	values
	)

static

Create modbus read command Function code 02-04.

Parameters

modbusdevice	pointer to the device to execute the command
function_code	modbus function code for the read command
start_address	modbus address of the first register to read
register_count	number of registers to read
handler	function called when the response is received

Returns: ModbusCommandItem with the prepared command

Definition at line 372 of file modbus_controller.cpp.

◆ create_write_single_coil()

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_write_single_coil	(	ModbusController *	modbusdevice,
		uint16_t	address,
		bool	value
	)

static

Create modbus write single registers command Function 05 (05hex) Write Single Coil.

Parameters

modbusdevice	pointer to the device to execute the command
start_address	modbus address of the first register to read
value	uint16_t data to be written to the registers

Returns: ModbusCommandItem with the prepared command

Definition at line 393 of file modbus_controller.cpp.

◆ create_write_single_command()

ModbusCommandItem esphome::modbus_controller::ModbusCommandItem::create_write_single_command	(	ModbusController *	modbusdevice,
		uint16_t	start_address,
		uint16_t	value
	)

static

Create modbus write multiple registers command Function 16 (10hex) Write Multiple Registers.

Parameters

modbusdevice	pointer to the device to execute the command
start_address	modbus address of the first register to read
register_count	number of registers to read
value	uint16_t single register value to write

Returns: ModbusCommandItem with the prepared command

Definition at line 442 of file modbus_controller.cpp.

◆ is_equal()

bool esphome::modbus_controller::ModbusCommandItem::is_equal ( const ModbusCommandItem & other )

Definition at line 514 of file modbus_controller.cpp.

◆ send()

bool esphome::modbus_controller::ModbusCommandItem::send ( )

Definition at line 502 of file modbus_controller.cpp.

Field Documentation

◆ function_code

ModbusFunctionCode esphome::modbus_controller::ModbusCommandItem::function_code

Definition at line 303 of file modbus_controller.h.

◆ MAX_PAYLOAD_BYTES

const size_t esphome::modbus_controller::ModbusCommandItem::MAX_PAYLOAD_BYTES = 240

static

Definition at line 298 of file modbus_controller.h.

◆ MAX_SEND_REPEATS

const uint8_t esphome::modbus_controller::ModbusCommandItem::MAX_SEND_REPEATS = 5

static

Definition at line 299 of file modbus_controller.h.

◆ modbusdevice

ModbusController* esphome::modbus_controller::ModbusCommandItem::modbusdevice

Definition at line 300 of file modbus_controller.h.

◆ on_data_func

std::function<void(ModbusRegisterType register_type, uint16_t start_address, const std::vector<uint8_t> &data)> esphome::modbus_controller::ModbusCommandItem::on_data_func

Definition at line 306 of file modbus_controller.h.

◆ payload

std::vector<uint8_t> esphome::modbus_controller::ModbusCommandItem::payload = {}

Definition at line 307 of file modbus_controller.h.

◆ register_address

uint16_t esphome::modbus_controller::ModbusCommandItem::register_address

Definition at line 301 of file modbus_controller.h.

◆ register_count

uint16_t esphome::modbus_controller::ModbusCommandItem::register_count

Definition at line 302 of file modbus_controller.h.

◆ register_type

ModbusRegisterType esphome::modbus_controller::ModbusCommandItem::register_type

Definition at line 304 of file modbus_controller.h.

◆ send_countdown

uint8_t esphome::modbus_controller::ModbusCommandItem::send_countdown {MAX_SEND_REPEATS}

Definition at line 311 of file modbus_controller.h.

The documentation for this class was generated from the following files:

/opt/build/esphome/esphome/components/modbus_controller/modbus_controller.h
/opt/build/esphome/esphome/components/modbus_controller/modbus_controller.cpp

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Detailed Description

Member Function Documentation

◆ create_custom_command() [1/2]

◆ create_custom_command() [2/2]

◆ create_read_command() [1/2]

◆ create_read_command() [2/2]

◆ create_write_multiple_coils()

◆ create_write_multiple_command()

◆ create_write_single_coil()

◆ create_write_single_command()

◆ is_equal()

◆ send()

Field Documentation

◆ function_code

◆ MAX_PAYLOAD_BYTES

◆ MAX_SEND_REPEATS

◆ modbusdevice

◆ on_data_func

◆ payload

◆ register_address

◆ register_count

◆ register_type

◆ send_countdown