TalkBack Write

R2026b

Write command(s) to TalkBack ID on ThingSpeak TalkBack server

• 

TalkBack Write 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:
Raspberry Pi Blockset / Internet Of Things

Description

The TalkBack Write block writes command(s) to a TalkBack ID on the ThingSpeak TalkBack server. The block writes commands to the TalkBack queue in the first-in first-out (FIFO) order and are removed from the queue once executed.

Note

To generate C/C++ code for this block, you must have an Embedded Coder^® license.

Examples

Control LED Status Using ThingSpeak TalkBack on Raspberry Pi

Use Raspberry Pi® Blockset to fetch and execute commands from a ThingSpeak™ TalkBack queue and use them to change the status of an LED onboard a Raspberry Pi hardware board.

• Open Model

Ports

Input

Trigger — Trigger to add or delete command in TalkBack queue

0 | any value greater than 0

Input to the TalkBack queue or delete all commands in the TalkBack queue.

Data Types: Boolean | Numeric

Command string — String command to be added by the block

scalar

String command to be added by the block specified as a scalar.

Dependencies

To enable this port, set Command type to String and TalkBack API to Add a command.

Data Types: string

Ascii command — ASCII command to be added by the block

vector

ASCII command to be added by the block, specified as a vector.

Dependencies

To enable this port, set Command type to ASCII vector and TalkBack API to Add a command.

Data Types: uint8

Position — Position of command in queue

integer

Position of the TalkBack command in the TalkBack queue. Any previous commands at or after this position are shifted down in the queue, if you do not specify a position. The block adds the command to the end of the queue with the highest position.

Dependencies

To enable this port, set the TalkBack API parameter to Add a command and select the Specify position parameter.

Data Types: uint16

Parameters

TalkBack API — Add or delete commands in TalkBack queue

Add a command (default) | Delete all commands

Select the type of operation you want to perform on the TalkBack queue.

• Add a command — Add a command to the TalkBack queue

• Delete all commands — Delete all commands from the TalkBack queue

TalkBack ID — TalkBack app identification number

123456 (default) | positive integer

Enter the identification number of the TalkBack app. This identification number is autogenerated by the TalkBack server. To find the TalkBack ID for your TalkBack channel:

1. On the ThingSpeak website, select Apps > TalkBack.

2. Click New TalkBack.

3. Add a new command to the TalkBack queue and copy the TalkBack ID.

4. Open the TalkBack Write block in your Simulink^® model and paste the value in the TalkBack ID parameter.

API key — Autogenerated API key for TalkBack channel

character vector | string scalar

Click Enter securely to enter a 16-digit API key for the specific instance of TalkBack that allows you to write to a TalkBack channel. This API key is autogenerated by the TalkBack server. To find the API key for your TalkBack channel:

1. On the ThingSpeak website, select Apps > TalkBack.

2. Click New TalkBack.

3. Add a new command to the TalkBack queue and copy the 16-digit API key.

4. Open the TalkBack Write block in your Simulink model and paste the value in the API key parameter.

Command type — Type of command added to TalkBack queue

String (default) | ASCII vector

Select the type of TalkBack command you want the block to add to the TalkBack queue.

• String — TalkBack command in string format.

• ASCII vector — TalkBack command in ASCII format.

Dependencies

To enable this port, set the TalkBack API parameter to Add a command.

Specify position — Enable or disable position input port

off (default) | on

Select the option to enable the position input port of the block.

Dependencies

To enable this port, select the TalkBack API parameter to Add a command.

Print diagnostic messages — Save TalkBack server response to log file

off (default) | on

Select this parameter to save the response from the TalkBack server to a log file for each read request. Identify this request with a header named TALKBACK_DIAG_MSG:. The name of the log file has the format <model_name>.log.

Programmatic Use: Add Block

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

"raspberrypiIOTlib/TalkBack Write"

Example: add_block("raspberrypiIOTlib/TalkBack Write","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

To generate C/C++ code for this block, you must have an Embedded Coder license. For more information on selecting the right product stack according to your development goals, see Product Stack for Raspberry Pi Blockset.

Version History

Introduced in R2021b