SERIAL_SINGLE_MEASUREMENT

Takes a single reading of data from a serial device (e.g. Arduino). If the data is comma seperated (e.g. 25,26,27) with multiple measurements, a Vector is returned. You should use the VECTOR_INDEXING node to choose the specific measurement you want. Params: device : SerialDevice Defines the communication port on which the serial device is connected. Returns: out : Vector The output from the serial device.

Python Code

from typing import Optional
from numpy import array
from flojoy import Vector, SerialDevice, flojoy, DataContainer


@flojoy(inject_connection=True)
def SERIAL_SINGLE_MEASUREMENT(
    connection: SerialDevice,
    default: Optional[DataContainer] = None,
) -> Vector:
    """Takes a single reading of data from a serial device (e.g. Arduino).

    If the data is comma seperated (e.g. 25,26,27) with multiple measurements,
    a Vector is returned. You should use the VECTOR_INDEXING node to choose
    the specific measurement you want.

    Parameters
    ----------
    device : SerialDevice
        Defines the communication port on which the serial device is connected.

    Returns
    -------
    Vector
        The output from the serial device.
    """

    ser = connection.get_handle()

    s = ""
    while s == "":
        s = ser.readline().decode()

    reading = s[:-2].split(",")
    reading = array(reading)  # Create an array
    reading = reading.astype("float64")  # Convert the array to float

    ser.flush()

    return Vector(v=reading)

Find this Flojoy Block on GitHub

Videos

Arduino Temperature Sensor

Example

Having problems with this example app? Join our Discord community and we will help you out!

Press enter or space to select a node.You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Download this Flojoy App

In this example, we use the SERIAL_SINGLE_MEASUREMENT node to extract some measurements received from an Arduino microcontroller and visualize the output.

First, you need to connect the Arduino to your computer. Then, you’ll need to upload an Arduino script to your board to define its behavior (with the Arduino IDE software). When your Arduino sends data to the serial monitor of the Arduino IDE, you can start using the SERIAL_SINGLE_MEASUREMENT node. After placing the node on Flojoy, you must specify the communication port to which the Arduino is connected. This port is found in the Arduino IDE software under Tools/Port.

The SERIAL_SINGLE_MEASUREMENT node receives data through serial communication with the Arduino, and stores the measured values in a table called reading. The Arduino then prints new values on the serial console for each loop. The SERIAL_SINGLE_MEASUREMENT node extracts a measurement (which can contain single or multiple values, as seen in the output).

The TABLE node displays all values stored in the single measurement.

Remarks about the Arduino code:

This example works with the arduino_example.ino Arduino code (see Appendix).

The last line that the Arduino should return, is the data with a new line at the end (i.e. println()).

For example:

print(reading0)
print(",")
println(reading1)

The SERIAL_SINGLE_MEASUREMENT node receives data from the Arduino serial console as a string and splits it using ”,” as a separator. It then returns the values measured in a list called reading.

Update the Single Measurement with a Loop:

To update the values received from the Arduino, use the LOOP node to create a loop around the SERIAL_SINGLE_MEASUREMENT and TABLE nodes.

The loop allows the user to update measurements, but only the last measurement will be saved and displayed.

To record all the measurements for a given period, use the SERIAL_TIMESERIES node.