Opens an outbound SDTI serial connection.
Response: After the SDTI has processed the system call, it will respond with BIOS_SDTI_OUT_RESP. If BIOS_SDTI_OUT_RESP returned without an error, after the connection has been closed, it will also respond with BIOS_SDTI_CLOSE.
llMessageLinked(LINK_ROOT, [ident], "BIOS_SDTI_OUT", [object_uuid] + "|" + [memory_bank] + "|" + [memory_identifier] + "|" + [start] + "|" + [end] + "|" + [packet_size]);
| • target | LINK_ROOT |
| • integer | [ident] |
| • key | [object_uuid]|[memory_bank]|[memory_identifier]|[start]|[end]|[packet_size] |
| Parameter | Description |
|---|---|
[ident] |
Integer. Must be the same value as sent with BIOS_SDTI_IN in the receiving object. SDTI does not facilitate the exchange of the [ident] value; that must be performed by other software. |
[object_uuid] |
String. Must be either blank, NULL_KEY, or the UUID of the object to connect to. If left blank or NULL_KEY, the SDTI will attempt to connect to any object that will accept a connection with the same [ident]; otherwise, the SDTI will only attempt to connect to the UUID passed in this call. |
[memory_bank] |
Integer cast as string. Must be the memory bank number that has been assigned to send data over the SDTI connection. |
[memory_identifier] |
String. Must be the same string as the [identifier] that was passed to BIOS_RAM_ALLOCATE when allocating the memory bank identified by [memory_bank]. |
[start] |
Integer cast as string. Must be the start index of the data to send from the memory bank. May be positive or negative. Negative values will count from the end of the memory bank. |
[end] |
Integer cast as string. Must be the end index of the data to send from the memory bank. May be positive or negative. Negative values will count from the end of the memory bank. This value, as well as [start], will be passed via BIOS_RAM_OP using an "R" (read) command.This value, in combination with [start], will be automatically validated against the maximum memory available in the receiving object before sending data.To send all contents of the memory bank, use [start] of 0 and [end] of -1. |
[packet_size] |
Integer cast as string. Must be the serial data packet size - between 1 and 500, inclusive - or 0. A value of 0 (or a blank/omitted string) will use the default maximum value, which is currently 500 but may change in the future. This should only be changed if the receiving object cannot handle more than 500 characters of data at once. All official Mark 1 components accept the maximum, so this should be left as 0 or blank in virtually all cases to take advantage of the highest possible transfer speed. |