Difference between revisions of "Econet packet"
m (1 revision) |
m (Corrected some typos.) |
||
(One intermediate revision by one other user not shown) | |||
Line 9: | Line 9: | ||
<-------- - - Packet Header - - ---------> <--- - - Packet Data - - ---> | <-------- - - Packet Header - - ---------> <--- - - Packet Data - - ---> | ||
− | The Control Byte is sometimes | + | The Control Byte is sometimes referred to as the Flag Byte. |
===Econet Frames=== | ===Econet Frames=== | ||
Line 68: | Line 68: | ||
===Immediates=== | ===Immediates=== | ||
Immediate operations are sent as an extended scout frame with four bytes of | Immediate operations are sent as an extended scout frame with four bytes of | ||
− | data. | + | data sent to port &00. |
Immediates (Port=&00), 10-byte Scout: | Immediates (Port=&00), 10-byte Scout: | ||
Line 81: | Line 81: | ||
What follows the immediate scout depends on the immediate operation, as follows: | What follows the immediate scout depends on the immediate operation, as follows: | ||
− | + | Ctrl Action | |
&81 PEEK Scout->, <-Data | &81 PEEK Scout->, <-Data | ||
&82 POKE Scout->, <-Ack, Data->, <-Ack | &82 POKE Scout->, <-Ack, Data->, <-Ack | ||
Line 113: | Line 113: | ||
passed to the network transmission system to send to the file server as | passed to the network transmission system to send to the file server as | ||
follows, equivalent to OSWORD &10: | follows, equivalent to OSWORD &10: | ||
− | + | +------+------+-----+-----+---------------+---------------+ | |
− | + | | Ctrl | Port | FS | FS | Command Block | Command Block | | |
− | | | + | | &80 | &99 | Stn | Net | Start Address | End Address+1 | |
− | + | +------+------+-----+-----+---------------+---------------+ | |
+ | The control byte is used to pass sequence numbers for sequential operations | ||
+ | such as GetByte, PutByte, etc. | ||
This gets encapsulated as an Econet packet as follows: | This gets encapsulated as an Econet packet as follows: |
Latest revision as of 00:26, 30 May 2024
Econet Packet
An Econet packet looks like this:
+------+------+-----+-----+---------+------+-----------------------------+ | Dest | Dest | Src | Src | Control | Port | Data | | Stn | Net | Stn | Net | Byte | | | +------+------+-----+-----+---------+------+-----------------------------+ <-------- - - Packet Header - - ---------> <--- - - Packet Data - - --->
The Control Byte is sometimes referred to as the Flag Byte.
Econet Frames
The Econet system sends a packet in four frames using a four-way handshake which the 6454 ADLC puts on the wire as follows:
Scout: +---------+-----------------------------+-----+-----+---------+ | |+----+----+---+---+----+----+| | | | | Opening ||Dest|Dest|Src|Src|Ctrl|Port|| CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|Byte| || | | Flag | | |+----+----+---+---+----+----+| | | | +---------+-----------------------------+-----+-----+---------+ <--- - Packet Header - --->
Scout acknowledge sent back: +---------+-------------------+-----+-----+---------+ | |+----+----+---+---+| | | | | Opening ||Dest|Dest|Src|Src|| CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|| | | Flag | | |+----+----+---+---+| | | | +---------+-------------------+-----+-----+---------+ Where Dest and Src are opposite to Scout frame
Data: +---------+-------------------+--------+-----+-----+---------+ | |+----+----+---+---+| | | | | | Opening ||Dest|Dest|Src|Src|| Packet | CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|| Data | | | Flag | | |+----+----+---+---+| | | | | +---------+-------------------+--------+-----+-----+---------+
Data acknowledge sent back: +---------+-------------------+-----+-----+---------+ | |+----+----+---+---+| | | | | Opening ||Dest|Dest|Src|Src|| CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|| | | Flag | | |+----+----+---+---+| | | | +---------+-------------------+-----+-----+---------+ Where Dest and Src are opposite to Data frame
Broadcasts
Broadcasts are sent as an extended scout frame with eight bytes of data.
Broadcast (Dest=&FFFF), 14-byte Scout frame only: +---------+-----------------------------+---------+-----+-----+---------+ | |+----+----+---+---+----+----+| | | | | | Opening ||Dest|Dest|Src|Src|Ctrl|Port|| 8 bytes | CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|Byte| || of data | | | Flag | | |+----+----+---+---+----+----+| | | | | +---------+-----------------------------+---------+-----+-----+---------+ <--- - Packet Header - --->
Although RISC OS Econet can transmit and receive broadcasts with more than eight bytes of data, broadcasts should be restricted to exactly eight bytes to ensure correct reception and propagation over bridges and gateways.
Immediates
Immediate operations are sent as an extended scout frame with four bytes of data sent to port &00.
Immediates (Port=&00), 10-byte Scout: +---------+-----------------------------+---------+-----+-----+---------+ | |+----+----+---+---+----+----+| | | | | | Opening ||Dest|Dest|Src|Src|Ctrl|Port|| 4 bytes | CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|Byte|&00 || of data | | | Flag | | |+----+----+---+---+----+----+| | | | | +---------+-----------------------------+---------+-----+-----+---------+ <--- - Packet Header - --->
What follows the immediate scout depends on the immediate operation, as follows:
Ctrl Action &81 PEEK Scout->, <-Data &82 POKE Scout->, <-Ack, Data->, <-Ack &83 JSR Scout->, <-Ack, Data->, <-Ack &84 USERPROC Scout->, <-Ack, Data->, <-Ack &85 OSPROC Scout->, <-Ack, Data->, <-Ack &86 HALT Scout->, <-Ack &87 CONTINUE Scout->, <-Ack &88 MACHINETYPE Scout->, <-Data &89 GETREGISTERS Scout->, <-Data
Example NetFS packet
An Econet packet can contain anything, for instance an NetFS command, a PrintFS packet, a data load/save block, a teletext data block. This example shows a NetFS file server command transmission.
A NetFS file server command is as follows:
+-------+----------+--------+--------+--------+----- - - - - -+ | Reply | Function | URD | CSD | LIB | Parameters | | Port | Code | Handle | Handle | Handle | | +-------+----------+--------+--------+--------+----- - - - - -+
The program API encapulates this as follows for OSWORD &14,0:
+-----+------------+-----------------------------+ | &00 | Length | +-------------------------+ | | | of command | |File Server Command Block| | | | block | +-------------------------+ | +-----+------------+-----------------------------+
After setting up a receive block to receive the fileserver reply, this is passed to the network transmission system to send to the file server as follows, equivalent to OSWORD &10:
+------+------+-----+-----+---------------+---------------+ | Ctrl | Port | FS | FS | Command Block | Command Block | | &80 | &99 | Stn | Net | Start Address | End Address+1 | +------+------+-----+-----+---------------+---------------+
The control byte is used to pass sequence numbers for sequential operations such as GetByte, PutByte, etc.
This gets encapsulated as an Econet packet as follows:
+------+------+-----+-----+------+------+-----------------------------+ | Dest | Dest | Src | Src | Ctrl | Port | +-------------------------+ | | Stn | Net | Stn | Net | &80 | &99 | |File Server Command Block| | | (FS) | (FS) | | | | | +-------------------------+ | +------+------+-----+-----+------+------+-----------------------------+ <------ - - Packet Header - - ------> <---- - Packet Data - ---->
This is sent as four Econet frames as follows:
Scout: +---------+-----------------------------+-----+-----+---------+ | |+----+----+---+---+----+----+| | | | | Opening ||Dest|Dest|Src|Src|Ctrl|Port|| CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|&80 |&99 || | | Flag | | ||(FS)|(FS)| | | | || | | | | |+----+----+---+---+----+----+| | | | +---------+-----------------------------+-----+-----+---------+ <--- - Packet Header - --->
Scout acknowledge sent back: +---------+---------------------+-----+-----+---------+ | |+----+----+----+----+| | | | | Opening ||Dest|Dest|Src |Src || CRC | CRC | Closing | | Flag ||Stn |Net |Stn |Net || | | Flag | | || | |(FS)|(FS)|| | | | | |+----+----+----+----+| | | | +---------+---------------------+-----+-----+---------+ Where Dest and Src are opposite to Scout frame
Data: +---------+-------------------+---------------+-----+-----+---------+ | |+----+----+---+---+|+-------------+| | | | | Opening ||Dest|Dest|Src|Src||| File Server || CRC | CRC | Closing | | Flag ||Stn |Net |Stn|Net|||Command Block|| | | Flag | | ||(FS)|(FS)| | ||| || | | | | |+----+----+---+---+|+-------------+| | | | +---------+-------------------+---------------+-----+-----+---------+
Data acknowledge sent back: +---------+---------------------+-----+-----+---------+ | |+----+----+----+----+| | | | | Opening ||Dest|Dest|Src |Src || CRC | CRC | Closing | | Flag ||Stn |Net |Stn |Net || | | Flag | | || | |(FS)|(FS)|| | | | | |+----+----+----+----+| | | | +---------+---------------------+-----+-----+---------+ Where Dest and Src are opposite to Data frame
Jgharston 22:23, 14 May 2009 (UTC)