SPI Programming Manual (G06.24+, H06.03+, J06.03+)

Contents

SPI Programming Manual—427506-006

5. General SPI Programming

Guidelines (continued)

5. General SPI Programming Guidelines (continued)

Writing High-Level Procedures 5-8

Guidelines for SPI Requesters 5-8

Starting the Management Process 5-9

Opening the Management Process 5-10

Preparing the Command Buffer 5-11

Sending the Command 5-12

Receiving the Response 5-12

Taking Action Based on the Response 5-14

Canceling Commands 5-14

Closing the Management Process 5-14

Stopping the Management Process 5-15

Maintaining Compatibility 5-15

Summary of Requester Role 5-15

Guidelines for SPI Servers 5-16

Recommending a Buffer Size 5-16

Defining Simple Tokens 5-17

Defining Extensible Structured Tokens 5-19

Coding Subsystem Definitions 5-23

Using the SPI Standard DDL Definitions 5-24

Suggestions on Data Representation 5-24

Dividing Your Definition File Into Sections 5-26

Version Compatibility 5-27

Defining Objects 5-28

Subsystem ID 5-29

Checking the Command Message for Validity 5-31

Checking Whether Your Subsystem Can Process the Command 5-31

Checking Tokens in the Command 5-32

Checking for Command Cancellation 5-37

Using SSPUT to Place Lists in the Buffer 5-38

Defining Commands 5-39

GETVERSION Command 5-39

Single and Multiple Response Records per Response 5-40

Defining the Context Token 5-40

Context Sensitivity 5-43

Determining How Many Response Records Fit in a Buffer 5-43

Consistency Between Response Records in Different Replies 5-45

Checking the Context Token 5-46

Reporting Errors 5-46