Msg # 10016 Type:B Stat:$ To: ALL @HWBNET From: EA4CPM Date: 31-Jul/0548 Subject: Host NET/ROMs Bulletin ID: 10435_PI8HWB Path: PA3APN!PE1ABT!PI8ZAA!PI8HWB!4X1RU!DK8AT!DK0MAV!DB0HB!DB0OQ!EA8RT From: EA4CPM@EA8RT Host NET/ROM is a special version of the fimware which allows the node to support a bulletin board system or other server. Host NET/ROM does not support an RS-232 TNC-to-TNC interconnect-nodes running Host NET/ROM are necessarily single-channel nodes. PROTOCOL DELIMITERS ------------------- The host interface makes use of three reserve characters as protocol delimiters: HSTX='82' hexadecimal HETX='83' hexadecimal HDLE='90' hexadecimal Note that these are simply the ASCII control characters STX,ETX and DEL with the high-order bit set. BLOCKS ------ All data passed between the host and the node are encapsulated into 'blocks' of the form: HSTX ...data... HETX checksum The checksum calculation does not include the initial HSTX, the final HETX, or any HDLE prefix characters. COMMAND BLOCKS -------------- The data portion a command block consists of: -an 8-bits binary channel number -an ASCII command letter -optionally, variable-length para meters or data RESPONSE BLOCKS --------------- The data portion of a response blocks consists of: -an 8-bits binary byte -optional, variable length d data Most command return a status byte of '00' of 'FF' hex, corresponding to "success" and "failure", respectitively. 'B' COMMAND -BAUD RATES- ------------------------- Command: ch#'B'baudbyte Response: '00'=success 'FF'=failure Valid field values are 1,2,3 and 0, corresponding to 300,1200,9600-baud and "no change", respectively. The default correspond to a baudbyte of '32' hex(HDLC=1 200,RS232=9600). 'C' COMMAND -CONNECT- ---------------------- Command: ch#'C' Response: '00'=success 'FF'=failure 'C' connects the specified host channel (0-19) to the node -this is logically equivalent to "uplinking" to the node. 'G' COMMAND -GET A MESSAGE- ---------------------------- Command: ch#'G'seq# Response: 0-3=success seq# ...data... 'FF'=failure The status byte indicates what sort of message (if any) is being returned: -'00'=user data (0-328 bytes) -'01'=link status "connected to"(callsign) -'02'=link status "disconnected from"(callsign) -'03'=link status "connect request from"(callsign) -'FF'=nothing enqueued on channel 'I' COMMAND -IDENTITY ---------------------- Command: ch#'P' ....callsign.... Response: '00'=success 'FF'=failure 'I' sets the node callsig. The callsign is composed of up to six letters an dig its. 'M' COMMAND -MONITOR- ---------------------- Command: ch#'M''00'=off '01'=on Response: '00'=success 'FF'=failure 'M' turns monitor mode on and off. Monitor frames consist of raw AX5 frames wit h only the HDLC flags and frame-check-sequence strippedd off. The maximum size o f a monitor frame is 328 bytes(256 data plus 72 bytes AX.25 header). 'P' COMMAND -PASSWORD- ----------------------- Command: ch#'P' ...password... Response: '00'=success 'FF'=failure 'P' sets the node password phare used by the SYSOP command to validate remote c ontrol operator access. A null password disable all remote control operator capa bilities. The password may be 0-80 bytes long. 'Q' COMMAND -RESYNCHRONIZE- ---------------------------- Command: ch#'Q' Response: '00'=success 'FF'=failure 'Q' is used to resynchronize a host interface channel during host startup, shut down, or after a failure. 'S' COMMAND -SEND A MESSAGE- ----------------------------- Command: ch#'Q'seq# ...data.... Response: '00'=accepted seq# '01'=choke '02'=disconnect 'FF'=failure 'S' enqueues a message to be sent to the specified channel (0-19). The seq# ret urned in the response is an echo of the seq# sent in the command. If the host sends successive 'S' commands with identical channel and sequence n umbers, the node disregard all but the first one. 'T' COMMAND -TXDELAY- ---------------------- Command: ch#'T'txdelay Response: '00'= success 'FF'=failure 'T' sets node tansmitter key-up delay according to the 8-bit binary value txdel ay which specifies the delay in 10 millisecond increments. 'Y' COMMAND -INCOMING CONNECTIONS- ----------------------------------- Command: ch#'Y'maxconnect Response: '00'=success 'FF'=failure 'Y' sets maximum number of incoming (user-initiated) connections to the the hos t, in the range 0-20. The ch" byte is ignored, although it must be valid. Source:SOFTWARE 2000, INC. 73 de Karl EA4CPM @ EA4PE