500 A Huntmar Park Drive ASTi Telestra and Model Builder Visual Quick Start Guide Document: DOC-02-TMBV-QSG-1 Advanced Simulation Technology inc.
ASTi ASTi Telestra Model Builder Visual Quick Start Guide © Copyright ASTi 2008. Restricted Rights: Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. This material may be reproduced by or for the U.S. Government pursuant to the copyright license under the clause at DFARS 252.227-7013 (1994).
Table of Contents 1.0. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.0. Installing and Starting a New Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.1. Setting up the Telestra onto a Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.1.1. Restoring a Configuration ...................................................................................... 2 2.2. Uploading the Options File . . .
ii
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 1.0. Introduction The main goal of this document is to get your telestra up and running after removing it from the box. Section 2.0 provides a step-by-step process to get your telestra running with RMS and the ASTi provided model file. Section 3.0 provides an introduction of the Model Builder Visual (MBV) development environment. 2.0.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 2.1.1. Restoring a Configuration If you have an archived configuration, you may want to restore this configuration instead of starting from scratch. After setting the IP address for eth0, navigate to a workstation on the network with a local web browser. Type the IP address in the web browser address bar as follows: http://xxx.xxx.xxx.xxx/ where “xxx.xxx.xxx.xxx” is the IP address previously assigned to eth0 using the Telestra Configuration Utility.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) Select the file(s) you would like to restore by checking the proper box(es). Then select the “Start Restoration” button. The RMS page will show the files for restoration. Review the list and select to restart the system. Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 2.2. Uploading the Options File A system must have an Options File to activate full software functionality. For more details about Options Files see “System Options” in the Telestra 3.0 User Guide (DOC-01-TELS-UG-3). To upload an Options File navigate to RMS through a local web browser on the network and select Telestra >> Options in the top menu bar.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 2.3. Creating a new User Account Now you are ready to get RMS up and running. 1. Open up a web browser on a computer that is connected to the same network as the Telestra. Note: A quick test to confirm the computer is running on the same network is to use the standard networking “ping” command from your browser computer, use ping . In the web browser's address field type in the IP address of the Telestra you just recorded in step 4. 2.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 3. You will be presented with the RMS System Status screen. Navigate to Telestra > Preferences. 4. In the System Preferences screen (shown above), mouse to the “Add New User Account” and select that link. 5. You should now see the Add New User Account screen. Enter a new user ID and a password and select “Create User.” 6 Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 6. Log in as the user you just created. To do this you must close the browser the start it back up. 7. Enter the IP address of the Telestra and the new created username and password. Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 2.3.1. Creating a User Account with MBV software version 3.27 or After First complete the first two steps in section 2.2 Creating User Accounts, then continue with step three below. 3. You will be presented with the RMS System Status screen. Select “Manage Users” at either the top or bottom right of the RMS screen. 8 Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4. First create a new RMS User Account using “astirules” for the Your Password field. Add a new user name, password and select privileged, if you would like your user to be able to manage accounts and Telestra log files. For more information on privileged vs. standard users read section 4.0 of the Telestra 3.0 User's Guide (DOC-01-TELS-3). Click the “Add RMS User” button to continue. Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 5. A system-level user is a standard Linux user account. Only system-level users can perform model development. Add a new username and password under the System User section and select “Add SYSTEM User.” Remember to use astirules for the Your Password field. 6. Log in as the user you just created, to do this you must close the browser and reopen it. 7. Enter the IP Address of the Telestra and the newly created username and password.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 3.0. Installing Your Model Now that you have created a new user account it is time to upload and install your model. 1. Navigate to the Models > Management Screen. 2. The next step is to get your model onto the computer you are using so you can access it via RMS. This step will vary depending on how you've received your model. A) If it's on a CD, place the CD into the computer running RMS.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 5. You will see the selected file to the right of the “Choose File” button. To choose a user to receive the model, select the drop down box that reads “Embedded Ops” under the Model Installation step 2. This drop down list will display all the users on this particular Telestra. Select your user account. 6. Select the “Upload Model File” button to the right of the user drop down list. 7. You will now see the Telestra Model Installation screen, shown below.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 8. The next screen allows you to choose which parts of the model you want to install. If this is a new model delivered from ASTi, make sure the YES box is checked for all the fields. Once done select “Install Files Now.” Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 9. Once the installation is complete the screen will display “Installation completed” 14 Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 3.1. Getting Your Model Ready to Run Now that your model is installed, you must get the model ready to run. This will require loading the model and mapping your audio distribution device, the Iris, to the Iris assets in the model. 3.1.1. The Concept of Mapping When a model is developed the final target hardware is not available, hence the model uses “labels” to refer to the connections that will be required to link the software to the hardware.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4. From this screen navigate to the Hardware > Mapping screen. You will see a list of Irises and quite a few “Map it” buttons. The number of Irises shown on this screen will depend on the number of Irises that are in the model, not the number of Irises connected to the Telestra. 5. Select the “Map it” button to the right of the first Iris (or any of the Irises). This will open the Iris Hardware Assignments page.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 6. For each Iris, select a different serial number using the drop down box. This maps the Iris asset in MBV to the Iris hardware connected to the Telestra. Once all the Irises have been mapped, select the “Map Hardware” button. 7. The model will reload. Again, this may take a few minutes. Be patient and when the model is reloaded the screen will read “Model is now Loaded.” Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 8. Return to the Hardware > Mapping page to set the gain and input settings for each Iris channel. Click the “Settings” button next to an Iris to open the Iris Model Settings window. Set the gain and input settings in accordance with the hardware that is plugged into each channel. WARNING: Selecting DC power will place a voltage on the line that can damage hardware if improperly selected.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 9. Once complete, press the “Set Gains & Inputs” button. After the gain & input settings are processed, close the window and repeat for every remaining Iris. 10.Last you must start the model. Navigate to the Model > Management screen. You should see a new link under the Model State column of your user account. It should say “Stopped” and then have a link that says, “start model”. Select the “start model” link. The status should change to “Running.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 3.2. Mapping The UDP Packets If you are planning on using a host computer to populate the fields of the UDP packet, you will need to map the UDP packet asset in the model to an IP address and a port. 1. In RMS, navigate to Models > Host Interface. Here you will see 4 fields. The IP address drop down box lists the IP address of the 3 Ethernet ports on the Telestra. 2. Choose one IP address to assign to the model UDP Packet. 3.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) Congratulations! You've installed, mapped and started your model! Now given the correct inputs your model should do whatever it was designed for! Copyright © 1999-2008 Advanced Simulation Technology inc.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.0. MBV Overview While the complexities of the Model Builder Visual development environment are beyond the scope of this document, this section provides an overview to familiarize you with the MBV layout and components. After booting the Telestra in Development mode and logging in on the console with your new user account, open MBV by clicking on the “MBV” palette icon in the Telestra workspace toolbar.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.1. MBV Layout The MBV development environment is divided into five areas: 1. The main area is the Workspace. The user creates the model in the main workspace area by right clicking and adding components and links. 2. The top Toolbar provides additional tools for creating the model. 3. The sidebar is Model Explorer and Components column. When creating larger models the user can create subfolders to organize different objects in the model.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.2. ICD Tool The Interface Control Definition (ICD) tool allows a host computer and an MBV model to share information via ethernet UDP packets by labeling and standardizing the information contained in the UDP packet. In other words, the ICD tool defines an XML packet layout. When creating an ICD, the user creates the packets that makeup the ICD and the members that makeup the packets.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.3. Sound Library The sound library is used with the playsound component (Psound255) in MBV to add wave files to a model. The wave files must be loaded onto the development telestra before the sound library can access them. The following actions can be performed with the sound library tool: 1. Add new playfiles 2. Name the playfiles 3. Browse to assign a wave file to the playfile name 4.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.4. Channel Handle The channel handle tool is used to create internal buses (also referred to as channel handles and intercom channels) within a model in order to route audio signals between various model components. Only intercom and radio components can directly put or pull audio on or from an audio bus. The IcomTx and IcomRx are used to connect the rest of the components (excluding intercom and radio) to an audio bus channel.
ASTi Telestra MBV Quick Start Guide (Ver.2 Rev. C) 4.5. Components The Component section consists of Audio, Control, DRED (Daily Readiness), Engine, Intercom, Platform, and Radio components. These components provide the palette from which a user creates a model. Audio components are used to generate and/or modify sounds. This group includes components such as a wave generator, an amplitude modulator, an audio mixer, and a vox. Control components provide logic for a model.