Do you have a question about the RCIM Series and is the answer not in the manual?
Questions and answers
Subscribe to Our Youtube Channel
Summary of Contents for Concurrent Technologies RCIM Series
Page 1
Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment SERVICE CENTER REPAIRS WE BUY USED EQUIPMENT • FAST SHIPPING AND DELIVERY Experienced engineers and technicians on staff Sell your excess, underutilized, and idle used equipment at our full-service, in-house repair center We also offer credit for buy-backs and trade-ins •...
Page 2
Real-Time Clock and Interrupt Module (RCIM) Userís Guide 0898007-600 December 2011 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com...
Page 3
Copyright 2011 by Concurrent Computer Corporation. All rights reserved. This publication or any part thereof is intended for use with Concurrent Computer Corporation products by Concurrent Computer Corporation personnel, customers, and end–users. It may not be reproduced in any form without the written permission of the publisher. The information contained in this document is believed to be correct at the time of publication.
Preface Scope of Manual This manual is intended for users responsible for the installation and use of the Real-Time Clock and Interrupt Module (RCIM) on Concurrent Computer Corporation’s iHawk ® systems under the RedHawk Linux operating system. NOTE Three RCIM models are described in this guide: RCIM I, RCIM II and RCIM III.
Page 5
RCIM User’s Guide Operating system and program output such as prompts, messages and list listings of files and programs appears in list type. Brackets enclose command options and arguments that are optional. You do not type the brackets if you choose to specify these options or arguments.
Introduction Chapter 1 This chapter provides an overview and specifications for the Real-Time Clock and Interrupt Module (RCIM). NOTE Three RCIM models are described in this guide: RCIM I, RCIM II and RCIM III. The use of the term “RCIM” refers to functionality common to all three boards.
Hardware, Installation and Configuration Chapter 1 This chapter provides a description of the RCIM PCI-based boards as well as installation and configuration information. Board Descriptions This section provides illustrations and descriptions of the RCIM III, RCIM II and RCIM I boards.
Hardware, Installation and Configuration Connectors and LEDs Figure 2-2 shows the input/output connectors and LEDs on the RCIM III board. Detailed information on the LEDs and each of the connectors is provided in the following sections. Figure 2-2 RCIM III Connectors and LED Locations Output Input Status LED...
RCIM User’s Guide followed by brief intervals of bright RED and GREEN as a test. During normal operation of the board the LEDs function as follows: description Function O u t p u t RED solid 10 MHz clock failure S t a t u s RED 2/sec flash cable option installed but not synchronized or miss-...
Hardware, Installation and Configuration GPS Antenna The GPS option on the RCIM III includes an active GPS antenna and coaxial cable. The antenna receives the GPS satellite signals and passes them to the receiver. The GPS signals are spread spectrum signals in the 1575 MHz range and do not penetrate conductive or opaque surfaces.
RCIM User’s Guide Figure 2-3 RCIM III External Interrupt I/O Connector Pin-outs The external interrupt input signals are 5 volt ttl levels. The external interrupt outputs (labeled [0-11]) are driven using a line driver. The external interrupt EXT_PIG 74ABT16240 inputs are terminated with 180 ohms to +5 volts, 330 ohms and 0.1 uf to ground. To drive this input requires a line driver that can sink at least 30 ma.
Hardware, Installation and Configuration The signals , and are RS-232 level signals. EXT_RXD1 EXT_TXD1 EXT_RXD2 EXT_TXD2 They are currently used for debug purposes. System Identification The following output to lspci(8) shows the PCI class, vendor and device IDs for the RCIM III (0e:04.0 (bus:slot.function) will differ on your system): # lspci -v | grep -i rcim...
RCIM User’s Guide The last two messages indicate transient errors such as cable parity errors or temporary loss of cable synchronization. If a transient error occurs, it may require a link in the cable to resynchronize. If a distributed interrupt is being broadcast on the cable, it may be lost. Transient errors also affect the synchronization of the tick timers since the cable clock will not reach all of the systems.
Hardware, Installation and Configuration Detailed information on the LEDs and each of the connectors is provided in the following sections. Figure 2-5 RCIM II Connectors and LED Locations RJ45 Cable Connector LEDs 1-4 RJ45 Output RJ45 Input GPS Antenna External interrupt Cable Connector Cable Connector Connector...
RCIM User’s Guide Input and Output Cable Connectors The output cable connector is used when the RCIM II is either the master, or a slave in the middle of an RCIM chain (see page 2-18 for a description of RCIM modes). The input cable connector is used when the RCIM is acting in slave mode.
Hardware, Installation and Configuration Figure 2-6 RCIM II External Interrupt I/O Connector Pin-outs The external interrupt input signals are 5 volt ttl levels. The external interrupt outputs (labeled [0-11]) are driven using a line driver. The external interrupt EXT_PIG 74ABT16240 inputs are terminated with 180 ohms to +5 volts, 330 ohms and 0.1 uf to ground.
RCIM User’s Guide The signals , and are RS-232 level signals. EXT_RXD1 EXT_TXD1 EXT_RXD2 EXT_TXD2 They are currently used for debug purposes. System Identification The following output to lspci(8) shows the PCI class, vendor and device IDs for the RCIM II (0d:06.0 (bus:slot.function) will differ on your system): # lspci -v | grep -i rcim 0d:06.0 System peripheral: Concurrent Computer Corp RCIM II...
Hardware, Installation and Configuration RCIM I This section provides illustrations and descriptions of the RCIM I board. Board Illustration Figure 2-7 shows the RCIM I board. Figure 2-7 RCIM I Board Connectors 2-13 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com...
RCIM User’s Guide Connectors and LEDs Figure 2-8 shows the input/output connectors and LEDs on the RCIM I board. Detailed information on the LEDs and each of the connectors is provided in the following sections. Figure 2-8 RCIM I Connectors and LED Locations External Interrupts Connector (P4) Input Cable Connector (P3) Output Cable Connector (P2)
Hardware, Installation and Configuration Output Cable Connector (P2) The output cable connector is used when the RCIM I is either the master, or a slave in the middle of an RCIM chain (see page 2-18 for a description of RCIM modes). The cable attached to the output cable connector is called a synchronization cable (part no.
RCIM User’s Guide Input Cable Connector (P3) The input cable connector is used when the RCIM I is acting in slave mode (see page 2-18 for a description of RCIM modes). The cable attached to the input cable connector is called a synchronization cable (part no.
Hardware, Installation and Configuration Pin-outs for the external interrupts connector are shown in Figure 2-11. Figure 2-11 RCIM I External Interrupts Connector (P4) Pin-outs Debug Visibility Connector (P5) The debug visibility connector is intended for use on the Concurrent Computer Corporation manufacturing floor and should not be used outside of that environment.
RCIM User’s Guide Connection Modes When RCIM boards of various systems are chained together, an interrupt can be simultaneously distributed to all connected RCIMs, and from the RCIMs to all the associated host systems. NOTE All RCIMs in a chain must be the same model; for example, all RCIM IIs.
Hardware, Installation and Configuration Installation Normally, installation and configuration of the card is done by Concurrent Computer Corporation. This information is provided for those cases where an RCIM is added to a system in a post-manufacturing environment. In order to successfully install the RCIM, you must know if you will be using the RCIM to accept or deliver external interrupts and the mode in which the RCIM will run (isolated, master, pass-through slave or final slave).
RCIM User’s Guide Configuration Kernel Configuration The following RedHawk Linux kernel parameters are associated with the RCIM. All are accessible through the Character Devices selection of the Kernel Configuration GUI and are enabled by default in all the pre-built RedHawk Linux kernels. This parameter configures the RCIM driver in the kernel.
Hardware, Installation and Configuration • the manner in which various interrupts will be triggered: rising or falling edge, high or low level • associations between interrupts, output lines and distributed interrupt lines • the name of the system in an RCIM chain that has the master RCIM •...
RCIM User’s Guide General Considerations When configuring the RCIM systems, keep the following in mind: • For a chain of RCIMs, the tick clock and POSIX clock in all slave RCIMs will be synchronized with the master because the clock signal incrementing time in the master is broadcast to all slaves.
Hardware, Installation and Configuration ntp Configuration for GPS Support If your system contains the optional GPS module, ntp must be installed and configured to use the GPS receiver to synchronize the RCIM’s POSIX clock to GPS time. Follow these steps: 1.
Page 35
RCIM User’s Guide -216.56.81.86 193.131.101.50 49.388 -0.579 2.710 +new.localdomain .GPS. 0.182 0.010 0.020 *GENERIC(0) .GPS. 0.000 0.000 0.001 The output shows how the system time compares to other time sources. This includes the GPS receiver and other time servers. The column labeled remote is the hostname of the timeserver. The system new.localdomain is a local network time server;...
Functional Description Chapter 1 This chapter describes the clocks and interrupt capabilities provided by the RCIM and the user interfaces for each. Overview The Real-Time Clock and Interrupt Module (RCIM) provides two non-interrupting clocks. One of these clocks can be synchronized with all the RCIMs in an RCIM chain to provide a common time stamp across systems.
RCIM User’s Guide The Tick Clock The tick clock is a 64-bit non-interrupting counter that increments by one on each tick of the common clock signal. Although it cannot be set to a specific time, it can be incremented or set to zero. Hence the tick clock cannot be adjusted on the fly to approximate the current time of day as would be required of a true time-of-day clock.
Functional Description section “Using GPS for System Timekeeping” for details. Generally, only the master RCIM needs a GPS; slaves use one of the software methods available for syncronizing their POSIX clock to the master. Direct Access to the Clocks The device file /dev/rcimN/sclk (where N is the RCIM card number starting from zero) can be used to access the RCIM clocks directly using mmap(2).
Page 41
RCIM User’s Guide rcim_clocksync takes the following options: interactive mode (see below) prints the configured hostname where the RCIM master is located (see “Con- figuration” in Chapter 2). prints the RCIM connection state devname The device name desired RCIM board. Defaults /dev/rcim0/rcim which is the first RCIM board that was found on boot.
Functional Description Status: is one of the following: tick timer CABLE_SYNC – indicates that the RCIM slave clock is being driven by RCIM master cable clock signal, if posix clock available CABLE_ENABLE – indicates that the RCIM clock resets when RCIM master does a synchronization LOCAL_ENABLE –...
RCIM User’s Guide POSIX clocks in the RCIM chain so that they are consistent, if desired. For the RCIM III, run rcimdate on each slave; on return the slave’s RCIM POSIX clocks will be synchronized with the master. For RCIM I and II use the following rcim_clocksync interactive mode procedure defined below.
Page 44
Functional Description treats the GPS receiver as a time server. For information about how to configure NTP for this support, see the section “ntp Configuration for GPS Support” in Chapter 2. RedHawk Linux includes the RFC-2783 pulse per second (PPS) interface that synchronizes the system time to the GPS PPS interface.
RCIM User’s Guide Interrupt Processing One or more of the following modules is used for interrupt processing on the RCIM: • Edge-Triggered Interrupts (ETIs) – An ETI allows you to use an external event to trigger an interrupt. Documentation for ETIs begins on page 3-12. •...
Functional Description DIs and ETIs must be armed and enabled for an interrupt to occur. Each interrupt can be armed/disarmed and enabled/disabled individually. After power up initialization, all interrupts are disarmed and disabled. When the interrupt is armed, interrupt requests set a request bit. When an interrupt is disarmed, any outstanding requests are turned off and ignored.
RCIM User’s Guide Setting up Distributed Interrupts The RCIM provides the ability to share interrupts across interconnected systems using an RCIM chain. Although distributed interrupts are covered in detail starting on page 3-17, the figures below provide an illustration of how they operate. Guidelines for setting up distributed interrupts based on the illustration follow.
Functional Description and on OUT . It is possible to configure another signal processing module (say RTC ) to drive the interrupts on DI and OUT at the same time. In this case, the signal that drives the line will be the one with the strongest amplifier.
RCIM User’s Guide Edge-Triggered Interrupts Each RCIM board has incoming external interrupt lines, called ETIs or edge-triggered interrupts, so-named after their most common mode of operation. These lines permit users to provide their own interrupt sources. The RCIM processes and delivers these interrupts to the host system and, if they are distributed, routes and delivers them to all other RCIMs in the chain as distributed interrupts.
Functional Description ETI Device Files Each ETI is accessed through its own special device file: /dev/rcimN/etiM where N is the RCIM card number (starting from zero) and M is the ID of the ETI. These files are created automatically on system boot by the /etc/init.d/rcim initialization script.
RCIM User’s Guide Distributed ETIs Any or all of the ETIs on an RCIM can be distributed to all systems connected by an RCIM chain. The source of a distributed ETI can be located on any of the RCIMs in the chain.
Functional Description User Interface to RTCs A real-time clock timer is controlled by open(2), close(2), and ioctl(2) system calls. The close system call, if it closes the last open to the device, stops the RTC and clears its settings unless the ioctl command was issued to the RTC IOCTLKEEPALIVE before the close.
RCIM User’s Guide Configuration Each external output line can be configured to be driven by a specified source using the following configuration option: <source> | outN The value specified for the source can be one of the following: rtcN real-time clock timers pigN programmable interrupt generators etiN...
Functional Description external output, depending on how the PIGs are connected. The required length of the signal depends upon the requirements of the attached device. If the signal is being fed into another RCIM, it must hold any low or high value for at least 1.5 microseconds before changing to the next state.
RCIM User’s Guide DI Configuration It is important that all RCIM-connected systems have a compatible configuration for the distributed interrupt lines of the RCIM. By default, no distributed interrupts are configured. Distributed interrupts must first have a source, and then can be configured to trigger on the rising or falling edge of a signal, or on a high or low signal value.
Functional Description DI Device Files Each distributed interrupt is accessed through its own special device file: /dev/rcimN/diM where N is the RCIM card number (starting from zero) and M is the ID of the distributed interrupt. These files are created automatically on system boot by the /etc/init.d/rcim initialization script.
Registers Appendix A This appendix describes the registers on the RCIM boards. RCIM III Registers This section contains the address map and registers on the RCIM III board. RCIM III Address Map Address Function 0xXXXX0000 Board Status/Control Register (BSCR) 0xXXXX0004 Firmware Rev/Options Present Register (FWOP) 0xXXXX0010...
Registers RCIM III Registers RCIM III registers are illustrated in this section. NOTE: Unless otherwise stated, a bit value of 1=on; 0=off Figure A-1 RCIM III Board Status/Control Register (BSCR) This register provides status and control of certain features of the RCIM III board. Offset: 0000 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0...
Registers Figure A-3 RCIM III Interrupt Enable/Request/Pending/Clear/Arm/Level/Polarity Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) The enable registers (IER) enable the selected interrupts. The request registers (IRR) are software driven requests of the selected interrupts. The pending registers (IPR) are pending requests. The clear registers (ICR) clear the selected interrupts.
RCIM User’s Guide Figure A-6 RCIM III PPS Snapshot Register (PPS) The PPS Snapshot register contains a snapshot of the nanoseconds field and two bits of the seconds field of the POSIX clock. The snapshot is taken every time the GPS PPS signal occurs. Offset: 0200 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0...
Registers Figure A-9 RCIM III Clear Cable Errors Register (CCERR) This is a Write Only register that clears any reported cable errors. The data field is don’t care. Offset: 0400 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Clear Cable Errors Figure A-10 RCIM III Output Cable Status Register (OCSR) This register provides detailed hardware status information pertaining to the output cable.
RCIM User’s Guide Figure A-19 RCIM III Clock Frequency Adjust Register (CFAR) The clock frequency adjust register is used to control the frequency of the 10 Mhz master clock. Offset: 1120 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Clock Frequency Adjust Figure A-20 RCIM III RTC Timer Registers (RTCT) The initial RTC timer value is loaded in the RTC timer registers.
Registers Figure A-29 RCIM III GPS Communication Error Register (GCER) The GPS communication error register contains information regarding communication errors with the GPS module. Any write to this register will reset the communication interface to the GPS module. Offset: 320C Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 Reserved...
Registers RCIM II Registers RCIM II registers are illustrated in this section. NOTE: Unless otherwise stated, a bit value of 1=on; 0=off. Figure A-33 RCIM II Board Status/Control Register (BSCR) This register provides status and control of certain features of the RCIM II board. Offset: 0000 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0...
Registers Figure A-35 RCIM II Interrupt Enable/Request/Pending/Clear/Arm/Level/Polarity Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) The enable registers (IER) enable the selected interrupts. The request registers (IRR) are software driven requests of the selected interrupts. The pending registers (IPR) are pending requests. The clear registers (ICR) clear the selected interrupts.
RCIM User’s Guide Figure A-38 RCIM II PCI Interrupt Routing Registers (PARR, PBRR, PCRR, PDRR) Setting a bit in a PCI interrupt routing register routes selected interrupts to the designated PCI interrupt. The default power-up value is everything routed to PCI A. Setting bits in multiple registers will drive multiple PCI interrupt lines.
Registers Figure A-40 RCIM II PPS Snapshot Register (PPS) The PPS Snapshot register contains a snapshot of the nanoseconds field and two bits of the seconds field of the POSIX clock. The snapshot is taken every time the GPS PPS signal occurs. Offset: 0200 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0...
Registers Figure A-50 RCIM II RTC Timer Registers (RTCT) The initial RTC timer value is loaded in the RTC timer registers. The current value of the timer is read from this register. NOTE: Loading this register also loads the RTC Repeat Register for compatibility with RCIM. Offsets: RTC0T: 2010, RTC1T: 2030, RTC2T: 2050, RTC3T: 2070, RTC4T: 2090, RTC5T: 20B0, RTC6T: 20D0, RTC7T: 20F0 Bits...
Registers RCIM I Registers RCIM Iregisters are illustrated in this section. NOTE: Unless otherwise stated, a bit value of 1=on; 0=off. Figure A-55 RCIM I Board Status/Control Register (BSCR) This register provides status and control of certain features of the RCIM I board. Offset: 0000 Bits 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0...
RCIM User’s Guide Figure A-56 RCIM I Interrupt Enable/Request/Pending/Clear/ARM/Level/Polarity Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) The enable register (IER) enables the selected interrupt. The request register (IRR) is a software driven request of the selected interrupt. The pending register (IPR) is a pending request. The clear register (ICR) clears the selected interrupt.
Page 102
Calculating RCIM Cable Propagation Delays Appendix B This appendix provides calculations to determine if your cable connections introduce signal delays. RCIM III The maximum cable length between each interconnected RCIM III board is 30 meters (~100 feet). The clock runs at 400ns per tick. If the clock signal takes more than 400ns to make it to any given slave in the chain, clock skew will occur from that point on.
Page 103
RCIM User’s Guide Note that if a pass-through slave system is powered off, the cable clock will not be propagated to the slaves downstream from it. In this case, the downstream slaves will use their local oscillator instead of the cable clock. If chaining is to be done through different locations using different grounds, talk to your Concurrent representative about the risk of ground loops.
Page 104
Calculating RCIM Cable Propagation Delays It is recommended that systems be placed as close together as practical in order to minimize propagation delays. Extremely long runs through high RF noise or high temperature environments should be avoided when planning RCIM cable routes. Note that if a pass-through slave system is powered off, the cable clock will not be propagated to the slaves downstream from it.
Page 112
Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment SERVICE CENTER REPAIRS WE BUY USED EQUIPMENT • FAST SHIPPING AND DELIVERY Experienced engineers and technicians on staff Sell your excess, underutilized, and idle used equipment at our full-service, in-house repair center We also offer credit for buy-backs and trade-ins •...
Need help?
Do you have a question about the RCIM Series and is the answer not in the manual?
Questions and answers