SPI Programming Manual (H06.24+, J06.13+)

Contents
SPI Programming Manual—427506-007
v
5. General SPI Programming Guidelines
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
Control of Types of Response Records
5-47
Continuing Despite Errors
5-47
Reporting Errors From the SPI Procedures 5-47
Pass-Through Error Lists
5-51
Summary of Server Role 5-54