Folder Size 6.1 Serial
1.6 Changes in version 1.30Added features for Promira platform SPI Active Level 2 Application. 2 General OverviewThe Promira Serial Platform with the I 2C/SPI Active applications and eSPI Analysis application supports I 2C master/slave active modes; Single, Dual, and Quad SPI master/slave active modes; and Single, Dual and Quad eSPI analysis modes. The Promira platform supports up to 8 SPI SS/CS signals, up to 16 GPIO signals, and up to 11 eSPI Digital IO signals depending on purchased application. The Promira platform connects to an analysis computer via Ethernet or Ethernet over USB. The applications installed on the Promira Serial Platform are field-upgradeable and future-proof. 3 Applications.
Table 1 (1): Applications Description ApplicationMax Bitrate (Master/Slave MHz)Max GPIO SignalsDigital IO SignalsMax SS/CS SignalsSlave Response Level (1)Slave Response Capability (1)Slave Response Size (1)I 2C Active Level 11/16NANAAdvanced Slave1 slave address, 1 response256 BytesI 2C Active Level 23.4/3.412NANAAdvanced Slave1 slave address, 1 response256 BytesSPI Active Level 112.5/86NA1Advanced Slave1 response256 BytesSPI Active Level 240/2012NA3Advanced Slave, Ultra SlaveAdvanced Slave: 1 response. Ultra Slave: Multiple responses256 BytesSPI Active Level 380/2016NA8Advanced Slave, Ultra SlaveAdvanced Slave: 1 response. Ultra Slave: multiple responsesAdvanced Slave: 256 Bytes. Ultra Slave: Up to 64 MByteseSPI Analysis66NA112NANANANotes:(1) Ultra Slave will be released at a future date. 4 Hardware Specifications.
5.1 Compatibility 5.1.1 OverviewThe Promira Serial Platform software is offered as a 32-bit or 64-bit Dynamic Linked Library (or shared object). The specific compatibility for each operating system is discussed below. 5.1.2 Windows CompatibilityThe Promira Serial Platform software is compatible with 32-bit and 64-bit versions of Windows 7, and Windows 8/8.1. The software is provided as a 32-bit or 64-bit application. 5.1.3 Linux CompatibilityThe Promira Serial Platform software is compatible with 32-bit and 64-bit standard distributions of Linux with kernel 2.6 and integrated USB support including: Red Hat, Ubuntu, Fedora, and SuSE.
The software is provided as a 32-bit or 64-bit application. When using the 32-bit library on a 64-bit distribution, the appropriate 32-bit system libraries are also required. When using either the 64-bit library or 32 bit library, the appropriate system libraries are also required. 5.1.4 Mac OS X CompatibilityThe Promira Serial Platform software is compatible 32-bit and 64-bit Intel versions of Mac OS X 10.7 Lion, 10.8 Mountain Lion, 10.9 Mavericks, 10.10 Yosemite, and 10.11 El Capitan. The software is provided as a 32-bit or 64-bit application.
Installation of the latest available update is recommended. 5.2 ConnectivityThere are two ways to connect to the Promira Serial Platform: via USB or via Ethernet. No additional device drivers are required for using either method. 5.2.1 USBThe Promira Serial Platform uses Ethernet over USB, which allows the host software to connect to the adapter via an IP address. To use this interface, connect the device to your PC with a USB cable and follow the instructions below to set up the connection on the PC.For Ethernet over USB, the Promira Serial Platform is a DHCP server that dynamically distributes network configuration parameters, such as IP addresses for interfaces and services. Windows.
Connect Promira to PC with USB cable. After the device is connected to the development PC, Windows will automatically search for the appropriate RNDIS driver. To verify the drive is installed correctly, right-click on Computer and select Manage. From System Tools, select Device Manager. If the Total Phase Promira platform shows up with an exclamation mark, continue to the next step and install the driver.Otherwise, close this window, skip RNDIS driver installation in the next step and continue to the following step. Install RNDIS driver:. Right-click on Total Phase Promira platform device and select Update Driver Software.
When prompted to choose how to search for device driver software, choose Browse my computer for driver software. Browse for driver software on your computer will come up. Select Let me pick from a list of device drivers on my computer. A window will come up asking to select the device type.
Folder Size 6.1 Serial Code
Select Network adapters, as RNDIS emulates a network connection. In the Select Network Adapter window, select Microsoft Corporation from the Manufacturer list. Under the list of Network Adapter:, select Remote NDIS compatible device.
The Total Phase Promira platform device is now installed and ready for use. From the Start menu, select Control Panel Network and Internet Network and Sharing Center. Select Change adapter settings on the left panel.
Right-click on the USB Ethernet/RNDIS Gadget adapter, select Properties. Figure 3: Windows IPv4 Properties dialog. Select OK and Close to dismiss the dialogs.
In order to make sure it is ready or to know the IP address of the Promira Serial Platform, right-click on the USB Ethernet/RNDIS Gadget adapter, select Status and then select Details. The IP address assigned to the network interface on the host PC is will be in the format of 10.x.x.x and is listed as the IPv4 Address. The IP address of the device will be at the preceding address. For example, the image below shows 10.1.0.2 for the host IP address.
The device address will then be 10.1.0.1. This device address will also be displayed in the Control Center software and will be needed when connecting to the device using the API. Figure 5: Mac OS X Network Preferences window. Select Using DHCP from the Configure IPv4: dropdown list box. Select Apply to apply the changes.5.2.2 EthernetThe Promira platform can be connected to the computer through the Ethernet port. The Promira network preference for Ethernet is configurable by the Control Center Serial.
The Promira platform can be configured to static IP addressing or dynamic IP addressing (DHCP). The default network preferences of the Promira platform for Ethernet is a static and its IP address is 192.168.11.1. This IP address can be changed using the promira command-line application provided in the util folder in the Promira API package. For more details see the Control Center Serial manual section 2.8 Configuring Network Preference and the README.txt file in the API package. 5.4 Dynamically Linked LibraryThe Promira requires the Promira DLL to operate and is only compatible with the Promira Serial Platform.In addition to the Promira DLL, the Aardvark Compatibility DLL is provided to make the Aardvark API available for legacy and compatibility purposes. 5.4.2 DLL LocationTotal Phase provides language bindings that can be integrated into any custom application.
The default behavior of locating the Promira DLL and the Aardvark Compatibility DLL is dependent on the operating system platform and specific programming language environment. For example, for a C or C application, the following rules apply:On a Windows system, this is as follows:. The directory from which the application binary was loaded.
The applications current directory. 32-bit system directory (for a 32-bit application). Examples:.
c:WindowsSystem32 Windows 7/8 32-bit. c:WindowsSysWow64 Windows 7/8 64-bit.
64-bit system directory (for a 64-bit application). Examples:.
C:WindowsSystem32 Windows 7/8 64-bit. The Windows directory. (Ex: c:Windows ). The directories listed in the PATH environment variable.On a Linux system, this is as follows:.
First, search for the shared object in the application binary path. 6.1 Field Upgrades 6.1.1 Upgrade PhilosophyThe Promira Serial Platform is designed so that its internal firmware (FW) and License can be upgraded by the user, thereby allowing the inclusion of any additional applications purchased, software support renewals, performance enhancements, or critical fixes available after the receipt of the device.The Promira Serial Platform shows multiple FW version numbers in the Control Center Serial GUI Configure Adapter window, Flash Center GUI - Add Adapters window, Data Center GUI connect window, and the Promira Utility window. The first one is the version number of the system FW and the others are the version numbers of the various Promira applications. For example, the FW numbers 1.10/1.00/x.xx represent FW system v1.10 and FW application v1.00 and so on.Promira API has four main FW functions: pmversion, pmappversion, psappversion, and paappversion. Promira API function pmversion returns FW system version and Promira API functions pmappversion, psappversion, and paappversion return FW application versions. PMNETCONFIGERRORUnable to configure network interface.PMINVALIDIPADDRInvalid IP address.PMINVALIDNETMASKInvalid network mask.PMINVALIDSUBNETThe 192.168.12.x subnet is reserved. It is an error to configure the Ethernet interface to any address in this subnet.PMNETCONFIGLOSTCONNECTIONApplying the last settings has changed the IP address of the connection.
Any further access doesn't work since the connection to the device has lost and pmclose needs to be called to clean up the resources. 8.1 DisclaimerAll of the software and documentation provided in this manual, is copyright Total Phase, Inc. License is granted to the user to freely use and distribute the software and documentation in complete and unaltered form, provided that the purpose is to use or evaluate Total Phase products. Distribution rights do not include public posting or mirroring on Internet websites. Only a link to the Total Phase download area can be provided on such public websites.Total Phase shall in no event be liable to any party for direct, indirect, special, general, incidental, or consequential damages arising from the use of its site, the software or documentation downloaded from its site, or any derivative works thereof, even if Total Phase or distributors have been advised of the possibility of such damage.
The software, its documentation, and any derivative works is provided on an 'as-is' basis, and thus comes with absolutely no warranty, either express or implied. This disclaimer includes, but is not limited to, implied warranties of merchantability, fitness for any particular purpose, and non-infringement. Total Phase and distributors have no obligation to provide maintenance, support, or updates.Information in this document is subject to change without notice and should not be construed as a commitment by Total Phase. While the information contained herein is believed to be accurate, Total Phase assumes no responsibility for any errors and/or omissions that may appear in this document.
8.2 Life Support Equipment PolicyTotal Phase products are not authorized for use in life support devices or systems. Life support devices or systems include, but are not limited to, surgical implants, medical systems, and other safety-critical systems in which failure of a Total Phase product could cause personal injury or loss of life. Should a Total Phase product be used in such an unauthorized manner, Buyer agrees to indemnify and hold harmless Total Phase, its officers, employees, affiliates, and distributors from any and all claims arising from such use, even if such claim alleges that Total Phase was negligent in the design or manufacture of its product.