
6 Message Reference
Parameters
The SSD_MSG_RESET message includes the following parameters:
•mgmt_id
The module ID of the management module to which SSD should send board status indications.
•num_boards
The maximum number of boards that ssd is required to manage. This should not exceed 4.
6.2.2SSD_MSG_RST_BOARD – Board Reset Request
Synopsis
Reset a single board and download a codefile.
Note: When using the s7_mgt protocol configuration utility, this message is generated by s7_mgt and should not be generated by the user.
Format
|
|
| MESSAGE HEADER |
|
|
|
|
| Field Name | Meaning | |
|
|
|
|
type |
|
| SSD_MSG_RST_BOARD (0x7681) |
|
|
|
|
id |
|
| board_id |
|
|
|
|
src |
|
| Sending module ID |
|
|
|
|
dst |
|
| SSD_module_ID |
|
|
|
|
rsp_req |
|
| Used to request a confirmation. |
|
|
|
|
hclass |
|
| 0 |
|
|
|
|
status |
|
| 0 |
|
|
|
|
err_info |
|
| 0 |
|
|
|
|
len |
|
| 26 |
|
|
|
|
|
|
| PARAMETER AREA |
|
|
|
|
Offset |
| Size | Name |
|
|
|
|
0 |
| 2 | board_type |
|
|
|
|
2 |
| 4 | Reserved. Must be set to 0. |
|
|
|
|
6 |
| 18 | code_file |
|
|
|
|
24 |
| 2 | run_mode |
|
|
|
|
Description
This message is used by the application during initialization (or reconfiguration) to reset a board and download the codefile that contains the operating software for the board. The download operation is supervised by the device driver that reads the binary format codefile and transfers it to the board.
The confirmation message (if requested) indicates success with a status value of 0. This implies that the reset operation has commenced, but does not imply completion. The application should then wait until a Board Status Indication message is received that indicates either successful completion of the reset and download operation or failure during the procedure.
Parameters
The SSD_MSG_RST_BOARD message includes the following parameters:
•board_type
The type of board to be reset. This must be set to 16 for DSI SS7MD Boards.
•code_file
Null terminated string giving the filename of the codefile to be downloaded to the board.
50