mg_pg_sw-simpl-plus.pdf

Crestron® SIMPL+® Software

Programming Guide

Crestron Electronics, Inc.

Original Instructions

The U.S. English version of this document is the original instructions.

All other languages are a translation of the original instructions.

Crestron product development software is licensed to Crestron dealers and Crestron Service Providers (CSPs)

under a limited nonexclusive, nontransferable Software Development Tools License Agreement. Crestron

product operating system software is licensed to Crestron dealers, CSPs, and end-users under a separate End-

Crestron, the Crestron logo, 3-Series Control System, Crestron Toolbox, and SIMPL+ are either trademarks or

registered trademarks of Crestron Electronics, Inc. in the United States and/or other countries. Other

trademarks, registered trademarks, and trade names may be used in this document to refer to either the

entities claiming the marks and names or their products. Crestron disclaims any proprietary interest in the

marks and names of others. Crestron is not responsible for errors in typography or photography.

©2020 Crestron Electronics, Inc.

Contents

Introduction 1

What is SIMPL+? 1

For Whom is this Guide Intended? 1

Compiler Directives 7

Include Libraries 8

Variable Declarations 9

Inputs, Outputs, and Parameters 9

Variables 10

Structures 11

User-Defined Functions 11

Event Functions 12

Push and Release Events 12

Change Events 13

Analog Inputs/Outputs 16

String Inputs/Outputs and Buffer Inputs 17

Signal Scope 17

All About Variables 19

Integers 19

Strings 21

Variable Scope 22

Arrays 23

Operators, Expressions, and Statements 25

Operators 25

Controlling Program Flow: Branching 28

if-else 28

switch-case 30

Controlling Program Flow: Loops 32

for Loops 32

while and do-until Loops 33

Exiting from Loops Early 35

Using System Functions 36

Function Definitions 37

Defining Local Variables In Functions 39

Passing Variables to Functions as Arguments 40

ByRef, ByVal, and ReadOnlyByRef 41

Functions That Return Values 42

Function Libraries 44

Removable Media Functions 45

CheckForDisk and WaitForNewDisk 45

BUFFER_INPUT 52

Removing Data From Buffers 53

Understanding Processing Order 56

How SIMPL+ and SIMPL Interact 56

Forcing a Task Switch 56

Debugging 57

Compiler Errors 57

Run-time Errors 57

Debugging with Print() 58