REVISION HISTORY Revision Date Description of Change AN-2130mPCIe_Win10 06/19/2020 Initial Release Rev. New Holt Integrated Circuits...
Page 4
Application Development Kit (ADK) contents and how to run the demonstration software. Use the instructions in this guide to download/ install the Holt software and Microsoft Visual Studio 2019 IDE tool used for software development onto a user’s PC.
Page 5
8G is recommended for VS 2019. Hard Drive Capacity: 10G minimum for the VS2019 projects. Mini PCIe Slot Standard Full size F2 USB 2.0 or 3.0 Port: For transferring Holt Flash Drive files. Mini PCIe board block diagram VCCINT 1V Triple BUCK Power supply VCC1.8V...
Hardware Description The Holt Mini PCIe card features two Holt HI-2130 dual-redundant multi-terminals on a 50.95mm x 30mm form factor per the PCI Express Mini Card Electromechanical Specification (See below). A Xilinx XC7A12T FPGA serves as the interface between two HI-2130s and the PCIe Gen2 bus. The host communicates with the card using the built-in PCIe drivers once a PCIe link is established after power up.
Installing this project under “My Documents” may cause some files to be Read Only and prevent successful building of the projects. The distribution is released in a Win Archive file (MiniPCIeDual2130Win10.zip) which needs to be unzipped. It contains the following top-level hierarchy: Note: Filenames and dates may appear different Holt Integrated Circuits...
Reviewing the QSG-2130mPCIe_Win10 document prior to reading this document is highly recommended. In order to successfully execute the Holt demo program, the PC must be able to detect the card’s PCIe interface at power up. This section details the procedure to install the hardware, driver and run an initial test to ensure that the driver is fully functional under Windows 10.
The top level directory of the release kit has a directory called driver_installer which includes the holt_pcie.exe driver installer. At this time, Holt is not releasing the source code to the driver, but this structure is identical to our build procedure. In this step, we’ll install the Holt Windows driver. But first let’s make sure Windows detects the new hardware.
Page 11
2. If you have 2 mini PCIe cards installed, you’ll see a display as follows – typically under Other devices: 3. Open an explorer window to driver_installer: Right click the holt_pcie.exe and select Run as Administrator: Holt Integrated Circuits...
Page 12
A popup dialogue is produced – select Yes to allow the executable to make changes to your system: Another popup: Select Install: Holt Integrated Circuits...
Page 13
The Windows Driver installer pops up: click Next Holt Integrated Circuits...
Page 14
Click Finish and observe the Device Manager has now replaced the Other PCIe drivers with Holt’s: 6. If there was more than one Mini PCIe card previously installed, update the other drivers using the same steps. (In this example, we demonstrate two cards having been installed).
Page 15
For a two card system, it would be similar to the following: If it doesn’t find the Holt PCIe cards, then something is wrong with the driver just loaded. Remember that your connection strings won’t match ours because of the revision section of the string &rev_00#something unique#(3a3e415…) is unique.
Page 16
Click yes on this dialogue: Click next on this dialogue: Click Install on this dialogue: Holt Integrated Circuits...
Page 17
And finally Close: 2. Left click on the Windows Start Menu window to reveal the applications tray. Browse down to the H applications and observe that the Holt applications are now installed (along with an uninstaller): Holt Integrated Circuits...
Page 18
3. The icon: TheDir will open an explorer window to where the applications were installed: Holt Integrated Circuits...
Page 19
Windows SDK (which is included in the Visual Studio.) While the redistributable is part of the SDK, the redistributable can be obtained without Visual Studio. At Holt, we have proceeded down a path that includes VS2019. If VS2019 is not used, then to use the demonstration and download the Windows redistributable download from Microsoft directly.
Page 20
Before clicking install in the Visual Studio installer, select the Individual Components dropdown tab to also select the following elements: finally: Holt Integrated Circuits...
Page 21
Holt provides three main Visual Studio solutions for building, editing and debugging the Demo projects. In order to build the Holt API library projects the API source files are required but are not provided in the standard release. The API source files are available with a signed Holt Software License Agreement in place.
Page 23
H1553library.sln – builds the static and dll-based libraries for release or debug configuration and three project files: One for the Holt DLL-based API, One for the Holt static-lib based API, and one for the pthreads4w which we always dynamically link (and therefore use a dll). The Holt API source files (SLA required) are needed in order to rebuild these two projects.
Page 24
– this is an external file (a part of the windows redistributable program) checked into our repo and not rebuilt by our VS2019 workflow. The executables in the Demo/build/x64/bin directory include: HoltPCIeDemoDLL.exe – The dynamically loaded variant of the demo. HoltPCIeDemoWIN.exe – The statically linked variant of the demo. Holt Integrated Circuits...
Page 25
In order to facilitate this, Windows looks in any of the global path environment directories to see if it can find the dll that is required. Holt typically doesn’t use these global paths but a default path that seems universally acceptable is to place your .dll artifacts into the /Windows/System32 directory.
Page 26
To build the demonstration, we’ll build two variants: a static library-based Holt-1553 lib demo, and one which uses a dynamically loaded Holt 1553 library. The steps we’ll use are: build both libraries first, and then build the Demo exe files which use the alternate libraries last. We’ll use the Debug config in this first example: 1.
Page 27
2. Select the h1553library project (right-click) and select Clean Solution, then Rebuild Solution: Holt Integrated Circuits...
Page 28
Library code for debug workflows. Alternatively, customers without an SLA and who only receive Holt library binary files will not be able to step into the Holt Library API code, but will be able to debug their own code as well as the Holt Demonstration code outside of the library(s).
Page 29
3. Set a breakpoint at a convenient location to obtain control after the demo starts under debug control: Add a breakpoint by clicking here. The red dot indicates a breakpoint has been set which can be managed using the Debug dropdown here. Holt Integrated Circuits...
Page 30
5. A new command window will open up and the debugger will stop at your control point: New debug controls are now accessible for continue, single step, etc. This Red icon pinpoints the line the debugger has stopped on. A new command window has opened for dialogue. Holt Integrated Circuits...
Page 31
Commands are accepted by the chk_key_input() function. Some of the code for utilities is contained in console.c. All 1553 BC, RT and SMT demos that are contained in module Demo.c use Holt API library functions to access and manage the terminals. The BC is initialized to transmit messages and the RT and SMT are initialized to be able to read and write 1553 data words.
3. In Cmd Shell, if you have more than one card installed, the program will ask you to select a card – select 1: C:\Users\home\Burt\Projects\PcieDual2130VS\Demo\build\x64\bin> HoltPCIeDemoWIN.exe Holt Integrated Circuits Mini PCIe Windows 10 Demonstration Release 1.0 Windows found 2 PCIe Cards Choose PCIe Card <1..2>: Card Selected = 1 Opening Device: …#4&171d4e2e&0&00e3#...\ch0 Success: chan 0 Opening Device: …#4&171d4e2e&0&00e3#...\ch1 Holt Integrated Circuits...
Page 33
Press 'M' for menu, or press any valid menu key. >> The menu commands are very similar to other Holt ADK’s such as the ADK-6138, ADK-6130-2 or ADK- 6131. Lower case characters ‘a’, ‘n, ‘b’, ‘c’ and ‘r’ executes commands on the (Dev0) and ‘A’, ‘N’, ‘B’, ‘C’...
Page 34
BC message lists or interrupt log tables. 8. Command ‘1’, writes to a system register 0x0000-0x004F by device. 9. Command ‘2’, writes to any register/memory 0x0000-0x7FFF by device. 10. Command ‘n’ commands the BC to transmit 15 messages. Holt Integrated Circuits...
Page 35
0808 0909 1010 1111 1212 1313 1414 1515 1616 1717 1818 1919 2020 2121 2222 2323 2424 2525 2626 2727 2828 2929 3030 3131 3232 Dev0 MSG #0002. TIME = 00042020us BUS A TYPE1: RT to BC Holt Integrated Circuits...
Page 36
Dev0 MSG #0017. TIME = 00004352us BUS A TYPE2: RT to RT CMD1 182A --> 03-R-01-10 CMD2 0C2A --> 01-T-01-10 ERROR: NORES Dev0 MSG #0018. TIME = 00004416us BUS B TYPE2: RT to RT CMD1 182A --> 03-R-01-10 Holt Integrated Circuits...
Page 37
BUS A TYPE0: BC to RT CMD1 1822 --> 03-R-01-02 DATA 0005 0002 STA1 1800 Dev0 MSG #0046. TIME = 00096316us BUS A TYPE2: RT to RT CMD1 182A --> 03-R-01-10 CMD2 0C2A --> 01-T-01-10 STA1 0800 Holt Integrated Circuits...
Page 38
TIME = 00042566us BUS B TYPE0: BC to RT CMD1 0822 --> 01-R-01-02 DATA DEAD BEEF STA1 0800 Dev0 MSG #1534. TIME = 00098222us BUS A TYPE0: BC to RT CMD1 1822 --> 03-R-01-02 DATA 0005 0002 STA1 1800 Holt Integrated Circuits...
Page 39
Perform the following in command shell 1 after the above Demo is completed: To demonstrate the second HI-2130 (Dev1), a Holt IC card with two HI-2130’s is required, PN ADK- 2130mPCIe-2F. Execute the same commands but with Upper case letters.
Page 40
Demo exercises using Card 2: Devices 0 and 1: ADK-2130mPCIe-2F If a second card is available. While card 1 is currently executing the b, k, t, n, B, K, N, c, C, a, A demonstration above, repeat the same sequence in the second command shell exactly. Observe that both command shells demonstrate traffic is proceeding on Channels 0 and 1 in both shells.
Page 41
With an external terminal the Saleae will receive sufficient signal when the Holt devices transmit data. A much better tool would be use a 1553 tool such as the Ballard USB 1553 device. Below is a screen shot of four...
Page 42
Expanding the first transaction, you would find: Holt Integrated Circuits...
Page 43
UA1133:Copilot:Version 7.30.71315) The setup is as follows: A Holt Mini PCIe Dual MIL-STD-1553 Breakout board is required to be attached to the -1F or -2F 2130 Mini PCIe PCB which is being driven by the demo. The breakout board is attached with a fine-pitched ribbon cable which breaks out the MIL-STD 1553 signals.
Page 44
RT address to match the BC message using command ‘9’. Connect the external BC to a bus coupler and connect a stub from the bus coupler to the BNC connector on the optional Holt breakout board. See AN- 551 for proper bus connections.
Page 45
‘n’ and ‘a’ transmits messages to RT addresses 1 and 3. The BC message RT address is set in the BC message functions: bcAsync() and MajorMinorframe() in the demo code file “demo.c”. To alter these RT addresses in the BC command words the addresses need to be modified in the code. Holt Integrated Circuits...
Project Customizations Consideration for project customizations after becoming familiar with the Holt projects: Conform the project to the demo but keep the Holt Library build sub-architecture the same, (replacing the demo with the user application); or alternatively Add just the API library solution to your build environment’s workflow.
Page 48
Readable Spare input. MTPKTRDY Device -> FPGA Monitor Packet 0x800F Read only Optional read ready device output ACTIVE Device -> FPGA Active state 0x8010 Read only Optional read RT1MC8 Device->FPGA RT1 Mode Code 8 0x8011 Read only Optional read Holt Integrated Circuits...
Page 49
FPGA initialization sequence is complete and asserts the DONE_0 signal high. LED D10 lights up when the FPGA is in a configuration reset state and will turn off when the initialization is complete. Xilinx provides a complete technical guide on the FPGA configuration sequence. See Xilinx UG470. Holt Integrated Circuits...
Page 50
COMMENTS CONNECTOR Address pins: [A15:A0] Address bus Data bus pins: [D15:D0] Bidirectional data bus Read strobe (Intel mode) Write strobe (Intel mode) MCLK50 Master 50MHz input clock from FPGA MTTCLK Optional clock, TBD TTCLK Optional clock, TBD Holt Integrated Circuits...
Page 51
MTRUN0 Input, controlled by FPGA. READY0, ACTIVE0 Outputs, Inputs to FPGA. Function TBD. MTPKTRDY0 Output, Not used or TBD. TXINHA,TXINHB Both inhibit inputs connected to CH0INHIBIT0 on connector. Default is enabled. Assert low to disable both Transmitters. Holt Integrated Circuits...
Page 52
Both inhibit inputs connected to CH1INHIBIT1 TXINHA,TXINHB on the connector. Default is enabled. Assert high to disable both Transmitters. J4 connector input pins: Transmit Inhibit, BCENAx, BCTRIG are ESD protected but the DC steady state voltage should not exceed 3.6V. Holt Integrated Circuits...
VCCO3V3 1000mA 200mA Flash, Osc and Misc. 3.3V 3V3aux 2 x HI-2130 1600mA 1553 messaging duty cycle dependant (PCIe conn.) 1.5V (PCIe MGTAVCC1V Provides clean 150mA <100mA conn.) power to the GBT MGTAVCTT1V2 150mA <100mA (PCIe bus) Holt Integrated Circuits...
Page 54
0 & 1 1.86 50 with fan 45 with fan 0 & 1 1.78 0 & 1 1.02 .655 0 & 1 0 & 1 IDLE Note: ICC will be less with typical 75Ω bus coupler impedance. Holt Integrated Circuits...
Page 55
Channel 0 BC Trigger. 10K pull-up. SPARE INPUT Unused. CH1INHBIT1 Channel 0 Transmit Inhibit. 10K pull-up. Inverted direct connect to 2130 inhibit pins. CH1 BCENAB Channel 1 BC Enable. 10K pull-up. CH1 BCTRIG Channel 1 BC Trigger. 10K pull-up. Logic GND Holt Integrated Circuits...
FPGA pin. This could be an input or output – user defined. ADC 12-bit converter An ADC input is provided on a test point but this feature is not implemented in the current design. The user has the option to implement this if there is a requirement. Holt Integrated Circuits...
Page 57
FPGA Spare Pins See the schematic for spare pins. Figure 5 – Board References Holt Integrated Circuits...
Page 58
Summary This technical guide provided simple steps on how to use this release to demonstrate Holt’s Mini PCIe 2130-1f and -2f cards in a Windows 10 environment. This technical guide summarized the steps necessary to install the Holt Mini PCIe Visual Studio 2019 projects and solution files, building the projects and executing the Demos from either a command line or within the Visual Studio Debugger.
Page 59
Holt Integrated Circuits, Inc. Bill of Materials PCB P/N: HV047 EV-2130mPCIe-1F Rev.A Evaluation Board Item Qty Description Reference Digikey P/N Mfg P/N PCB, Bare, Evaluation Board 399-8939-1-ND Kemet C0402C100C8GACTU Cap Cer 10pF 10V COG/NPO 0402 SMD C5,C9 Cap Cer 0.01uF 16V X7R 0402 SMD...
Page 60
Holt Integrated Circuits, Inc. Bill of Materials PCB P/N: HV047 EV-2130mPCIe-1F Rev.A Evaluation Board 1497-1219-1-ND SunLED XZVG68W-2 Green Led, Clear 0402 SMD D1,D2,D6,D7,D8,D9,D10 Conn 8-Pin 0.8mm Micro Socket CLE-104-01-G-DV Samtec CLE-104-01-G-DV Through Hole 3-Pin Connector J3 (DNI) None None SAM14910CT-ND Samtec ZF5S-20-01-T-WT-TR Conn Zero Insertion 20-pos,0.5mm FFC...
Page 65
LD39015 SOT23-5L Title Title Title Note 1: Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Distribute power over planes to where they need to go under the PCB LAYOUT NOTES IN GREEN Size...
Page 66
IO_L13N_T2_MRCC_15 JTAG IO_L14P_T2_SRCC_15 IO_L14N_T2_SRCC_15 IO_L19N_T3_A21_VREF_15 0.47uF 0.47uF BANK 15 Title Title Title Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 XC7A12T-2CPG238 Size Size Size Document Number Document Number Document Number R e v...
Page 67
MGTAVTT1V2 3V3aux 3V3aux .1uF .1uF .1uF CHANNEL 0 Title Title Title Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Size Size Size Document Number Document Number Document Number R e v R e v R e v <Doc>...
Page 68
MGTAVTT1V2 3V3aux 3V3aux .1uF .1uF .1uF CHANNEL 1 Title Title Title Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Holt PCIe-Mini dual MIL-STD 1553 Size Size Size Document Number Document Number Document Number R e v R e v R e v <Doc>...
Need help?
Do you have a question about the ADK-2130mPCIe and is the answer not in the manual?
Questions and answers