Page 2
Technical Handbook ECC 1365 MK4 AMENDMENT RECORD Issue Date Change Author Reviewed by August 2001 New Document P. Marshall M.Woodward Checked by :- Date:- [P. Marshall] Authorising Engineer Hytec Electronics Ltd– Page 2...
Page 3
Whilst every effort has been made in this handbook to instruct users in the correct methods of using the equipment, Hytec Electronics Ltd. accepts no liability for personal injury or damage to the equipment howsoever such injury or damage might be caused.
Page 4
Technical Handbook ECC 1365 MK4 This page is intentionally blank Hytec Electronics Ltd– Page 4...
Auxiliary Controller Bus Universal Twisted Pair CAMAC Operation Routine Department of Energy DTM4 CAMAC Dataway Test Module – Type 4 (Available from Hytec Electronics Ltd. UK) Ethernet Crate Controller Ethernet CAMAC Protocol ESONE European Standards on Nuclear Equipment Find Address Protocol...
This handbook is concerned with the Ethernet Crate Controller, type ECC 1365 MK 4. It is one of a range of CAMAC modules designed in the U.K. by HYTEC Electronics Ltd. Hytec is a long established hardware, software and systems company, which leads CAMAC development in industry and research.
Page 11
Compliant with ISO/IEC IS8802-3 CSMA/CD ∼ Supports standard ESONE /DOE subroutines ∼ Security, including controller-resident access tables ∼ Logical Link Control (ISO /IEC IS8802-2) support ∼ User Datagram Protocol / Internet Protocol (UDP/IP) support Hytec Electronics Ltd - Page 11...
Xilinx-based CAMAC port and associated Ethernet address PROM. 2.2 The Support Board The support board is a short board containing: - ∼ The N Line decoders. ∼ The N and L line pull-up resistor packs Hytec Electronics Ltd– Page 12...
A controller Reset / Normal / Diagnostic mode toggle switch ∼ An RS232 Diagnostic connector (9-way D-type) ∼ CAMAC ZED button A full description of these functions is given in Chapter Installing the ECC 1365, Page 68. Hytec Electronics Ltd - Page 13...
Page 14
ON = Executing CAMAC transfers in Fast CAMAC mode (later enhancement) CAMAC ON = Executing CAMAC cycle LINK ON = UTP Link established ACTIVE ON = Network traffic active SPEED ON = 100 Mbit link established. Hytec Electronics Ltd– Page 14...
ECC 1365 MK4 Technical Handbook HYTEC ECC 1365 ETHERNET CRATE CONTROLLER MK4 COMM FAST CAMAC CAMAC REQUEST GRANT IN GRANT OUT LINK ACTIVE SPEED DIAG NORM RESET RS232 Figure 1 1365 MK 4 Front Panel Details Hytec Electronics Ltd - Page 15...
UDP/IP protocols. Users who prefer to implement their own host support can do so by using the protocol definition documents available from Hytec Electronics Ltd. Host support for DEC VAX, running VMS via logical link control protocols, and UNIX Systems via the User Datagram Protocols are available.
(which return immediately). The latter require a user to call to a generalized wait routine, to receive the command completion status when it is available. The routines also exist as a set of function calls. Hytec Electronics Ltd - Page 17...
This can be disabled by setting the module “promiscuous” bit in the controller-booking table. Each host can control CAMAC modules in more than one ECC 1365. A multi -host / multi-ECC configuration is illustrated in Figure 5. Hytec Electronics Ltd– Page 18...
Ethernet cable Switch Ethernet hub Figure 4 A simple System Configuration CAMAC CAMAC Crate Crate Ethernet cable Host Host CAMAC System System Crate Switch Ethernet hub Figure 5 A multi host, multi-ECC system configuration Hytec Electronics Ltd - Page 19...
Page 20
(PIDs) in the host system. If PID booking is off then the booking is to be the host ID only. The automatic booking of stations when they are accessed for the first time is known as auto booking. This feature can be enabled or disabled. Hytec Electronics Ltd– Page 20...
∼ Statistics-gathering support. The firmware will gather statistics on Ethernet messages, failures, errors, recoveries, etc. plus CAMAC statistics, such as a number of LAMs, double-booking attempts, security violations and Dataway timeouts. Hytec Electronics Ltd - Page 21...
Full CAMAC LAM support. Host processes are notified when booked LAMs occur. Block and List modes can be synchronised to LAMs. ∼ User defined controller commands can be downloaded from a host and then executed (this permits applications to set up extra controller capability, if needed). Hytec Electronics Ltd– Page 22...
The network interactions for these methods of operation are illustrated in Figure 7. A pair of (LSAP) addresses are used, one for commands issued by the host and the other for commands issued by the ECC 1365. Hytec Electronics Ltd– Page 24...
Ethernet frame and all data to be returned by the ECC 1365 must also fit within one Ethernet frame. When the deferred response mode is used, data can be larger than one Ethernet frame. The Ethernet frame is shown in Table 1. Hytec Electronics Ltd– Page 26...
Pseudo LLC3 control field Pseudo LLC3 status field Frame type (=7) Request number CAMAC crate number ECC host ID Host PID Host Access ID Flags Status Data area Table 2 ECP Frame format when carried by UDP Hytec Electronics Ltd - Page 27...
The ECC 1365 and host systems handle the segmentation of the command block by queuing buffers and maintaining a set of pointers locally. It is required that the header fields are all contained within the first segment, so that only the parameter fields can span segments. Hytec Electronics Ltd– Page 28...
Set /clear LAM promiscuous flag Set/clear + Station number Pre-allocate response buffer space Enable / disable module LAM Clear all entries in security table Attach COR to LAM Station number Table 4 ECC 1365 Control Commands Hytec Electronics Ltd - Page 29...
ECC 1365 command and specifies how often interrupt shall be enabled by CORs that permit interrupts during their execution. When interrupts are enabled, the ECC attempts to transmit full response buffers back to the host. Hytec Electronics Ltd– Page 30...
CAMAC command is set to zero rather than one. ESONE / DOE Subroutine Command List Perform single CAMAC operation 1000 0001 0000 0001 0000 0000 0000 0001 0000 0000 0000 0000 0fff ffnn nnna aaal Table 7 Single Action Command Block Hytec Electronics Ltd - Page 31...
Table 8 Mapping ESONE / DOE subroutines to ECC 1365 Commands Notes: Command modifier determines set or clear Command modifier determines enable or disable. The mode value is a copy of the LAM access specifier provided to the Declare LAM subroutine Hytec Electronics Ltd– Page 32...
Number of operations (low) Number of operations (high) 0fff ffnn nnna aaal Data if write ……………. Table 9 Mapping ESONE / DOE Subroutines to ECC 1365 Commands Block Transfers and Multiple Actions See notes overleaf Hytec Electronics Ltd - Page 33...
When an ECC 1365 completes its reset sequence, it transmits an ERP Active multicast frame to inform hosts that it is available. Note that the ERP Active frame is not sent until the Network Time Protocol (NTP) Listening state has been completed. Hytec Electronics Ltd– Page 34...
CAMAC modules controlled by the ECC. An overview description of ECPs is covered in Chapters ECC 1365 Commands, Page 29 & CAMAC Operation Routines, Page The ECP frame format is given in Appendix A2, Table A2.4 Hytec Electronics Ltd - Page 35...
The working of the algorithm depends upon the successful estimation of the minimum transfer delay of a message between processes. The delay occurs in three places. the transmission delay the transit delay the reception delay: Hytec Electronics Ltd– Page 36...
CAMAC LAM interrupt condition or runaway command execution: Figure 8 illustrates these processing priorities and figures 9 & 10 show the flow of command lists through the ECC 1365 software. Hytec Electronics Ltd– Page 38...
Cycle down a list of outstanding LLC3 transmit timers. When it finds one, decrement the timer, and if it is now zero, invoke the appropriate LLC3 error handler. Hytec Electronics Ltd– Page 42...
Note: Unix users should be wary of the PID mode being enabled. If PID booking is enabled by the switch and an initialisation [!INIT] command is performed, auto module booking is disabled. Hytec Electronics Ltd– Page 44...
Code 23) or displayed by a terminal connected to the ECC 1365 front panel port. These statistics provide cumulative counts of the number of times that selected conditions are encountered in the ECC. The content of the statistics table is shown in Table 10 Hytec Electronics Ltd - Page 45...
Size available in bytes Current usage in bytes Note: The crash table entries are time-ordered, with the last entry corresponding to the most recent crash. Unused entries have a crash code of SUCCESS Table 10 Statistics Table Format Hytec Electronics Ltd– Page 46...
Four switches (5 to 8 on SW5) are used to specify the LSAP address pair to be used. Details of these switch settings are in Chapter 8.1.6 Configuring the Links & Switches, Page 73 Hytec Electronics Ltd - Page 47...
“time up” variable at the time of the crash. The index number at the start of the crash table indicates the next table entry to be written. The error codes are shown in the table overleaf. Hytec Electronics Ltd– Page 48...
A common set of error codes is used within the firmware. These are defined in module “structs.h” and are reproduced in Table 12. Some of these codes are internal to the software and some can be observed at the user level, e.g. in a system crash table entry. Hytec Electronics Ltd– Page 50...
The last five commands can be recalled by use of the VT200/VT300 terminal up-arrow key (similar to the VM5/DCL method). For terminals without arrow keys, Ctrl/r can be used. The available commands are shown in Table 13. Hytec Electronics Ltd - Page 51...
This list is displayed whenever ‘help’ is typed (upper or lower case). The list is presented in four sections, the first three stopping with the message: --more— The next section is then shown when <Return> is pressed. The help list can be aborted by pressing Ctrl-C at any time. Hytec Electronics Ltd– Page 52...
If a known Ethernet address is entered, a display is generated. A typical one is shown below Address SU Z C I DL PR E ST Module mask 111111111122222 123456789012345678901234 EEEE 0000 0000 XXXXX..XXXXXXXXXXXXXX Completed OK Note: an ‘X’ denotes a bit set and a ‘.’ denotes a bit clear. Hytec Electronics Ltd - Page 53...
The firmware displays the statistics shown in Table 15. The output is paginated; press <return> to see the next page or <Ctrl-C> to stop. The statistics listing is initiated by the command; display statistics d stats and a typical printout would be: Hytec Electronics Ltd– Page 54...
Allocation high water mark Number of host control blocks Number currently allocated Allocation high water mark Number of security table entries Number currently allocated Allocation high water mark Download memory size (bytes) 00000000 Current allocation (bytes) 00000000 Hytec Electronics Ltd - Page 55...
The display shows: Enter Ethernet address or IP address: Enter either a 12-digit (hexadecimal) Ethernet address as 3 groups of 4 digits, i.e. C0C0 0000 0000, or as a decimal format IP address (e.g. 192.1.2.3). Hytec Electronics Ltd - Page 57...
Page 58
Store system command block allowed: Y(es),N(o): Enable /disable autobooking allowed: Y(es),N(o): Clear all booking entries allowed: Y(es),N(o): Completed OK Follow this sequence for all host addresses to be set up. Upon completion, run ‘display security’. Hytec Electronics Ltd– Page 58...
WARNING – Reset will destroy all current controller operations and all settings will be re-read from the switches and the battery-backed RAM. Are you sure you wish to continue [no]: If ‘yes’ is returned, the following message will be displayed.: Hytec Electronics Ltd - Page 59...
Bad input –3 4-digit hex numbers required Is shown. For example; !EPA C0C0 0000 0001 This command allows you to set up a physical address different to the one stored in the internal EPROM, if desired. Hytec Electronics Ltd - Page 61...
Even length in hex required Is shown. If too much memory is specified, the message: Can’t allocate more than ½ free memory to download region is given. The rest of the memory is required for system buffers. Hytec Electronics Ltd– Page 62...
Displays hexlength bytes of memory starting at hexaddr. Hexaddr must be even. If hexlength is not specified, a length of 128 bytes is used. The display is paged in 128-byte pages; press <Return> to see the next page or <Ctrl-C> to stop. Hytec Electronics Ltd - Page 63...
Displays the host control block corresponding to an Ethernet address, where xxxx is a 4 digit hexadecimal number. The three sets of four digits provide the Ethernet physical address. The second digit of the first set of four must be even for a physical address. Hytec Electronics Ltd– Page 64...
Only buffer memory is checked with this test as the remainder of the RAM is required for system operation. The test displays a rotating windmill whilst running and can be aborted by pressing <CTRL-C>. If the test fails, the appropriate memory address and data are displayed. Hytec Electronics Ltd - Page 65...
Completed OK is shown. NOTE! This test will only run correctly with a Hytec Electronics Ltd. Dataway test module type DTM4. 7.4.11.3 $RUN TIMER This test checks the operation of the timer (Timer A) on the 68901 MFP chip. A 1 -second tick timer is initialised and the message “Tick”...
Data data for write command (decimal) auto increment data Once the command is entered (RETURN key enters the command) the CAMAC command loop is entered. The message: - Type Ctrl-c to stop is displayed. Hytec Electronics Ltd - Page 67...
IMPORTANT: Ensure that the correct values are located in the sockets, and in the correct orientation. Install the single pole LEMO cable between the front panel “Request” and “Grant in” sockets. The unit is now configured for Master ACB operation. Hytec Electronics Ltd– Page 68...
The unit is now configured for Slave ACB operation. Remember to re-configure the front panel “Request/Grant” daisy chain, as appropriate, when the unit is installed as a Slave controller in a CAMAC system. Hytec Electronics Ltd - Page 69...
LHB FS2 1 AMP SIL 8 x 470R RHB FS1 1 AMP And RN7, RN8: DIL 13 x 470R packs Figure 13 ECC 1365 MK 4 view of right hand side board Hytec Electronics Ltd - Page 71...
Normal mode, indicating the result of the negotiation. If the cable connection is subsequently lost (cable unplugged or broken) this is detected, notified to the terminal and re-connection attempted at regular intervals. Hytec Electronics Ltd– Page 72...
LEMO cable link from “Request” to “Grant In” must be installed. Details of links and switch settings that may need attention are given in the following sections. Links and switches not documented should NOT be changed. Hytec Electronics Ltd - Page 73...
The left hand controller board has one bank of switches, accessible through a cut out in the bottom rear of the left hand side panel. These switches are shown in Figure 12 The switches have the following functions and should be set up at installation time. Hytec Electronics Ltd– Page 74...
Page 75
For example: for LSAP address of 60hex, set switches SW5-7 and switch SW5 -6 down (OFF) and Switch SW5 -5 and SW5-8 up (ON). This gives the first LSAP address as 60hex and the second LSAP address is automatically set to 64. Hytec Electronics Ltd - Page 75...
With JP6 removed, a soft reset is enabled whereupon the firmware initiates the reset action. A soft reset allows the firmware to fully execute the ECC 1365 reset protocol enabling all hosts to be informed of the reset. A hard reset occurs instantaneously and therefore precludes reset protocol notifications. Hytec Electronics Ltd– Page 76...
This can be done only with a terminal connected to the front panel. At this terminal, enter the change mode command by typing: CHANGE MODE <RETURN> Enter ‘3’ <RETURN>, to enter diagnostic plus battery-backed RAM setup. Hytec Electronics Ltd - Page 77...
It is not necessary to initialise these fields if you intend to work in an LLC3 only environment (ALPHA or VAX hosts).The values you enter will be stored in the unit’s battery-backed RAM and thus be saved when the unit is powered down. Hytec Electronics Ltd– Page 78...
To set up the IP address use the !IPA command (section 7.6) whilst in battery-backed RAM setup mode. NOTE: The IP address, socket number and CAMAC crate number assigned to the controller must be entered in the IPADDR.dat file in /ecc_dir (see section 11.3). Hytec Electronics Ltd - Page 79...
RAM mode, using the commands given in Chapter Battery-backed RAM Mode Commands, Page 60 To enter normal operation at this point, operate the front panel switch, leaving it in its normal position after toggling to RESET. Hytec Electronics Ltd– Page 80...
This is not an exhaustive list but may help with overcoming initial “teething” problems for u nfamiliar users. If the problem persists or the solution cannot be found, please contact Hytec Electronics Ltd, U.K. or our agents worldwide for advice IF IN DOUBT –...
Page 82
GRANT IN fitted between Master and other slave ACB controllers. § Check that test module is a HYTEC Dataway Display type DTM4 § Check that DTM4 station number has been defined (see CHANGE DTM4 command, section Normal Mode Commands , Page 53 § Hytec Electronics Ltd– Page 82...
Capabilities is a 16-bit field defining the capability of this host to perform ECC-wide operations Module mask is a 24-bit field and contains a 1 in bit position 2 if the host is allowed access to the module in station number N. Hytec Electronics Ltd - Page 83...
Type 3 operations describe a connectionless acknowledged mode of operation [Reference 4] Multicast Address An Ethernet address that is accepted by a group of systems on an Ethernet local area network. TCP/IP Transmission Control Protocol/Internet Protocol. User Datagram Protocol Hytec Electronics Ltd– Page 86...
Introduction to Internet Protocols. Computer Science Facilities Group, Rutgers, The State University of New Jersey, USA 1987 RFC 791, Internet Protocol RFC 768, User Datagram Protocol RFC 792, Internet Control Message Protocol RFC 826, Address Resolution Protocol RFC 1010, Assigned numbers. Hytec Electronics Ltd - Page 87...
Enable Demands + A(8) F(26) Generate Z A(9) F(24) Remove I A(9) F(26) Set I A(9) F(27) Test Dataway I A(10) F(27) Test Demands Enabled + Q=DE A(11) F(27) Test Demands Present + Q=DP Hytec Electronics Ltd - Page 89...
Page 90
Timeout failure (see Errors and Interrupts, below) Cycle Count complete before End Address in Q scan Q Scan End Address before Cycle Count complete in Q Scan Note that the “incomplete” message can still contain data Hytec Electronics Ltd– Page 90...
Figure 17 Control Register Format The controller LAM enables the processor to generate a LAM for Test Purposes. The Power-Fail Interrupt Disable gates the output of the power monitoring circuit before it causes an interrupt. Hytec Electronics Ltd - Page 91...
The 24 LAM lines are connected to the Xilinx chip on the left-hand board. This provides full masking and/or prioritising of the LAMs under software control. This logic produces its own interrupt signal and this is fed into the processor’s Prioritised Interrupt Handler as IRQ4. Hytec Electronics Ltd– Page 92...
Page 93
32-bit value. RAM Memory The standard controller is equipped with 2 Mbytes of Static RAM memory provided by four 512K byte devices. RAM addresses are: 2 Mbyte Hex C00000 DFFFFC 4 x 512K Hytec Electronics Ltd - Page 93...
LLC Control Field (=UI Frame) Padding Byte (=0) Frame Type (=2 for Request, =3 for Response) CAMAC crate number Note: see Chapter 4.9.1 Find Address Protocol, PageError! Bookmark not defined.. Table A2 -2 FAP Multicast Frame Format Hytec Electronics Ltd– Page 94...
When pseudo LLC3 procedures are used, the LLC control field is set to “UI frame”, the first padding field is zero and the LLC3 control and status bytes are inserted into the pseudo LLC3 fields. Hytec Electronics Ltd - Page 95...
Page 96
Note that an immediate response request and its response must have both the first and last segment flags set to 1. Version The version number of the host software (allows version compatibility checking) Status The completion status of a requested operation (see Appendix 3.) Data The user data Hytec Electronics Ltd– Page 96...
The extended ESONE / DOE CAMAC routines have, as additional parameters, a variable identifying a local event flag (set on completion) and the address of an I/O status block which contains, on completion, the final status of the command. Hytec Electronics Ltd - Page 97...
Page 98
ECC 1365 MK4 User Program Parameter User block Code ESONE/DOE subroutines Central Routine Obtains lock ECC$LCK Exception Access Table Handler Global Section ECC$GBL Entry added ECC-1365 process Figure A3-1 User Process to ECC 1365 Host Process communication Hytec Electronics Ltd– Page 98...
If the command resulted from a call to an extended ESONE / DOE CAMAC routine, a summary of the command is written and added to the “awaiting completion “ queue and control passed back to the user-level code. The status indicating successful queuing of the command is available to the user-level code. Hytec Electronics Ltd - Page 99...
ECC_1365 process. The user process adds its PID to its Access Table entry to provide unique identification and all communications from a user process contain the PID of that process to ensure consistency Hytec Electronics Ltd– Page 100...
Network Time. The ECC_1365 process has the following functions Initialise the global section Initialise the Ethernet interface Run the Network Time Protocol (NTP) Process host user requests Process received network requests Handle error conditions Hytec Electronics Ltd - Page 101...
Where the request spans several buffers, these are queued serially on the transmission queue such that, with correct operation, the set is sent to the target system for reconstruction to the command block. Hytec Electronics Ltd– Page 102...
The NTP timeout is decremented and, on expiry, a NTP frame is generated. This contains the Network Time as perceived by the system, together with an estimate of the transmission delay imposed by this system. Hytec Electronics Ltd - Page 103...
A received ERP response frame is noted in the relevant entry in the LLC3 Control Table. If there is a User Command active, it is completed to the User with an error status and no other Commands are acted upon until the ERP active frame is received. Hytec Electronics Ltd– Page 104...
Page 105
ECC. An immediate response from an ECC returns user data, while a deferred response acknowledges receipt of the user data. The returning user data is encoded in an LLC3 command at some later time. Hytec Electronics Ltd - Page 105...
ECC 1365. The exchange is based on the combination of this process’s source Ethernet address and LSAP and the ECC Ethernet address and LSAP value. The LSAP value used depends upon the LLC3 exchange. Hytec Electronics Ltd– Page 106...
Error found when encoding / decoding a parameter description Booking request failed. The module / LAM is marked as promiscuous Duplicate CAMAC crate number seen on the network ECC reset requested by ERP Table A3 -3 Hytec Electronics Ltd - Page 107...
*reads issued by the driver *LSAP1 (in hexadecimal), used by LLC1 and LLC3 *LSAP2 (in hexadecimal), used by LLC3 *number of buffers in system * logging is enabled 5300 0000 0000 *LLC1 multicast address *User.txt logging enabled / disabled Hytec Electronics Ltd– Page 108...
A4 AUXILIARY CONTROLLER LOCKOUT MODE (ACL MODE) A4.1 Overview The ECC 1365 MK4 controller has been designed ONLY to operate in Request / Grant mode. The unit operates in Request/Grant mode and will respond to the ACL si g nal described below. A discussion of Request / Grant mode and ACL mode follows: A4.2 Multiple Controllers on the Auxiliary Control Bus (ACB)
The following list of error messages can be generated by the host process and the severity of each message is indicated. Very often, such error messages are accompanied by extract error messages from the operating system, which provide system-level details of a p articular failure. Hytec Electronics Ltd– Page 110...
<user process not initialised via CCINIT()> RESET <crate controller is resetting> TIMEOUT <timeout during I/O with CAMAC device> UNKNOWN-CMD <ECC command is unknown> UNKNOWN-CRATE <specified crate is unknown on the ether> UNLOCK-FAILURE <failed to release lock ECC$LCK> Hytec Electronics Ltd - Page 111...
<unable to get UIC/PID> QUEUE <queuing operation failed> READQ <failed to read input queue> RTIMER <failed to restart timer> TIMER <failed to start timer> UNLOCK <error unlocking ECC$LCK resource> WAIT <failed in system service wait> Hytec Electronics Ltd– Page 112...
Page 113
<the number of buffers is incorrectly specified> NLOG <the logging switch is incorrectly specified> NTPMULT <NTP multicast incorrectly specified> SAP1 <LSAP value not read or incorrectly specified> SAP2 <LSAP value not read or incorrectly specified> Hytec Electronics Ltd - Page 113...
Page 115
NOT QX during CAMAC operation BAD_VERSION Firmware/host version mismatch UNKNOWN <unknown error code returned> Note: Error codes produced by the firmware that are displayed on the front panel (e.g. crash codes) are listed in table12 on page 51. Hytec Electronics Ltd - Page 115...
Need help?
Do you have a question about the MK4 and is the answer not in the manual?
Questions and answers