Arduino Chart Shield acts as Arduino Shield via 1Sheeld

Buy 1Sheeld

 

Turn your smartphone into a chart plotter shield for Arduino. Chart shield allows your Arduino to plot values (sensors, variables, etc.) and display them over time.

 

*Supported by IOS application only.

 

This shield is one of the special shields. Special shields allows your Arduino board to use some capabilities your smartphone can do, like playing music, taking a picture, getting notifications, accessing the clock data and using the touch screen for various functions. Learn more from the special shields tutorial.

Chart shield displays variables/sensors values through interval of seconds once plotting is started.

Adding #define CUSTOM_SETTINGS along with #define INCLUDE_CHART_SHIELD is a key that will let you unlock chart shield only among all shields, preventing 1Sheeld library from eating your memory especially for UNO board.

Notes

-There are 5 chart instances (indexed 0-4) where you can plot values simultaneously.
-Each chart can hold max 5 keys.
-Each chart has max 10000 plots, once reached a (.csv) file is created with the previous values, then values deleted from phone’s memory & chart view for new upcoming plots,avoiding excessive memory consumption.

void clear(byte)

Clears chart given its ID.

 

SYNTAX
Chart.clear(chartID);

 

RETURN
None.

 

PARAMETERS
ID of chart.

 

USAGE
Chart.clear(CHART_0);

 

void add(const char *,float,byte)

-Add key (name,value) to certain chart given it’s ID.
-You can plot 5 max keys at a time otherwise any other additions will not be plotted.
-If two added keys has the same name and chartID it will be dealt as one key and its value will be updated with the newest value.
-Not giving the chart ID will plot data over chart 0 by default.

 

LITERALS
CHART_0
CHART_1
CHART_2
CHART_3
CHART_4

 

SYNTAX
Chart.add(keyName,KeyValue,chartID);

 

RETURN
None.

 

PARAMETERS
-Key name.
-Key value.
-Chart ID.

 

USAGE
Chart.add("Mic/db",micValues,CHART_0);

 

void plot(void)

Plot added data to chart.

 

SYNTAX
Chart.plot();

 

RETURN
None.

 

PARAMETERS
None.

 

USAGE
Chart.plot();

 

void saveCsv(const char *,byte)

-Save current plotted data to (.csv) file.
-Not giving the chart ID will save data displayed over chart 0 by default.

 

SYNTAX
Chart.saveCsv(fileName,chartID);

 

RETURN
None.

 

PARAMETERS
-File name.
-ChartID.

 

USAGE
Chart.saveCsv("Mic_Values",CHART_0);

 

void saveScreenshot(byte)

-Save a screenshot for certain chart.
-Not giving the chart ID will save screenshot for chart 0 by default.

 

SYNTAX
Chart.saveScreenshot(chartID);

 

RETURN
None.

 

PARAMETERS
-ChartID.

 

USAGE
Chart.saveScreenshot(CHART_0);

 

void autoScroll(byte)

-Activate/Deactivate screen scrolling while plotting new data.

 

LITERALS
OFF/ON

 

SYNTAX
Chart.autScroll(OFF/ON);

 

RETURN
None.

 

PARAMETERS
OFF or ON.

 

USAGE
Chart.autoScroll(OFF);