====== IanalogRead2f() ======

''IanalogRead2f()'' converts the 4~20mA input value to the specified floating-point range.

{{:en-us_commands:reference:ianalogread2f.svg?900|IanalogRead2f command operation flow}}

''float IanalogRead2f(uint8_t ch, float min, float max)''

===== Commands =====

^ Command ^ Arguments ^ Return Value ^ Operation ^
| ''IanalogRead2f(ch, min, max)'' | ''uint8_t ch'' — MPINO: analog pin such as ''A0''; MPAINO: overall module channel number starting at ''0''\\ ''float min''\\ ''float max'' | ''float'' | Converts the 4~20mA input value to the specified floating-point range. |


===== Example =====

Connect an X input module to MPAINO-8A8R(T) and select **Analog Input Module → X**. Set CH0 DIP switches 20mA and GND to ON, then connect the 4–20mA signal.

<code cpp>
void setup() {
  Serial.begin(115200);
}

void loop() {
  const float value = IanalogRead2f(0, 4.0F, 20.0F);  // Scale the CH0 4–20mA input to milliamps.
  if (value == (float)ANALOG_READ2_ERROR) {
    Serial.println(F("4-20mA input error"));
  } else {
    Serial.println(value, 2);
  }
  delay(500);
}
</code>

===== Precautions =====

  * Set the MPAINO X module CH0 DIP switches 20mA and GND to ON, and wire the current input with the correct polarity.
  * An input of approximately 3.6~4.0mA returns the normal value ''0''; inputs below 3.6mA return an error value.
  * Error values help detect open circuits. The user must implement final alarms and safety actions in the program.
  * ''IanalogRead2()'' and ''IanalogRead2f()'' also return ''65535'' on error, rather than a user-range value. Check for errors before using the result.
  * The full ''int32_t'' range is available for ''min~max'' in ''IanalogRead2()'', but if the normal range includes ''65535'', it cannot be distinguished from an error value.
  * ''analogRead2Avgf()'' uses state and a buffer separate from ''analogRead2Avg()''. Using both increases SRAM usage.
  * If ''samples'' is ''0'' or memory allocation fails in ''analogRead2Avgf()'', it returns the current valid corrected value as a ''float''.
  * On MPINO, do not use ''analogRead2()'' on voltage/NTC channels that are not 4~20mA inputs.
  * For MPINO products requiring ''analogReference(EXTERNAL)'', set it first in ''setup()''.
  * ''IanalogWrite2()'' and ''IanalogWrite2f()'' are convenience outputs dedicated to 4~20mA. Avoid alternating them with ''IanalogWrite()'' on the same channel.
  * The analog output circuit requires an external 12~24V supply. USB power alone may not provide normal output.
  * Verify actual current input/output with measuring instruments after preparing a test product.

===== Built-in Commands in the Same Category =====

  * [[:en-us_commands:reference:ianalogread2|IanalogRead2() View detailed description]]

[[:en-us_commands:builtin|← Built-in Command List]]