---
title: Omron E5 Temperature Controller Device
description: Documentation for the Omron E5 temperature controller device component
keywords: [omron, e5, temperature, controller, modbus, rs485]
---

## OmronE5Device

**Path**: [src/components/OmronE5Device.cpp](../src/components/OmronE5Device.cpp)

**Revision History**: Initial documentation

The OmronE5Device component provides an interface for controlling and monitoring Omron E5 temperature controllers via Modbus RTU over RS485. It allows reading current temperature values, setting target temperatures, and managing controller status and parameters.

## REQUIREMENTS

### Hardware
- RS485 communication interface
- Omron E5 temperature controller with Modbus RTU support

### Software
- RS485 driver component
- Modbus RTU implementation

## FEATURES

- Reading current temperature (Process Value - PV)
- Setting target temperature (Set Point - SP)
- Reading controller status
- Setting controller parameters (PID values, alarm thresholds, etc.)
- Auto-tuning control
- Run/Stop control
- Error handling and status reporting
- Support for multiple temperature controllers on the same RS485 bus

## DEPENDENCIES

- [Component](../src/Component.h) - Base component class
- [RS485](../src/components/RS485.h) - RS485 communication interface
- [OmronE5Types](../src/components/OmronE5Types.h) - Omron E5 register definitions and constants

```mermaid
graph TD
    OmronE5Device --> Component
    OmronE5Device --> RS485
    OmronE5Device --> OmronE5Types
```

## BEHAVIOUR

The OmronE5Device component manages communication with an Omron E5 temperature controller through a state machine pattern:

```mermaid
stateDiagram-v2
    [*] --> Initialize
    Initialize --> Ready: Device configured
    Ready --> Reading: Read request
    Ready --> Writing: Write request
    Reading --> Processing: Data received
    Writing --> Processing: Command sent
    Processing --> Ready: Complete
    Processing --> Error: Timeout/Error
    Error --> Ready: Reset
```

## TODOS

### PERFORMANCE

- Implement batched read/write operations to improve communication efficiency
- Optimize polling frequency based on application requirements
- Consider implementing caching of infrequently changing parameters

### SECURITY

- Implement validation for all input parameters before sending to the device
- Consider adding authentication for critical operations (if supported by the device)
- Add bounds checking for all register values

### COMPLIANCE

- Ensure compliance with Modbus RTU protocol specifications
- Validate implementation against Omron E5 communications manual
- Consider implementing safety measures for temperature-critical applications

### RECOMMENDATIONS

- Use appropriate timeout settings based on the network configuration
- Implement error recovery mechanisms for communication failures
- Consider implementing a monitoring system for device health
- Use appropriate error checking and retries for industrial environments

## EXAMPLE

```cpp
// Example from OmronE5Manager.cpp
#ifdef ENABLE_OMRON_E5
  // Create 8 Omron E5 devices
  for (uint8_t i = 0; i < NUM_OMRON_DEVICES; i++)
  {
    omronDevices[i] = new OmronE5Device(
        this,                       // owner
        rs485,                      // RS485 interface
        OMRON_E5_SLAVE_ID_BASE + i, // Modbus slave ID
        COMPONENT_KEY::COMPONENT_KEY_RELAY_0 + i // Component ID
    );

    if (omronDevices[i])
    {
      components.push_back(omronDevices[i]);
      Log.infoln(F("Omron E5 device %d initialized. SlaveID: %d"), 
                 i, OMRON_E5_SLAVE_ID_BASE + i);
      
      // Set default parameters
      omronDevices[i]->setTargetTemperature(25.0);
      omronDevices[i]->start();
    }
    else
    {
      Log.errorln(F("Omron E5 device %d initialization failed."), i);
    }
  }
#endif
```

### References

- Omron E5_C Communications Manual (H175)
- Modbus RTU Protocol Specification