Device commands, Ommand, Ypes – Quantum Composers Jewel Laser User Manual

Page 21

Advertising
background image

Jewel Manual v1.1 | Quantum Composers

Page 21

Device Command Format

All commands use ASCII characters and are composed of the following fields:

<Prefix><Address>< Delimiter ><Command String>[Parameters]<Terminator>

Device Addresses

Address

Device

LA

Laser

COMMAND TYPES

There are two types of commands -- those that set a value or initiate an action (control

commands), and those that request information (query commands). Each device must respond in

the proper manner to each type of command.

Control Commands

A device must always parse a control command and return a response immediately.

If the command is a recognized command and the parameter is valid, then the device

returns an "OK<CR>".

If the command is not recognized, then the device responds with a "?1<CR>".

If the command is recognized, but the parameter value is missing or invalid, then the device

responds with a "?4” or “?5”.

7.

DEVICE COMMANDS

Field

Description

Prefix

Single semicolon character ";", must precede all commands. All

devices will reset their command input buffer when the prefix is

received.

Address

2 ASCII characters. Each device has a unique address which is

programmed into its firmware. See the table below for a list of

addresses.

Delimiter

Single colon character “:”, must follow device address.

Command

String

Commands are specific to each device -- see the following

sections for the commands that each device supports.

Parameters (optional field) Some commands may not require a parameter.

For Query commands immediately follow the command string with

the question mark character ”?”. For non-query commands

immediately follow the command string with a single space

character ” “ followed by the parameter. Multiple commands are

separated by commas.

Terminator ASCII carriage return character (ODh). The receiving device does

not process any commands until the terminator is received.

Advertising