SS80 disk emulator for HP85 disk emulator project for AVR. More...

#include "user_config.h"
#include "defines.h"
#include "gpib_hal.h"
#include "gpib.h"
#include "gpib_task.h"
#include "amigo.h"
#include "ss80.h"
#include "vector.h"
#include "debug.h"

Enumerations
enum	ss80exec { EXEC_IDLE, EXEC_LOCATE_AND_READ, EXEC_LOCATE_AND_WRITE, EXEC_SEND_STATUS, EXEC_DESCRIBE }

Functions
void	SS80_Test (void)
	SS80 GPIB function. More...

void	V2B_MSB_Index1 (uint8_t *B, int index, int size, uint32_t val)
	Initialize SS80 state and bus. More...

uint8_t *	SS80ControllerPack (int *size)
	Pack Controller data into bytes. More...

uint8_t *	SS80UnitPack (int *size)
	Pack Unit data into bytes. More...

uint8_t *	SS80VolumePack (int *size)
	Pack Voulme data into bytes. More...

void	SS80_init (void)
	SS80 nitialize all devices Initialize ALL SS80 devives. More...

int	SS80_Execute_State (void)
	SS80 Execute state process. More...

uint32_t	SS80_Blocks_to_Bytes (uint32_t block)
	SS80 Return current address in bytes. More...

uint32_t	SS80_Bytes_to_Blocks (uint32_t bytes)
	SS80 Return current block addresss from bytes. More...

int	SS80_locate_and_read (void)
	SS80 Locate and Read COmmend. More...

int	SS80_locate_and_write (void)
	SS80 Locate and Write Commend. More...

int	SS80_test_extended_status (uint8_t *p, int bit)
	SS80 test extendend status bits and display them. More...

void	SS80_set_extended_status (uint8_t *p, int bit)
	SS80 set extendend status bits. More...

void	SS80_display_extended_status (uint8_t p, char message)
	SS80 Display extended 8 byte status messages for debuging. More...

int	SS80_send_status (void)
	SS80 send detailed status. More...

int	SS80_describe (void)
	Send Controler,Unit and Volume description. More...

void	SS80_Check_Unit (uint8_t unit)
	Check unit number and assign. More...

void	SS80_Check_Volume (uint8_t volume)
	Check volume number and assign. More...

int	SS80_Command_State (void)
	Process OP Codes following 0x65 Command State. More...

int	SS80_Transparent_State (void)
	(0x70 or 0x72) OP Code processing. More...

int	SS80_cmd_seek (void)
	Limit tests for disk seek. More...

int	SS80_Report (void)
	send QSTAT More...

void	Clear_Common (int u)
	Universal and Decvice clear code. More...

int	SS80_Channel_Independent_Clear (int u)
	Channel Independent Clear. More...

int	SS80_Universal_Device_Clear (void)
	Universal Device CLear. More...

int	SS80_Selected_Device_Clear (int u)
	Selected Device Clear. More...

int	SS80_Amigo_Clear (void)
	Amigo Clear. More...

int	SS80_Cancel ()
	Cancel transaction. More...

int	SS80_increment (void)
	Increment position Addressy by one block. More...

int	SS80_error_return (void)
	Common SS80 Error Return function. Send qstat = 1. More...

int	SS80_COMMANDS (uint8_t ch)
	SS80 COMMANDS States. More...

Variables
uint8_t	talking
	GPIB BUS states. More...

uint8_t	listening
	gpib listen address More...

uint8_t	spoll
	gpib serial poll status More...

int	TD []
	SS80 GPIB test string. More...

fault_t	faults []
	fault messages TODO move these to __memx More...

Detailed Description

SS80 disk emulator for HP85 disk emulator project for AVR.

Edit History

[1.0] [Mike Gore] Initial revision of file.

Copyright © 2014-2020 Mike Gore, All rights reserved. GPL

See also: http://github.com/magore/hp85disk; http://github.com/magore/hp85disk/COPYRIGHT.md for Copyright details

Based on work by Anders Gustafsson.

Copyright © 2014 Anders Gustafsson All rights reserved..

Definition in file ss80.c.

Enumeration Type Documentation

◆ ss80exec

enum ss80exec

Enumerator
EXEC_IDLE
EXEC_LOCATE_AND_READ
EXEC_LOCATE_AND_WRITE
EXEC_SEND_STATUS
EXEC_DESCRIBE

Definition at line 95 of file ss80.c.

Function Documentation

◆ Clear_Common()

void Clear_Common ( int u )

Universal and Decvice clear code.

Clear Settings to poweron values.
- Clear Unit, Address, Length, Error Status, qstat
  See also
  : SS80_Selected_Device_Clear()
  
  : SS80_Universal_Device_Clear()
  
  : SS80_Amigo_Clear()
  -References:
  - SS80 ps 4-2 - *** listed as NOT supported for SS80 ***
  - CS80 pg 4-49, 3-2, 3-4
  - CS80 Page B-12
  - SS80 4-11
  - CS80 4-26, 3-2,3-5
Notes: All Clears are the same

Except: Universal Device Clear to Unit other then 15.

If the unit is NOT 15 then then Unit will remain set
They ALL set Power on Values - Except diagnostic report

The clear command will cause the device to abort the transaction in process as soon as possible without losing any data.

///  Power ON Values
///  CS80 Page B-12
///  Table B-5. Complementary Command Power-on Values
///  COMPLEMENTARY POWER-ON       COMPLEMENTARY               POWER-ON
///  COMMAND       VALUE COMMAND  COMMAND                     VALUE
///  Set Unit     0               Set Retry Time              device specific
///  Set Volume   0               Set Status Mask             disabled
///  Set Address  0,0,0           No Op                       Not Applicable
///  Set Length  -1 (full volume) Set Release                 T = O Z = O
///  Set Burst   disable          Set Options                 device specific
///  Set RPS     disabled         Set Return Addressing Mode  single vector
///
///  CS80 3-2
///  Clears the following:
///  - clearable hardware functions
///  - internal buffers
///  - channel interface buffers
///  - Complementary values
///  - status report, unless the Diagnostic Result status bit is set
///  - other programmable functions (device dependent)
///
///  CS80 3-3 has more detail
///  1. Abort the current operation at the earliest opportunity such
///     that no data corruption can take place.
///  2. Clear all clearable device or interface conditions currently asserted.
///  3. Reset all Complementary parameters to their power-on values.
///  4. Reset status report, unless the Diagnostic Result status bit is
///     set. This includes resetting power-on status.
///     Note- After the device has reported a diagnostic failure on one unit,
///     the Clear command will clear the status of other units attempting to
///     report the same failure. It is unnecessary for the same failure to
///     be reported more than once.
///  5. Set QSTAT value to indicate whether or not status should be
///     requested. Note: QSTAT will indicate any diagnostic results
///     in addition to the occurrence of an internal release request.
///  6. Enter the reporting state.
///

Todo:

We do not have RPS or Burst settings yet so we do not clear them/

We do not have a diagnostic mode so bits ALWAYS get cleared.

Parameters

[in] u unit

Returns: void TODO We do not support multiple units yet TODO We do not support multiple Volumes yet

Todo:: FIXME Normally the poweron value is -1 (Full volume) However; Any read will try to read the whole volume. (This is Only used in disk copy functions) A setting of 0 will offer the best chance of the error being spotted by the Controller in Charge However; Typically systems will always set this value BEFORE a transfer.

Todo:: FIXME If we have a Diagnostic Report bit then we do not clear the Status/Error bits SS80 4-12

Definition at line 1734 of file ss80.c.

Referenced by SS80_Amigo_Clear(), SS80_Channel_Independent_Clear(), SS80_init(), SS80_Selected_Device_Clear(), and SS80_Universal_Device_Clear().

◆ SS80_Amigo_Clear()

int SS80_Amigo_Clear ( void )

Amigo Clear.

Reference: SS80 4-5
Returns
0 on send

GPIB flags on send error.

See also
gpib.h _FLAGS defines for a full list.

Todo:
do something with Parity Check Bit ?

Definition at line 1831 of file ss80.c.

Referenced by SS80_COMMANDS().

◆ SS80_Blocks_to_Bytes()

uint32_t SS80_Blocks_to_Bytes ( uint32_t block )

SS80 Return current address in bytes.

Returns: Byte Address

Definition at line 344 of file ss80.c.

Referenced by SS80_cmd_seek(), SS80_Command_State(), SS80_increment(), SS80_locate_and_read(), and SS80_locate_and_write().

◆ SS80_Bytes_to_Blocks()

uint32_t SS80_Bytes_to_Blocks ( uint32_t bytes )

SS80 Return current block addresss from bytes.

Returns: Block Address

Definition at line 353 of file ss80.c.

Referenced by SS80_cmd_seek(), SS80_locate_and_read(), and SS80_locate_and_write().

◆ SS80_Cancel()

int SS80_Cancel ( )

Cancel transaction.

Reference:
- SS80 4-9
- CS80 4-26, 3-6
State: TRANSPARENT 0x72
- Phases: Command, Report
  Todo:

Todo:: FIXME

Definition at line 1865 of file ss80.c.

Referenced by SS80_Transparent_State().

◆ SS80_Channel_Independent_Clear()

int SS80_Channel_Independent_Clear ( int u )

Channel Independent Clear.

See also

: Clear_Common()

Reference:
- SS80 4-11
- CS80 4-26, 3-2,3-5
State: TRANSPARENT 0x72
Phases: Command, Report

Parameters

[in] u Unit

Returns: 0

Definition at line 1775 of file ss80.c.

Referenced by SS80_Transparent_State().

◆ SS80_Check_Unit()

void SS80_Check_Unit ( uint8_t unit )

Check unit number and assign.

Parameters

[in] unit unit number to assign

Returns: void

Definition at line 977 of file ss80.c.

Referenced by SS80_Command_State(), and SS80_Transparent_State().

◆ SS80_Check_Volume()

void SS80_Check_Volume ( uint8_t volume )

Check volume number and assign.

Parameters

[in] volume volume number to assign

Returns: void

Definition at line 995 of file ss80.c.

Referenced by SS80_Command_State().

◆ SS80_cmd_seek()

int SS80_cmd_seek ( void )

Limit tests for disk seek.

eference SS80 4-39,4-45
We check for read/write past end of disk during the seek
See also
: SS80_locate_and_read( )

: SS80_locate_and_write()

Returns
0 on sucess

1 on fail
Fail will set: qstat = 1, Errors |= ERR_SEEK.

Todo:: Let f_lseek do bounds checking instead ??? Will we read or write past the end of the disk ??

Definition at line 1593 of file ss80.c.

Referenced by SS80_locate_and_read(), and SS80_locate_and_write().

◆ SS80_Command_State()

int SS80_Command_State ( void )

Process OP Codes following 0x65 Command State.

References: SS80 pg 3-18, CS80 pg 4-6.
3.8 COMPLEMENTARY COMMANDS

State: COMMAND STATE.

Returns: 0 on sucess.; flags on fail.

See also: gpib.h ERROR_MASK defines for a full list.

///  Notes:
///  We set DPPR on entry and EPPR on exit
///     DPPR = gpib_disable_PPR(SS80p->HEADER.PPR);
///     EPPR = gpib_enable_PPR(SS80p->HEADER.PPR);
///
///  Valid OP Codes for Command State (0x65):
///     Real Time, General Purpose, Complementary, DIagnostic
///     Diagnostic
///     In this Order:
///        (1 to N) Complementary
///        and/or
///        (1) of Real Time, General Purpose, Diagnostic
///        (This later group is always LAST)
///     OP Code Sequence errors: TODO
///
///  We Read all of the Data/Opcodes/Parameters at once
///     (while ATN is false).
///     Last byte read should be EOI or an error
///  Why read all at once ?
///     SS80 "Command Messages" are buffered one at a time.
///     A "Command Message" contains all ALL opcodes & their parameters
///     (See SS80 Section 4-12, Page 4-6)
///
///  Unknown OP Code processing rules
///     Skip the remaining codes, Wait for Report Phase
///

Todo:: FIXME

set unit number TODO We do not support multiple units yet - we DO track it

set volume number TODO We do not support multiple Volumes yet - we DO track it

Todo:: FIXME, In Execute state calls SS80_locate_and_read();

Todo:: FIXME, SS80_locate_and_write();

Todo:: FIXME Important SS80 and CS80 differences regarding Complementary Commands! CS80 pg 2-1 1) In CS80 when only complementary commands appear in a message they will set the system defaults: Unit, number, data transfer length, burst size, maximum retry time, and Rotational Position Sensing (RPS) window size and location. 2) If, in the same message, they proceed a Real Time, General Purpose or Diagnostic they are TEMPORARY and just for that single transaction! 3) The exeption to these rules are Set Unit, Set Volume

Todo:: Only handles 4-byte Addresses at the moment CS80 pg 4-11, 2-14 SS80 pg 4-67

SS80 pg 4-73

Set Return Addressing Type: COMPLEMENTARY Phases: Command, Report SS80 pg 4-81 CS80 4-18,2-24

Todo:: TODO Skip Parameters

Todo:: not implmented yet SS80 pg 4-43 CS80 pg 4-20, 2-28

Todo:: TODO

Todo:: FIXME Execute NOW

Todo:: FIXME The class GENERAL PURPOSE suggests yes

Todo:: FIXME The class GENERAL PURPOSE suggests yes

Validate Key, Set Format Options, Download Type: GENERAL PURPOSE Phases: Command, Report Must be last command in sequence SS80 pg 4-91 CS80 N/A

Todo:: TODO Skip Parameters

Initialize Media Type: GENERAL PURPOSE Phases: Command, Report This command must be last and only one SS80 pg 4-33 CS80 4-19,2-26

Todo:: TODO

Todo:: FIXME

Set Status Mask Type: GENERAL PURPOSE Phases: Command, Report Must be last command in sequence SS80 pg 4-81 CS80 4-15,2-20

Todo:: TODO

Todo:: TODO

Todo:: TODO

Initiate Diagnostic Type: DIAGNOSTIC Phases: Command, Report Must be last command in sequence SS80 pg 4-35 CS80 N/A

Todo:: TODO

Definition at line 1047 of file ss80.c.

Referenced by SS80_COMMANDS().

◆ SS80_COMMANDS()

int SS80_COMMANDS ( uint8_t ch )

SS80 COMMANDS States.

-Reference: SS80 3-2..9

0x6e Execute State
0x65 Command State
0x70 Report State
0x72 Transparent State
Parameters

[in] ch command.

Returns
0 on send

See also
GPIB error status

gpib.h _FLAGS defines for a full list.

Definition at line 1929 of file ss80.c.

Referenced by GPIB_COMMANDS().

◆ SS80_describe()

int SS80_describe ( void )

Send Controler,Unit and Volume description.

Reference: SS80 4-15.
State: EXEC STATE COMMAND>

Returns: 0 on sucess>; flags on fail. @ gpib.h ERROR_MASK defines for a full list of error flags.

Definition at line 929 of file ss80.c.

Referenced by SS80_Execute_State().

◆ SS80_display_extended_status()

void SS80_display_extended_status	(	uint8_t *	p,
		char *	message
	)

SS80 Display extended 8 byte status messages for debuging.

Parameters

*p	extended status vector
*message	message header for display

Returns: void

Definition at line 714 of file ss80.c.

Referenced by SS80_Command_State().

◆ SS80_error_return()

int SS80_error_return ( void )

Common SS80 Error Return function. Send qstat = 1.

Returns: 0 on send; GPIB flags on send error

See also: gpib.h _FLAGS defines for a full list.

Definition at line 1898 of file ss80.c.

Referenced by SS80_locate_and_read().

◆ SS80_Execute_State()

int SS80_Execute_State ( void )

SS80 Execute state process.

Reference SS80 3-1..9
State: EXEC STATE COMMAND
Returns
0 on sucess

GPIB error flags on fail

See also
gpib.h ERROR_MASK defines for a full list of error flags.

Definition at line 306 of file ss80.c.

Referenced by SS80_COMMANDS().

◆ SS80_increment()

int SS80_increment ( void )

Increment position Addressy by one block.

References: SS80 4-39, 4-45.
Returns
0

Definition at line 1880 of file ss80.c.

◆ SS80_init()

void SS80_init ( void )

SS80 nitialize all devices Initialize ALL SS80 devives.

Todo:: FIXME

Definition at line 275 of file ss80.c.

Referenced by gpib_init_devices().

◆ SS80_locate_and_read()

int SS80_locate_and_read ( void )

SS80 Locate and Read COmmend.

Reference: SS80 4-39
Read (SS80s->Length) disk bytes at (Address) offset.
Send this data to the GPIB bus.
State: EXEC STATE COMMAND.
Returns
0 on sucess

GPIB error flags on fail.

See also
gpib.h ERROR_MASK defines for a full list of error flags.
Notes: Any Disk I/O errors will set qstat and Errors.
Limitations:
- Currenly we will only process 2 ** 31 bytes Max in one transfer.
- If an seek or I/O error happens then we MUST continue to read and discard the GPIB data until we get an EOI or GPIB error...

Todo:: FIXME SS80 4-39 For now we will assume the controller will never do this

Returns: Return

Note: this should not happen unless we exit on errors above

Definition at line 374 of file ss80.c.

Referenced by SS80_Execute_State().

◆ SS80_locate_and_write()

int SS80_locate_and_write ( void )

SS80 Locate and Write Commend.

Reference: SS80 pg 4-45, CS80 pg 2-8.
Write (SS80s->Length) disk bytes from GPIB at (Address) offset.
State: EXEC STATE COMMAND.
Disk I/O errors will set qstat and Errors.
Limitations.
- Currenly we will only process 2 ** 31 bytes Max in one transfer.
- If an seek or I/O error happens then we MUST continue to. read and discard the GPIB data until we get an EOI or GPIB error...
  Returns
  0 on sucess.
  
  GPIB error flags on fail.
  
  See also
  gpib.h ERROR_MASK defines for a full list.

Definition at line 506 of file ss80.c.

Referenced by SS80_Execute_State().

◆ SS80_Report()

int SS80_Report ( void )

send QSTAT

Reference: CS80 pg 4-7, Section 4-14.

///    QSTAT, return status byte
///  NORMAL COMPLETION = 0
///     Indicates normal completion of the requested operation.
///  HARD ERROR = 1
///     Indicates that error information is available.
///     The host must issue the Request Status command in order
///     to determine what went wrong.
///  POWER ON = 2
///     Indicates that the device has just returned from a power failure
///     or some form of operator intervention (such as removal of the
///     storage media). Any incomplete transactions were aborted and
///     should be repeated.  The host must reconfigure any programmable
///     operating parameters because they have returned to their
///     power-on values.
///

@return  0 on sucess
@see: gpib.h ERROR_MASK defines for a full list.

Definition at line 1641 of file ss80.c.

Referenced by GPIB(), GPIB_TALK(), and SS80_COMMANDS().

◆ SS80_Selected_Device_Clear()

int SS80_Selected_Device_Clear ( int u )

Selected Device Clear.

See also

: Clear_Common()

Reference:
- SS80 ps 4-2 - *** listed as NOT supported for SS80 ***
- CS80 pg 4-49, 3-2, 3-4
- CS80 Page B-12

Returns: 0

Definition at line 1811 of file ss80.c.

Referenced by GPIB().

◆ SS80_send_status()

int SS80_send_status ( void )

SS80 send detailed status.

Reference: SS80 pg 4-59..64.
Send 20 bytes of extended status to host>
State: EXEC STATE COMMAND.

///  SS80 pg 4-59
///  Bits are numbered
///    0 .. 7 (MSB..LSB "backwards")
///  Bytes are numbered
///    1 .. 20 (0..19 in message)
///  Example:
///    Bit 0 represents the MSB of Byte 1
///
///  We define ONLY those bits we are using, or might use
///  See: SS80 pg 4-59 for more details
///
///  Indentification Field
///    Byte 1(0)  <VVVVUUUU>
///      VVVV=Volume NUmber
///    Byte 2(1)  <11111111>
///
///  SS80 pg 4-59
///  Reject Errors Field
///       byte 3(2)           byte 4(3)
///  < 0 0 2 0 0 5 6 7 > <8 9 10 0 12 0 0 O>
///  2 = Channel Parity Error
///  5 = Illegal Opcode
///  6 = Module Addressing
///  7 = Address Bounds
///  8 = Parameter Bounds
///  9 = Illegal Parameter
///  10 = Message Sequence
///  12 = Message Length
///
///  SS80 pg 4-60
///  Fault Errors Field
///        byte 5(4)               byte 6(5)
///  < 0 17 0 19 0 0 22 0 > < 24 0 0 0 0 0 30 31 >
///
///  19 = Controller Fault
///  22 = Unit Fault
///  24 = Diagnostic Result
///  30 = Power Fail
///  31 = Re-transmit
///
///
///  SS80 pg 4-60
///  Access Errors Field
///        byte 7(6)                byte 8(7)
///  < 0 33 34 35 36 37 0 0 > < 40 41 0 43 44 0 0 0 >
///  33 = Uninitialized media
///  34 = No Spares Available
///  35 = Not Ready
///  36 = Write Protect
///  37 = No Data Found
///  40 = Unrecoverable Data Overflow
///  41 = Unrecoverable Data
///  43 = End of File
///  44 = End of Volume
///
///  SS80 pg 4-62
///  Information Errors Field
///         byte 9(8)             byte 10(9)
///  < 0 0 0 51 52 0 0 55 > < 0 57 0 59 0 0 0 0 >
///  51 = Media Wear
///  52 = Latency induced
///  55 = Auto Sparing Invoked
///  57 = Recoverable Data Overflow
///  59 = Recoverable Data
///
/// SS80 4:58
/// The following fault error bits will NEVER be set by an SS/80 device:
/// 26 = Operator request
/// 27 = Diagnostic request
/// 28 = Internal maintenance
/// 32 = Illegal parallel operation
/// 48 = Operator Request
/// 49 = Diagnostic Request
/// 50 = Internal Maintenance
/// 58 = Marginal Data
/// 61 = Maintenance Track Overflow
///
/// SS80 pg 4-64
/// P6 (10 .. 15) is SS80 Specific
///
/// SS80 4:65
/// P1O (16 .. 19)
///
/// @todo  add some of these
///  5 = Illegal Opcode
///  6 = Module Addressing
///  8 = Parameter Bounds
///  9 = Illegal Parameter
///  10 = Message Sequence
///  12 = Message Length
///  19 = Controller Fault
///  24 = Diagnostic Result
///  30 = Power Fail
///  33 = Uninitialized media
///  35 = Not Ready
///  37 = No Data Found
///  41 = Unrecoverable Data
///  43 = End of File
///  44 = End of Volume
///

@return 0.
@return GPIB error flags on fail>
@see gpib.h ERROR_MASK defines for a full list.

Todo:: add Diagnostic Result status (MSB of byte 5)

4:63,64

Note: Diagnostic Result bit is NOT set

See also: SET ADDRESS in blocks

Todo:: Fixme

Definition at line 854 of file ss80.c.

Referenced by SS80_Execute_State().

◆ SS80_set_extended_status()

void SS80_set_extended_status	(	uint8_t *	p,
		int	bit
	)

SS80 set extendend status bits.

Reference: SS80 pg 4-58..64.
8 status bytes of the extended status message
Parameters

*p extended status vector

bit bit number starting at MSB of first byte as 0

Returns
void

Definition at line 700 of file ss80.c.

Referenced by SS80_send_status().

◆ SS80_Test()

void SS80_Test ( void )

SS80 GPIB function.

Todo:: get this working

Definition at line 123 of file ss80.c.

◆ SS80_test_extended_status()

int SS80_test_extended_status	(	uint8_t *	p,
		int	bit
	)

SS80 test extendend status bits and display them.

Reference: SS80 pg 4-58..64.
Look at the 8 status bytes of the extended status message
Debuuging
Parameters

*p extended status vector

bit bit number starting at MSB of first byte as 0

Returns
1 if set

Definition at line 683 of file ss80.c.

Referenced by SS80_display_extended_status().

◆ SS80_Transparent_State()

int SS80_Transparent_State ( void )

(0x70 or 0x72) OP Code processing.

References: CS80 pg 4-26, 3-2,3-3,3-4,3-5,3-7,3-9,3-10.

State: Transparent State.

Returns: 0 on sucess; flags on fail

See also: gpib.h ERROR_MASK defines for a full list or error flags.

///  Notes:
///     DPPR gpib_disable_PPR(SS80p->HEADER.PPR) should already be set at the secondary
///   We do NOT reenable EPPR at any state
///
///  Valid OP Codes for Transparent State (0x70 or 0x72):
///     [Unit Complementary] Transparent
///
///  UNIVERSAL DEVICE CLEAR
///  AMIGO CLEAR
///  CANCEL
///  CHANNEL INDEPENDENT CLEAR
///  IDENTIFY
///  READ LOOPBACK
///  WRITE LOOPBACK
///  HP-IB PARITY CHECKING
///
///  Transparent Commands done at HP-IB state, NOT here:
///    Universal Device Clear
///    Selected Device Clear
///    Identify
///
///  Read all of the Data/Opcodes/Parameters at once
///     (while ATN is false).
///     Last byte read should be EOI or an error
///  Why read all at once ?
///     SS80 "Command Messages" are buffered one at a time.
///     A "Command Message" contains all ALL opcodes & their parameters
///     (See SS80 Section 4-12, Page 4-6)
///
///  Unknown OP Code processing rules
///     Skip the remaining codes, Wait for Report Phase

///

Todo:: FIXME

work in progress, unit support

Note: Enabling Parallel Poll is up to each function Many transparent Commands require Parallel Poll disabled when done

Todo:: FIXME

TODO We do not support multiple units yet - we DO track it

HP-IB PARITY CHECKING

Todo:: TODO Skip Paramter

Todo:: FIXME SS80 4-49 CS80 4-27, 3-7

@breif READ LOOPBACK

Todo:: TODO DO NOT EPPR

Todo:: FIXME SS80 4-49 CS80 4-27, 3-7

@breif WRITE LOOPBACK

Todo:: TODO DO NOT EPPR

Todo:: FIXME SS80 4-11 CS80 4-26, 3-2,3-5

CHANNEL INDEPENDENT CLEAR TODO We do not support multiple UNITS yet - we DO track it TODO The UNIT is optional and has already been set if specified

Todo:: FIXME SS80 4-9 CS80 4-26, 3-6

CANCEL TODO We do not support multiple units yet

Definition at line 1442 of file ss80.c.

Referenced by SS80_COMMANDS().

◆ SS80_Universal_Device_Clear()

int SS80_Universal_Device_Clear ( void )

Universal Device CLear.

See also

: Clear_Common()

Reference:
- SS80 4-11
- CS80 4-26, 3-2,3-3
State: TRANSPARENT, 0x14
Phases: Command, Report

Returns: 0

Todo:: FIXME

Definition at line 1793 of file ss80.c.

Referenced by GPIB().

◆ SS80ControllerPack()

uint8_t* SS80ControllerPack ( int * size )

Pack Controller data into bytes.

Parameters

[out] *size number of bytes in result

Returns: pointer to packer array

Definition at line 169 of file ss80.c.

Referenced by SS80_describe().

◆ SS80UnitPack()

uint8_t* SS80UnitPack ( int * size )

Pack Unit data into bytes.

Parameters

[out] *size number of bytes in result

Returns: pointer to packer array

Definition at line 198 of file ss80.c.

Referenced by SS80_describe().

◆ SS80VolumePack()

uint8_t* SS80VolumePack ( int * size )

Pack Voulme data into bytes.

Parameters

[out] *size number of bytes in result

Returns: pointer to packer array

Definition at line 245 of file ss80.c.

Referenced by SS80_describe().

◆ V2B_MSB_Index1()

void V2B_MSB_Index1	(	uint8_t *	B,
		int	index,
		int	size,
		uint32_t	val
	)

Initialize SS80 state and bus.

///  Reference:
///  CS80 Page B-12
///  Table B-5. Complementary Command Power-on Values
///  COMPLEMENTARY POWER-ON       COMPLEMENTARY               POWER-ON
///  COMMAND       VALUE COMMAND  COMMAND                     VALUE
///  Set Unit     0               Set Retry Time              device specific
///  Set Volume   0               Set Status Mask             disabled
///  Set Address  0,0,0           No Op                       Not Applicable
///  Set Length  -1 (full volume) Set Release                 T = O Z = O
///  Set Burst   disable          Set Options                 device specific
///  Set RPS     disabled         Set Return Addressing Mode  single vector
///

Returns: void

SS80 Describe helper functions The SS80 docs number bytes offset as 1 to N for Controller,Unit and Volume MSB ... LSB

remove 1 bias

Definition at line 159 of file ss80.c.

Referenced by SS80ControllerPack(), SS80UnitPack(), and SS80VolumePack().

Variable Documentation

◆ faults

fault_t faults[]

fault messages TODO move these to __memx

Reference: SS80 pg 4-59..64.

Definition at line 642 of file ss80.c.

Referenced by SS80_display_extended_status().

◆ listening

uint8_t listening

gpib listen address

Definition at line 90 of file gpib.c.

Referenced by GPIB(), GPIB_COMMANDS(), GPIB_LISTEN(), GPIB_SECONDARY_ADDRESS(), gpib_state_init(), GPIB_TALK(), gpib_task(), PRINTER_COMMANDS(), and SS80_COMMANDS().

◆ spoll

uint8_t spoll

gpib serial poll status

Definition at line 95 of file gpib.c.

Referenced by GPIB(), gpib_state_init(), and GPIB_TALK().

◆ talking

uint8_t talking

GPIB BUS states.

///  See LIF filesystem Reference
///  Reference from "Subset 80 for Fixed and Flexible Disk Drives"
///  Page: 3-17, Figure 3-8. Secondaries and Opcodes
///
///  Address  Secondary  Opcode   # of other   Comment
///  State  (without            Parameter
///            parity)            bytes
///  -------  ---------  ------   ----------   -------
///  L major    65H      2XH      None        Set Unit
///  L major    65H      40-47H   None        Set Volume
///  L major    65H      10H      6 bytes     Set Address
///  L major    65H      18H      4 bytes     Set Length
///  L major    65H      34H      None        No Op
///  L major    65H      39H      2 bytes     Set RFS (No Op)
///  L major    65H      3BH      1 byte      Set Release (No Op)
///  L major    65H      3EH      8 bytes     Set Status Mask
///  L major    65H      48H      1 byte      Set Return Addressing Mode
///                                           (Only single vector allowed)
///  L major    65H      00H      None        Locate and Read
///  L major    65H      02H      None        Locate and Write
///  L major    65H      04H      None        Locate and Verif y
///  L major    65H      06H      1 byte      Spare Block
///  L major    65H      00H        None        Request Status
///  L major    65H      0EH      None        Release (No Op
///  L major    65H      0FH      None        Release Denied (No Op)
///  L major    65H      31H      2 bytes     Validate Key
///  L major    65H      31H      2 bytes     Set Format Options
///  L major    65H      31H      6 bytes     Download
///  L major    65H      33H      3 bytes     Initiate Diagnostic
///  L major    65H      35H      None        Describe
///  L major    65H      37H      2 bytes     Initialize Media
///  L major    65H      4CH      None        Door Unlock
///  L major    65H      4DH      None        Door Lock
///  L major    72H      01H      1 byte      HP-IB Parity Checking
///  L major    72H      02H      4 bytes     Read Loopback
///  L major    72H      03H      4 bytes     Write Loopback
///  L major    72H      08H      None        Channel Independent Clear
///  L major    72H      09H      None        Cancel
///  L major    72H      --        --         Transparent execution (listen)
///                                           Write Loopback execution
///  L major    6EH      --        --         Normal execution (listen)
///                                           Write execution phase
///                                           Download execution phase
///  L major    70H      --       1 byte      Amigo Clear (1 parameter byte + SOC)
///  T major    70H      --       1 byte      Reporting phase (Stand alone QSTAT)
///  T major    6EH      --        --         Normal execution (talk)
///                                           Read execution phase
///                                           Describe execution phase
///                                           Request Status execution
///  T major    72H      --        --         Transparen texecution (talk)
///                                           Read Loopback execution
///  T minor    ADDRS    --        --         Identify
///  DEC        --       --        --         Universal Device Clear
///
///  Figure 3- 8. Secondaries and Opcodes
///

GPIB BUS states.

Definition at line 85 of file gpib.c.

Referenced by GPIB(), GPIB_COMMANDS(), GPIB_LISTEN(), GPIB_SECONDARY_ADDRESS(), gpib_state_init(), GPIB_TALK(), PRINTER_COMMANDS(), and SS80_COMMANDS().

◆ TD

int TD[]

Initial value:

=
{
    0x3F,
    0x5f | ATN_FLAG,
    0x20 | ATN_FLAG,
    0x65 | ATN_FLAG,
    0x20,
    0x40,
    0x34,                                         
    0x37,                                         
    0x00,
    0x0a,
    -1
}

SS80 GPIB test string.

Todo:: get this working

Definition at line 106 of file ss80.c.

*p	extended status vector
bit	bit number starting at MSB of first byte as 0

Enumerations

Functions

Variables

Detailed Description

Enumeration Type Documentation

◆ ss80exec

Function Documentation

◆ Clear_Common()

◆ SS80_Amigo_Clear()

◆ SS80_Blocks_to_Bytes()

◆ SS80_Bytes_to_Blocks()

◆ SS80_Cancel()

◆ SS80_Channel_Independent_Clear()

◆ SS80_Check_Unit()

◆ SS80_Check_Volume()

◆ SS80_cmd_seek()

◆ SS80_Command_State()

◆ SS80_COMMANDS()

◆ SS80_describe()

◆ SS80_display_extended_status()

◆ SS80_error_return()

◆ SS80_Execute_State()

◆ SS80_increment()

◆ SS80_init()

◆ SS80_locate_and_read()

◆ SS80_locate_and_write()

◆ SS80_Report()

◆ SS80_Selected_Device_Clear()

◆ SS80_send_status()

◆ SS80_set_extended_status()

◆ SS80_Test()

◆ SS80_test_extended_status()

◆ SS80_Transparent_State()

◆ SS80_Universal_Device_Clear()

◆ SS80ControllerPack()

◆ SS80UnitPack()

◆ SS80VolumePack()

◆ V2B_MSB_Index1()

Variable Documentation

◆ faults

◆ listening

◆ spoll

◆ talking

◆ TD