ThingSpeak Write

R2026b

Publish data to Internet of Things using ThingSpeak

• 

Nucleo ThingSpeak Write Block block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
STM32 Microcontroller Blockset / (Legacy) STM32 MBED Based Boards / STM32F7
STM32 Microcontroller Blockset / (Legacy) STM32 MBED Based Boards / STM32H7

Description

Use this block publish data from your target hardware to the Internet of Things using ThingSpeak™.

ThingSpeak is an IoT analytics platform service that allows you to aggregate, visualize, and analyze live data streams in the cloud. You can send data to ThingSpeak from your devices, create instant visualizations of live data, and send alerts using web services. With MATLAB^® analytics inside ThingSpeak, you can write and execute MATLAB code to perform preprocessing, visualizations, and analyses.

For more information on how to use ThingSpeak, see Apps, Plugins, or Tutorials.

Limitations

• The ThingSpeak Write and ThingSpeak Read blocks take a minimum of 700 ms for execution when you run the model in external mode. If the overall model execution time when you run the model in external mode exceeds 2 s, there can be sporadic disconnects. There is no such limitation if you run the model in the Build, load and run mode.

Ports

Input

Var1 — Send data to specified field of ThingSpeak channel

scalar | vector

The input port from which the block sends data to the ThingSpeak channel field you specify in the Fields parameter. If you do not specify a field, the block sends data fields in a sequential manner.

Input ports only accept numeric scalar signals when Numeric data is selected as Input Type and accepts ASCII vector signals when ASCII vector (uint8) is selected.

Input ports only as Input Type.

Data Types: single | uint8

Parameters

Main

Channel ID — Channel ID to which block writes data

65531 (default) | any positive integer

Specify the ThingSpeak channel to which you want to write data.

If you do not know the channel ID of your channel:

1. Sign In to ThingSpeak using your MathWorks^® Account.

2. Select Channels > My Channels.

3. Select the channel to which to you want to write data.

4. Click the Channel Settings tab.

5. Copy the channel ID from the Channel ID parameter.

   

6. Open the ThingSpeak Write block in your model and paste the copied ID to the Channel ID parameter.

Write API key — Write API key of ThingSpeak channel

ABCDEFGHIJK (default)

Specify the write API key of the ThingSpeak channel. Get the Write API Key parameter from your channel in ThingSpeak.com.

After creating a ThingSpeak channel for your target hardware:

1. In the ThingSpeak.com website, select Channels > My Channels.

2. Under the channel that you created for this target hardware, click Settings.

3. Click the API Keys tab.

4. Copy the key from Write API Key parameter.

5. Open the ThingSpeak Write block in your model and paste the API key into Write API key parameter.

Number of variables — Set number of variables to write

1 (default) | Integer between 1 to 8

Set the number of variables to write.

Input Data Type — Set ThingSpeak Write input data type

Numeric data (default) | ASCII Vector (uint8)

Select the ThingSpeak Write input data type.

Input ports only accept numeric scalar signals when Numeric data is selected as Input Data Type and ASCII vector signals when ASCII vector (uint8) is selected.

Set Minimum Update Interval — Enable minimum update interval

off (default) | on

Enable to set the minimum update interval.

Minimum update interval — Specify minimum update interval

15 (default) | Nonnegative value

Specify the minimum update interval time in seconds.

Optional

Send location information — Option to send location information

off (default) | on

Enable to send location information. Specify the location source and location.

Location source — Select location source

Block dialog (default) | Input port

Select the source of the location. When location source is set to:

• Input port - specify the location using a signal that is connected to the location block input.

• Block dialog - specify the location using the Location (latitude, longitude, altitude) parameter.

In both cases, specify the location as a cell array of three elements:

[latitude,longitude,altitude]

Use decimal degrees notation to specify latitude and longitude. Use meters to specify altitude. For example:

• The lowest human-sized point underground, the TauTona Mine in Carletonville, South Africa: [-26.416111,27.4275,-3900]

• The highest point measured from sea level, the summit of Mount Everest in Nepal: [27.988056,86.925278,8848]

Location — Specify the location as a cell array of three elements

[ 42.29971, -71.350719, 69.29 ] (default) | three-element cell array

Specify the location as a cell array of three elements:

[latitude,longitude,altitude]

Dependencies

To enable this parameter, set Location source parameter to Block dialog.

Enable field selection — Enable to select the fields to send data

off (default) | on

Enable this parameter if you want to specify the fields to send data. If this parameter is not enabled, the data is sent to the fields in a sequential order.

Fields — Field to which block sends data

[1] (default) | Array of positive integer ranging between 1 to 8

Specify the fields of the ThingSpeak channel to which the block sends data. The length of the array must be same as the number of variables to send.

Dependencies

To enable this parameter, select Enable field selection parameter.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"stmnucleof7lib/ThingSpeak Write"

"stmnucleoh7lib/ThingSpeak Write"

Example: add_block("stmnucleof7lib/ThingSpeak Write","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2021b