mmWave OTA Positioner Control Plug-In 1.0 for MilliBox™ Chamber Readme

November 2021

This file contains installation instructions and compatibility information for the mmWave OTA Positioner Control Plug-In 1.0 for MilliBox™ Chamber.


Overview

Application Software Support

Supported Hardware

Installation Instructions

Getting Started

Product Security and Critical Updates

Finding Installed Software

Automating the Installation of NI Products

Using NI Software with Microsoft Windows 10

Legal Information


Overview

The mmWave OTA Positioner Control Plug-In for MilliBox Chamber enables compact benchtop over-the-air (OTA) validation test of 5G mmWave antenna modules.

The mmWave OTA Positioner Control Plug-In for MilliBox Chamber is a software add-on for mmWave OTA Validation Test Software that provides support for the chambers and positioners designed by Milliwave Silicon Solutions Inc. This software add-on features plug-and-play integration with the mmWave PXI Vector Signal Transceiver (VST) and can be used with mmWave OTA Validation Test Software to help you configure, run, visualize, and report OTA radiated performance without coding.

Supported Operating Systems

The mmWave OTA Positioner Control Plug-In 1.0 for MilliBox Chamber supports Windows 10 (64-bit).

Application Software Support

Refer to the following table and the mmWave OTA Validation Test Software Readme, accessible from mmWave OTA Validation Test Software Release Notes, for the application software versions, including service packs, supported by the mmWave OTA Positioner Control Plug-In 1.0 for MilliBox Chamber. If you are not using NI application software, refer to Microsoft Visual Studio Support.

Application Software Versions Supported by the mmWave OTA Positioner Control Plug-In 1.0 for MilliBox Chamber
MilliBox Software Driver R20.1
mmWave OTA Validation Test Software 21.0 and later

Note When you use the mmWave OTA Positioner Control Plug-In for MilliBox Chamber, the following features of mmWave OTA Validation Test Software are not supported:

  • OTA autonomous measurements
  • Usage of the mmWave OTA Validation Antenna Alignment Helper

Microsoft Visual Studio Support

If you use the .NET API, .NET Framework 4.0 (minimum) is required. The .NET API of the mmWave OTA Positioner Control Plug-In 1.0 for MilliBox Chamber can be used with Visual C# or Visual Basic .NET in any Visual Studio version that can target .NET Framework 4.0 or .NET Framework 4.5.

To use the .NET API, you must install the .NET class libraries or the .NET wrapper in addition to the NI device driver. For information about versions of the .NET Framework and the drivers each supports, as well as the download location of the installer files, refer to .NET Resources for NI Hardware and Software.

Supported Hardware

The mmWave OTA Positioner Control Plug-In for MilliBox Chamber supports the chambers and positioners designed by Milliwave Silicon Solutions Inc.

Installation Instructions

Download the mmWave OTA Positioner Control Plug-In for MilliBox Chamber installer from ni.com/downloads. NI software includes NI Package Manager to handle the installation. Refer to the NI Package Manager Manual for more information about installing, removing, and upgrading NI software using Package Manager.

What to Do Next

After you install the mmWave OTA Positioner Control Plug-In for MilliBox Chamber, complete the following procedure before you use the software.

<NIDocDir> is an alias for the following National Instruments file folder location: Users\Public\Public Documents\National Instruments.

Programming Platform Procedure
LabVIEW Copy the MilliBox folder, located at <NIDocDir>\OTA Test\Plugins\Positioners\LabVIEW\PPL\MilliBox, to the labview\user.lib\OTA Test\Plugins\Positioners\PPL directory.
.NET Framework Copy all the dynamic link library (.dll) files, located at <NIDocDir>\OTA Test\Plugins\Positioners\DotNET\<VS20xx>\MilliBox\DLL, to the <NIDocDir>\OTA Test\Examples\DotNET\<VS20xx>\References directory.

Getting Started

Complete the following step to use the mmWave OTA Positioner Control Plug-In for MilliBox Chamber with mmWave OTA Validation Test Software:

  • If you use the mmWave OTA Validation Configurator, choose MilliBox from the Positioner Plugin drop-down menu.
  • If you use the mmWave OTA Validation Positioner Control Panel, choose MilliBox from the Positioner Type drop-down menu.
  • If you use the .NET API, perform the following steps:
    1. Open the OtaTestExample.sln solution file.
    2. Add the NationalInstruments.OtaMeasurementLibrary.Positioner.MilliBox.dll file to the OTATestLibrary.csproj project file.
    3. Open the StepByStepTxTest.cs file and change BojayEthercatPositioner to MilliBoxPositioner.
    4. Rebuild the solution file.

Product Security and Critical Updates

Visit ni.com/security to view and subscribe to receive security notifications about NI products. For information about critical updates from NI, refer to Available Critical and Security Updates for NI Software.

Finding Installed Software

Find the installed items of the mmWave OTA Positioner Control Plug-In for MilliBox Chamber in the following directories.

Item Installed Location
Source Code for LabVIEW<NIDocDir>\OTA Test\Plugins\Positioners\LabVIEW\Source\MilliBox
Source Code for .NET <NIDocDir>\OTA Test\Plugins\Positioners\DotNET\<VS20xx>\MilliBox\Source
Pre-Built LabVIEW Packed Project Library (PPL)
  • <NIDocDir>\OTA Test\Plugins\Positioners\LabVIEW\PPL\MilliBox\MilliBox.lvlibp
  • <NIDocDir>\OTA Test\Plugins\Positioners\LabVIEW\PPL\MilliBox\Base.lvlibp
  • <NIDocDir>\OTA Test\Plugins\Positioners\LabVIEW\PPL\MilliBox\Init Configuration.xml
Pre-Built Dynamic Link Library (DLL)
  • <NIDocDir>\OTA Test\Plugins\Positioners\DotNET\<VS20xx>\MilliBox\DLL\NationalInstruments.OtaMeasurementLibrary.Positioner.MilliBox.dll
  • <NIDocDir>\OTA Test\Plugins\Positioners\DotNET\<VS20xx>\MilliBox\DLL\NationalInstruments.OtaMeasurementLibrary.Positioner.MilliBoxDriver.dll

Automating the Installation of NI Products

You can automate the installation of most NI products using command-line arguments to suppress some or all of the installer user interface and dialog boxes.

If the NI product you are installing uses Microsoft .NET 4.6.2, the .NET installer may run before any NI software installs and may require a reboot before the installation of NI software begins. To avoid a .NET reboot, install .NET 4.6.2 separately before you install NI software.

For more information about automating the installation of NI products, refer to Automating an Installer in the NI Package Manager manual.

Using NI Software with Microsoft Windows 10

Microsoft Windows 10 is the latest version of the Windows operating system and features significant changes compared to previous versions. Windows 10 introduces several new capabilities and also combines features from both Windows 7 and Windows 8. For more information about NI support for Windows 10, refer to NI Product Compatibility for Microsoft Windows 10.


Legal Information

Copyright

© 2021 National Instruments Corporation. All rights reserved.

Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

NI respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.

End-User License Agreements and Third-Party Legal Notices

You can find end-user license agreements (EULAs) and third-party legal notices in the following locations after installation:

  • Notices are located in the <National Instruments>\_Legal Information and <National Instruments> directories.
  • EULAs are located in the <National Instruments>\Shared\MDF\Legal\license directory.
  • Review <National Instruments>\_Legal Information.txt for information on including legal information in installers built with NI products.

U.S. Government Restricted Rights

If you are an agency, department, or other entity of the United States Government ("Government"), the use, duplication, reproduction, release, modification, disclosure or transfer of the technical data included in this manual is governed by the Restricted Rights provisions under Federal Acquisition Regulation 52.227-14 for civilian agencies and Defense Federal Acquisition Regulation Supplement Section 252.227-7014 and 252.227-7015 for military agencies.

IVI Foundation Copyright Notice

Content from the IVI specifications reproduced with permission from the IVI Foundation.

The IVI Foundation and its member companies make no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The IVI Foundation and its member companies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Trademarks

Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on NI trademarks. MilliBox is a trademark of Milliwave Silicon Solutions Inc. Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

For patents covering the NI products/technology, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your media, or the NI Patent Notice at ni.com/patents.

378727A-01