ILOGICS Built-in Command Manual

ILOGICS boards support built-in commands developed by ILOGICS. Select an ILOGICS board to use them without installing a separate library.

1. Install the ILOGICS board package. (Arduino SDK)
2. In Arduino IDE, select your board under Tools → Board.
3. Use the built-in commands.

I/O addresses in the examples depend on the product. Select the ILOGICS board definition for your product and check its pin map before using an address.

Browse by category

• Digital input filters · Edge detection and range conversion · PLC timers · Callback timers
• Counters and data buffers · High-speed counter · Analog input · Temperature input
• Analog output and PWM · PID control · Displays and RTC
• Debug and Watchdog · Communication

IdigitalRead() repeatedly samples over a short period, whereas Ibounce() checks how long the input has remained stable using millis(). Ibounce() is generally suitable for mechanical switches.

id identifies each edge detection state. Using the same id for different inputs may mix their states.

This example uses the first MPAINO-8A8R(T) input 0 and first output 64.

bool lampState = false;
 
void setup() {}
 
void loop() {
  bool button = Ibounce(0, 30);
  Ialt(button, lampState);
  digitalWrite(64, lampState); // MPAINO first digital output example
}

PLC-style timers do not pause the program like delay(). Instead, call them on every iteration of loop(). Do not reuse the same id for different timers.

This example uses the first MPAINO-8A8R(T) input 0 and first output 64.

void setup() {}
 
void loop() {
  bool run = Ibounce(0, 30);
  bool delayedOutput = Iton(0, run, 1000);
  digitalWrite(64, delayedOutput);
}

Callback functions run inside interrupts. Change only flags or short counts in callbacks; do not use delay(), Serial output, I²C, SPI or lengthy calculations.

volatile bool taskFlag = false;
 
void onTimer() {
  taskFlag = true;
}
 
void setup() {
  ItimerSet(100, onTimer);
  ItimerStart();
}
 
void loop() {
  if (taskFlag) {
    taskFlag = false;
    // Perform time-consuming work in loop().
  }
}

Keep calling counter commands in loop(). Assign each id without duplicating another counter's ID.

On MPAINO, first check the installed analog input module and DIP switch voltage/current range. Increasing the sampling rate speeds up response but may change noise and measurement characteristics.

void setup() {
  Serial.begin(115200);
  analogReadInit(IANALOG_SPS_64);
}
 
void loop() {
  int32_t raw = analogReadAvg(0, 8);
  float value = Iscalef(raw, 0.0, 32767.0, 0.0, 100.0);
  Serial.println(value);
}

NTC and PT100 use different sensor types and input circuits. Do not interchange them; verify that the selected product supports the required input.

PWM, high-speed pulses, analogWrite() and callback timers may share the same hardware timer. When combining functions, check the timer support table for the product.

void setup() {
  IpidSet(0, 2.0, 0.5, 0.1, 100, 0, 100);
}
 
void loop() {
  float pv = ntcReadf(0);
  float output = IpidRun(0, pv, 50.0);
  IanalogWritef(0, 0.0, 100.0, output);
}

PID output is only a calculated value, not a safety device. Handle sensor open circuits, overtemperature, stuck outputs and emergency stops with separate safety circuits.

For displays and RTC, call each device's Begin command first. Check I²C addresses, connection pins and sharing with other functions.

After enabling the Watchdog, delayed WDT() calls cause the board to restart. First check the worst-case communication wait and long-loop execution time.

Currently, MPINO-8A8R and MPINO-16A8R8T support the dedicated high-speed counter using timer external clock mode. For other products, check the product-specific interrupt inputs and use attachInterrupt().

void setup() {
  ImodbusRTUMem(128, 64);
  ImodbusRTUAdr(0, 0);
  ImodbusRTUInit(Serial2, 1, 9600);
}
 
void loop() {
  ImodbusRTU();
}

The Serial numbers for RS-232, RS-485 and UART may differ by product. Before communication, check port roles, electrical standards, baud rate, station number, termination resistors and DIP switch settings.

The example below uses MPAINO's first digital input 0 and first digital output 64. On MPINO, replace them with the actual Arduino pin numbers of the selected model.

const uint8_t inputChannel = 0;
const uint8_t outputChannel = 64;
 
void setup() {}
 
void loop() {
  bool stableInput = Ibounce(inputChannel, 30);
  bool delayedOutput = Iton(0, stableInput, 1000);
  digitalWrite(outputChannel, delayedOutput);
}

• Command not found: Check that the ILOGICS board package is installed and the correct product board is selected.
• I/O does not respond: Check that MPINO pin numbers and MPAINO logical channels have not been confused.
• Timer/counter stops: Check that the command is called continuously in loop() and the same id is not reused.
• Unexpected PWM frequency: Check whether another PWM, pulse or callback function is using the same hardware timer.
• Unexpected analog values: Check the voltage/current/NTC/PT100 DIP switches, channel and sampling rate.
• Communication fails: Check the Serial port, RS-232/RS-485 interface, baud rate, station number, parity and wiring.
• Board repeatedly restarts: Check for code that takes longer than the Watchdog timeout.

• Do not mix legacy #include <ILIB.h>, tempRead() or Ipt100Read() examples with the current built-in commands.
• Turn off equipment power before changing power connections or wiring. Check polarity, COM, input voltage and load power.
• Distinguish the electrical characteristics and allowable currents of relay and transistor outputs.
• Do not rely solely on program outputs for emergency stop or overcurrent protection.
• Use the relevant product manual as the final reference for pin maps, electrical specifications and supported timers.

• Product Selection Guide
• MPINO Product Features and Usage Flow
• MPAINO Module Configuration and Logical Channels
• Getting Started with Arduino IDE
• First wiring and I/O check
• Safety and Installation Precautions