500 A Huntmar Park Drive ASTi Model Builder Visual Basic Training Manual Document: DOC-01-MBV-BTM-1 Advanced Simulation Technology inc. 500 A Huntmar Drive, Herndon, Virginia, 20170 USA Revision C.1 (March 2008) Product Name: Telestra ASTi ASTi Model Builder Visual Basic Training Manual © 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). ASTi 500 A Huntmar Park Drive Herndon, VA 20170 Table of Contents 1.0. Introduction and Agenda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2. Course Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.0. Hardware Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2.1. Telestra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2.1.1. Ethernet Interfaces ................................................................................................ 2 Figure 1: Telestra - Front View ............................................................................................. 2 Figure 2: Telestra - Back View .............................................................................................. 3 2.2. USB Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Figure 3: Audio Distribution Architecture .............................................................................. 4 2.2.1. Iris .......................................................................................................................... 5 Figure 4: Iris - Front View ...................................................................................................... 5 Figure 5: Iris - Rear View ...................................................................................................... 5 Figure 6: 1U Iris .................................................................................................................... 6 Figure 7: 4 Channel Iris ........................................................................................................ 6 Figure 8: 6 Channel Iris ........................................................................................................ 6 2.2.2. Axis ........................................................................................................................ 7 Figure 9: Axis - Front View .................................................................................................... 7 Figure 10: Axis - Rear View .................................................................................................. 7 2.2.3. Prism ..................................................................................................................... 8 Figure 11: Prism (4-Channel) ............................................................................................... 8 Figure 12: Prism (2-Channel) ............................................................................................... 8 2.2.4. Spectrum ...............................................................................................................9 Figure 13: Spectrum - Front View ......................................................................................... 9 Figure 14: Spectrum - Rear View ......................................................................................... 9 2.2.5. Ancillary Equipment ............................................................................................. 10 Figure 15: Ancillary Equipment ........................................................................................... 10 i 3.0. Software Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.1. Telestra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.2. Model Builder Visual Development Environment . . . . . . . . . . . . . . . . . . . . . . . . . 13 Figure 16: MBV Startup Screen .......................................................................................... 14 Figure 17: MBV Model Folder ............................................................................................. 15 Figure 18: Telestra Toolbar ................................................................................................ 16 3.3. Remote Management System 3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Figure 19: RMS Telestra Status Page ................................................................................ 18 4.0 DIS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 4.1. DIS Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 4.1.1. TX PDU ............................................................................................................... 20 4.1.2. Signal PDU .......................................................................................................... 21 4.1.3. RX PDU ............................................................................................................... 21 4.1.4. Entity State PDU ................................................................................................. 21 5.0. Host Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 ii 6.0. Getting Started with Telestra and RMS . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.1. Cold Starting Telestra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.2. Uploading Options File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.2.1. Instructions to Upload the Options File ............................................................... 24 Figure 20: RMS Options File .............................................................................................. 25 6.3. Configure Basic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Figure 21:Telestra System Status ...................................................................................... 26 6.4. Network Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Figure 22: RMS Telestra Networking Page ........................................................................ 28 6.5. Model Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Figure 23: RMS Telestra Models Management Page ......................................................... 29 6.6. Detecting USB Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 6.6.1. Instructions for discovering USB Hardware in RMS ............................................ 30 Figure 24: RMS Hardware Detection Page ........................................................................ 30 Figure 25: USB Detection ................................................................................................... 31 6.7. Mapping Iris Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Figure 26: Hardware Setup and Mapping ........................................................................... 32 Figure 27: RMS Iris Hardware Assignments Page ............................................................. 33 6.8. Configuring Model Network Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Figure 28: RMS Models Host Interface Configuration Page ............................................... 35 7.0. Operation and Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 7.1. Saving Model Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 7.2. Saving Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Figure 29: RMS Telestra Actions ........................................................................................ 37 Figure 30: RMS System Configuration Backup Page ......................................................... 38 7.3. Restoring Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 7.4. Installing Telestra Software Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Figure 31:Telestra Software Upgrade ................................................................................. 40 7.5. Hardware Readiness Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Figure 32: RMS Hardware Readiness ................................................................................ 42 iii 8.0. Model Builder Visual Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.1. Creating a User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Figure 33: RMS Telestra Preferences Page ....................................................................... 44 Figure 34: RMS New User Account .................................................................................... 44 8.2. MBV Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.3. Component Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 8.4. MBV ICD Tool (with Tutorial) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Step 1: Creating a New ICD .......................................................................................... 47 Figure 35: Creating an ICD ................................................................................................. 47 Step 2: Naming the ICD ................................................................................................ 48 Figure 36: ICD Name .......................................................................................................... 48 8.4.2 Adding Packets .................................................................................................... 49 Figure 37: ICD Packet Information ..................................................................................... 49 Step 3: Adding a Packet to the ICD ............................................................................... 49 8.4.3. Choosing a View Mode ....................................................................................... 50 8.4.4. ICD Packet Members .......................................................................................... 50 Step 4: Adding a Member .............................................................................................. 51 Figure 38: Adding Members ............................................................................................... 51 Step 5: Defining the Member ......................................................................................... 52 Figure 39: Setting the Member Type .................................................................................. 52 8.4.5. Setting Offsets ..................................................................................................... 53 Figure 40: Setting Offset ..................................................................................................... 53 8.4.6. Saving Changes .................................................................................................. 54 8.4.7. Implementing Changes in Your Model ................................................................ 54 8.5. Changing an Existing ICD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 iv 9.0. Creating a Basic Model in MBV. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Figure 41: Model Tutorial Overview .................................................................................... 57 9.1 Tutorial 1 - Sine Wave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Step 1: Creating a New Model ...................................................................................... 60 Figure 42: Creating a New Model ....................................................................................... 60 Step 2: Setting up the Iris .............................................................................................. 61 Figure 43: Setting up the Iris ............................................................................................... 61 Step 3: Creating the Sine Wave .................................................................................... 62 Step 4: Creating the Table ............................................................................................ 64 Step 5: Driving the Amplitude by Creating a Counter and Comparator ......................... 66 Step 6: Creating a New ICD .......................................................................................... 70 Step 7: Linking the ICD to the Model ............................................................................. 72 Step 8: Mapping the Iris ................................................................................................ 74 Figure 44:Mapping the Iris Hardware ................................................................................. 74 Step 9: Organizing Your Model ..................................................................................... 76 Figure 45: Final Model ........................................................................................................ 76 9.2. Tutorial 2- VOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Step 1: Creating a Vox subfolder .................................................................................. 77 Step 2: Creating the Vox object and Iris Cable ............................................................. 77 Step 3: Creating New Vox Members in the ICD and Assigning to the Model ................ 80 9.3. Tutorial 3- Play Sounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Figure 46:Simple and Complex Loop Diagram ................................................................... 85 Figure 47: Playsounds ........................................................................................................ 86 Figure 48: MBV Sound Library ........................................................................................... 87 Step 1: Creating Playsound Object and Using the Sound Library ................................. 88 Step 2: Assigning Sounds to Playsound Object ............................................................ 90 Step 3: Routing the Audio to the Iris .............................................................................. 91 Step 4: Creating the 4 Channel PTT Psound Index ...................................................... 92 v 9.4. Tutorial 4- Mixer and Channel Handles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Step 1: Creating the Mixer and Iris Cable ..................................................................... 98 Step 2: Deleting Audio Out Links from other Subfolders ............................................... 99 Step 3: Setting up the Bus and Mixer .......................................................................... 100 Step 4: Routing Audio ................................................................................................. 105 Step 5: Selecting the Sound ........................................................................................ 106 Step 6: Adding Members to the ICD Packet ................................................................ 107 Step 7: Assigning the ICD to the Model ...................................................................... 109 Figure 49: MBV Components Tutorial Complete Model ................................................... 114 10.0. Creating a Radio Model in MBV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 10.1. Tutorial- Radio Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Step 1: Creating the Iris Asset ..................................................................................... 116 Step 2: Creating the Entity Object ............................................................................... 117 Step 3: Creating a New ICD ........................................................................................ 119 Step 4: Creating the UDP Cable and Links ................................................................. 121 Step 5: Creating the Radio .......................................................................................... 123 Step 6: Adding Members to the ICD Packet for Radio 1 ............................................. 126 Step 7: Creating Radio 2 ............................................................................................. 128 Step 8: Adding Members to the ICD for Radio 2 ......................................................... 129 Step 9: Creating Operator 1 ........................................................................................ 131 Step 10: Adding Members to the ICD for Operator 1 .................................................. 133 Step 11: Creating the UDP in Cable and Assigning Links ........................................... 134 Step 12: Creating Operator 2 and Adding Members to the ICD Packet ...................... 137 Step 13: Adding Links for Operator 2 .......................................................................... 139 Step 14: Connecting the Iris Asset .............................................................................. 140 Step 15: Mapping the Iris Hardware Devices to the Model ......................................... 144 Step 16: Running the Model ........................................................................................ 145 11.0. Converting a 2-operator 2-radio model to an 8-operator 4-radio model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Step 1: Adding Radios 3 and 4 .................................................................................... 147 Step 2: Adding to the Existing ICD .............................................................................. 147 Step 3: Linking the ICD to Radio_3 and Radio_4 ........................................................ 149 Step 4: Adding Operators ............................................................................................ 151 Step 5: Adding ICD members to Drive the Operators ................................................. 154 vi 12.0. The Radio Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 12.1. Amplitude Modulation (AM) versus Frequency Modulation (FM) Tutorial . . . 158 Figure 50: Capture Effect .................................................................................................. 158 12.2. Local Versus Networked Radios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Figure 51: Local versus Networked .................................................................................. 162 Step 1: Creating a Local Radio Model ......................................................................... 162 Step 2: Converting the Local Radio Model to a Networked Radio Model ................... 164 Figure 52: RMS Radios Transmitting and Receiving ........................................................ 164 12.3. Mode Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 Figure 53: Mode Tables ................................................................................................... 165 Figure 54: Bandwidth Examples ....................................................................................... 166 Figure 55: Bandwidth Overlap Threshold Examples ........................................................ 167 Figure 56: Bandwidth Overlap Threshold Levels .............................................................. 167 Figure 57: Bandwidth Overlap .......................................................................................... 168 Figure 58: Ranging Effects ............................................................................................... 173 Figure 59:Occulting Effects ............................................................................................... 174 Figure 60: Ionosphere Effects ........................................................................................... 175 12.4. Crypto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 12.5. Frequency Hopping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Figure 61: Jammer Blocking Radio Frequency ................................................................. 183 Figure 62: Frequency Hopping using Spread Spectrum ................................................... 183 Figure 63: Setting Frequency Hopping HAVE QUICK Parameters .................................. 185 Figure 64: Setting Frequency Hopping SINCGARS Parameters ...................................... 186 Figure 65: Frequency Hopping Link Inspection ................................................................ 187 Figure 66: Frequency Hopping Model .............................................................................. 189 12.7. Comm Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 Figure 67: Comm Panel Example ..................................................................................... 191 13.0. Model Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 13.1. Creating Debug Sets in RMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 13.3. MBV Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 13.4. Viewing RX Buffer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 13.5. Viewing TX Buffer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 vii viii ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 1.0. Introduction and Agenda 1.1. Summary The heart of the ASTi Telestra is the Model Builder Visual (MBV) model development system and the Remote Management System (RMS). These software applications transform the Telestra into a comprehensive development workstation for the creation, extension and tuning of sophisticated audio simulation models. This training course will familiarize you with the layout of RMS and MBV, as well as the related hardware and its uses. 1.2. Course Goals After completion of this course you will understand how to: • Understand the setup of the general system including networking, software management, user accounts, backups, boot settings, and option management. • Easily navigate RMS: • Setup Iris hardware mapping it in RMS and conduct testing • Work with models including model management and host interface setup • View radio information and setup • Troubleshoot models using debug screens • Manage users accounts and models • Understand MBV interfaces: • Build models using the ICD tool (packet editor) including UDP in and out cables for receive and transmit buffers • Create sounds for your model using the Sound Library Editor • Generate Intercoms and Radios via the intercom/radio channel editor • Employ the radio monitor • Develop with the component set • Work with the model canvas Copyright © 2008 Advanced Simulation Technology inc. 1 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.0. Hardware Overview 2.1. Telestra ASTi’s Telestra product line consists of a network scalable, high performance, Linux-based hardware platform, USB-based digital audio and I/O distributions equipment. • 3.4 GHz Pentium Processor • One (1) 1 Gbps Ethernet Interface • Two (2) 10/100 Mbps Ethernet Interfaces • Four (4) USB Ports (For use with ASTi USB devices only) The various components of the Telestra are listed below: • Power supply • Removable hard drive • CD-RW drive • USB ports • Ethernet Interfaces 2.1.1. Ethernet Interfaces The Telestra comes standard with a DIS (Distributed Interactive Simulation) network interface card (NIC), which is used for voice traffic (radio, intercom, etc.) to and from other Telestras or simulators on the network. An optional Host interface can be purchased to control state information such as frequencies, squelch, engine RPM, etc. The host control and voice traffic functionality can be combined onto one interface, if the traffic load is fairly low and permitted under security guidelines. Power Button Reset Button CD-RW Drive Air Filter Removable Hard Drive Figure 1: Telestra - Front View 2 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Power Connection Power Switch Monitor Mouse Keyboard Ethernet Interfaces USB Ports Figure 2: Telestra - Back View Copyright © 2008 Advanced Simulation Technology inc. 3 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2. USB Devices All the equipment needed for the training course is provided in the ASTi training room. This includes: • (2) Telestra units with MBV and RMS installed • (2) Iris - Audio interface module • (2) Axis - Local USB distribution module • Prism - USB extender module • Spectrum - Remote USB distribution module • (2) Telex headset/microphone units • (2) PTT buttons • (2) Fostex powered speakers MBV also requires a three-button mouse. For more information on the USB connections see the ASTi Telestra USB Device Connections Matrix (ASSY 01 UMCX-IN 1) Telestra Prism Cat 5 Cable Max. Length 300’ Spectrum Iris Axis AXIS Out A Out B Out C Advanced Simulation Technology inc. Spectrum Spectrum Iris Iris Iris USB Cable Max. Length 3’ USB Cable Max. Length 15’ Spectrum Iris Out D www.asti-usa.com USB Cable Max. Length 6’ Iris Iris Figure 3: Audio Distribution Architecture 4 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2.1. Iris The Iris module is the audio and input/output (I/O) unit for ASTi’s Telestra platform. The Iris permits installation close to operator positions, and takes advantage of digital audio and I/O distribution to reduce noise and cross-talk susceptibility. This unit may be connected to ASTi’s Axis, Prism (2-Channel version), and Spectrum remote USB module, or daisy-chained from another Iris*. *Not supported in all configurations. Overview of the Iris features: • Installed as close to operator as possible • Upstream connections to Spectrum, Axis, or another Iris • Downstream connection to another Iris • Two (2) independent, software-configurable audio inputs and outputs (1 per channel) • Six (6) Digital Inputs (3 per channel) • Two (2) Digital Outputs (1 per channel) • Two (2) RS-422 serial ports • Two (2) ASTi USB connections • +15 VDC required Figure 4: Iris - Front View Figure 5: Iris - Rear View Copyright © 2008 Advanced Simulation Technology inc. 5 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Other Iris options include the 1U and 4 Channel Extended and Local Iris and the 6 Channel Iris. The 1U Local Iris, 4 Channel Local Iris, and 6 Channel Iris all connect directly to the Telestra for local distribution. The 1U Extended Iris and the 4 Channel Extended Iris both connect to the Prism via a CAT 5 cable of up to a maximum of 300 feet for extended distribution. For more information on these see the ASTi Iris Audio Interface Module Technical & User Guide (ASSY 01 UMAU UG 1). Figure 6: 1U Iris Figure 7: 4 Channel Iris Figure 8: 6 Channel Iris 6 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2.2. Axis The Axis provides connection and distribution for ASTi USB-based peripheral devices local to the Telestra. The Axis may support up to eight (8) Iris devices. When powering on the Axis, the red LED on the rear panel of the Axis module will light when power is applied to the unit. On the front of the Axis the upper green LED will light when the connected USB device has been properly identified by the software on the Telestra. The lower yellow LED will light when there is a USB-related problem. For more information on the Axis see the ASTi Local Distribution Module Technical & User Guide (ASSY 01 UMLD UG 1). Overview of the Axis features: • Distributes digital audio to peripheral devices within 21' of the Telestra platform • Upstream connections to Telestra USB port • Downstream connections to up to eight (8) Iris devices • Four (4) Type A USB connections • One (1) Type mini-B USB connection to Telestra • +15 VDC required AXIS Out A Out B Advanced Simulation Technology inc. Out C Out D www.asti-usa.com Figure 9: Axis - Front View AXIS In Power +15VDC Advanced Simulation Technology inc. www.asti-usa.com Figure 10: Axis - Rear View Copyright © 2008 Advanced Simulation Technology inc. 7 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2.3. Prism The Prism modules allow the Iris devices to be located up to 300 feet away from the Telestra. There are two types of Prisms. The 2-Channel Prism supports two (2) Spectrum units plus two (2) local ports, while the4-Channel Prism supports four (4) Spectrum units. The red LED on the rear panel of the 2 or 4 Channel Prism will light when power is applied. For more information on the Prism see the ASTi Prism & Spectrum Remote Distribution Modules Technical & User Guide (ASSY-01-UMRXRD-UG-1) Overview of the Prism features: • Distributes digital audio to remote devices up to 300' away from Telestra • Upstream connections to Telestra USB port • +15 VDC required • 4-Channel Prism • Downstream connections to up to four (4) Spectrum devices • One (1) USB, mini-B type connector to Telestra • Four (4) RJ-45 connectors to Spectrum units • 2-Channel Prism • One (1) USB, mini-B type connector to Telestra • Two (2) RJ-45 connectors to Spectrum units • Two (2) USB, A type connectors to Iris devices Figure 11: Prism (4-Channel) Figure 12: Prism (2-Channel) 8 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2.4. Spectrum The Spectrum module connects to the Prism allowing Iris devices to be located up to 300 feet away from the Telestra. The Spectrum supports up to two (2) Iris devices with two (2) additional ports for future ASTi USB devices. The green power LED will light when power is received from the Prism unit. A separate power supply for the Spectrum is not necessary. The green connector LED will light when the Spectrum is connected to a Prism and when the Spectrum is detected in the Telestra software. For more information on the Spectrum see the ASTi Prism & Spectrum Remote Distribution Modules Technical & User Guide (ASSY-01-UMRXRD-UG-1). Overview of the Spectrum features: • Receives digital audio from Prism and distributes to local devices • One (1) RJ-45 connector to a Prism unit • Four (4) USB, A type connectors to USB devices (2 Iris units + future modules) Figure 13: Spectrum - Front View Figure 14: Spectrum - Rear View Copyright © 2008 Advanced Simulation Technology inc. 9 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2.2.5. Ancillary Equipment In addition to the Telestra USB hardware, there are several pieces of peripheral equipment that connect to the USB hardware. These include but are not limited to: • Headsets, microphones, and speakers • Cables • Press-to-talk (PTT) switches • Touchscreen Display Refer to the ASTi web site (www.asti-usa.com) for details about options, pricing, and ordering information. Handset Speaker Hand Mic Fostex Speaker Headset 4-Channel PTT Table Mic Touchscreen Display Figure 15: Ancillary Equipment 10 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 3.0. Software Overview 3.1. Telestra The Linux-based operating Telestra runs in real-time framework. The system runs in three (3) levels including: 1. Embedded Mode-In Embedded mode the system will boot, load and run the default MBV model. This is the recommended boot mode. 2. Development Mode- In Development mode the system will boot and load, this mode is used when developing models in MBV. 3. Recovery Mode- This mode is not recommended unless the Telestra crashes and development mode won’t run. In Recovery mode the system boots straight to the prompt for debugging. Please contact ASTi for more information. Telestra supports a variety of additional software services and packages to meet even the highest of communications simulation requirements including: • MBV-Model Builder Visual is the Telestra audio and communications visual runtime environment. • RMS- The Remote Management System is a specialized web server that provides complete sight and control of ASTi devices on the simulation network, ranging from stand-alone to multi-site, exercise-wide network configurations. • HLA Communications-For High Level Architecture (HLA) applications, Telestra come with ASTi’s federate software and various debug tools pre-installed. • High-Fidelity (HF) Radio Environment- The HF server provides real-time, high-fidelity modeling of HF radios using the Model Builder Virtual radio environment. The HF Server computes propagation effects between virtual radios, taking into account such things as transmitter-receiver global position, season, time of day, and solar activity. • Automatic Link Establishment (ALE) for HF radios- The ALE server is used in conjunction with the HF server to realistically simulate the functionality of modern HF ALE radios. The ALE server allows a host computer to initiate the server with lists of radios and scan frequencies, and perform basic simulated ALE functions, such as soundings and calls. • Satellite Communications- This software package provides high-fidelity satellite communications modeling, including adjustable voice delays, uplink and downlink frequency modeling, half- or full-duplex communications channels, satellite positioning, channel allocation, and passband discrimination. • Terrain Interface and Database- This software applies occulting and degradation effects to communication paths in the radio environment. Copyright © 2008 Advanced Simulation Technology inc. 11 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) • Link-16 Tactical Data Link (TDL)- This software package supports the current DIS version of TADIL-J protocol specification, and includes some of the following features: • Multiple JTIDS Class 2 style Terminal Simulation • Integrated Link-16 Transmission and Reception, with DIS/HLA Radio Environment • Interoperates with SISO TADIL-TALES DIS/HLA Standard (TSA levels 0 and 1) • Proper Link-16 Data Rate Simulation Based on Timeslot Allocation • NPG Buffer Management, Priority and Status Reporting • Stacked and Crypto Net Support • Generic Host Computer Interface • Low Cost • Network Time Protocol (NTP)- Allows the user specify and test connection to a network time server for synchronizing Telestra’s internal clock. See the RMS Telestra Networking page for Time Server settings. • Multicast Router- Distinguishes between multicast and unicast packets and determines how to distribute the packets. 12 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 3.2. Model Builder Visual Development Environment ASTi’s powerful and comprehensive Model Builder Visual (MBV) communications and audio development/runtime environment integrates seamlessly with RMS and the Telestra. MBV provides the user with a sound and communications simulation model development environment with many of the same features, capabilities and a similar toolset used in Model Builder software. In addition, MBV includes the visual approach to building and testing sound and communications models. Running models in MBV is also useful when troubleshooting. Note: ASTi does not recommend continuously switching between RMS and MBV while working in Development mode. Overview of features include: • Available only in Development or Recovery modes • Graphical user interface front-end for model development • Component library • Folder-based structure • Model explorer window for easy navigation • Model loader interprets and loads model inside ASTi's real-time framework The assets folder represents the physical hardware. The user can right-click on objects to give them descriptive names, ex. Iris, speakers, subwoofer, cable, mics. Overview of starting a new model: 1. Add an Iris in the Assets Folder 2. Go to RMS pages and map it 3. Under Iris model settings set the gain settings 4. In MBV, open the model folder and add an Iris cable in the workspace. Note an Iris can have more than one cable b/c of different channels. 5. To add audio input, middle-click the Iris and add audio inA and audio outA, double-click the Iris object. Then in the schematic click input A and view the scope. Copyright © 2008 Advanced Simulation Technology inc. 13 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 16: MBV Startup Screen 14 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 17: MBV Model Folder Copyright © 2008 Advanced Simulation Technology inc. 15 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 18: Telestra Toolbar 16 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 3.3. Remote Management System 3.x The Telestra Remote Management System (RMS) is a specialized web server that provides complete sight and control of all ASTi devices on the simulation network, ranging from stand-alone to multi-site, exercise-wide network configurations. Users can configure the HLA Communications Environment, multicast routing capability, and other services using a standard web browser from anywhere on the network. Further, RMS offers a familiar point-and-click “web page” interface for controlling ASTi resources, status checking, and file and network management. Section 6.0. ‘Getting Started with Telestra and RMS’ provides an overview of instructions to navigate RMS. For additional information on RMS 3.x see the ASTi Telestra v3.0 User Guide (DOC01-TELS-UG-3). Overview of RMS capabilities include: • Telestra software updates • Hardware • Model installation and management • Network parameters configuration • Model browsing and control • System reboot and shutdown • DIS network configuration and monitoring • Debugging Copyright © 2008 Advanced Simulation Technology inc. 17 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 19: RMS Telestra Status Page 18 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4.0 DIS 4.1. DIS Interface The DIS interface carries the radio, network intercom, voice and data traffic, which is generated and received by Model Builder Visual. Within MBV each asset can be set to DIS or local only operation. This allows the user to have the ability to define DIS radios up to the processing limits of the platform. Global DIS settings can be configured through RMS. DIS Radio Basics Network configuration: • To communicate over DIS, this feature must be enabled by ASTi in your options file. • You need two DIS enabled network products (Telestra, DACS, PC’ver). • Local IP address and Mask • Broadcast or multicast IP address • UDP port • Checksum parameters and DIS PDU timeout values • DIS Site and Host Values • Other/Advanced Model configuration: • Ensure the DIS IDs are unique and radios are in the same exercise. • Match modulation type, frequency, Bandwidth, modulation, crypto state, Frequency Hopping/HQ settings, etc. for the radios. • MBV decodes incoming audio based on signal PDU. • Support of multiple simultaneous exercises (up to 255). DIS PDU Types While this is a course on the Telestra and MBV software, it is important to understand the DIS interface traffic and its characteristics. When the DIS interface is used to carry model communications information the packet format is “IP|UDP|DIS_PDU” over standard Ethernet. The UDP port setting is configured through RMS. The DIS PDUs contain all of the pertinent information such as: • Voice communication • Tactical Data communication • Radio Parameters (frequency, location, Tx power, DIS IDs, exercise #, etc.) Copyright © 2008 Advanced Simulation Technology inc. 19 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) DIS IDs are broken down into site, host, entity and radio IDs. The 4 set string: site:host:entity:radio (for example: 10:20:30:40) must be unique for each radio on the network. While there is not a steadfast rule for setting up the IDs, one common scenario is to associate the site and host IDs with a physical location, the entity ID with a Telestra and then have individual radio IDs for each radio instance. There are four types of PDUs detailed in the following sections. 4.1.1. TX PDU Transmitter PDUs are required for telestras to operate in a networked mode. They are both transmitted and received by Telestra systems. The TX PDU is an informational PDU that is sent out periodically based on Tx Setting and contains information about: • Site:Host:Entity:Radio IDs • Radio frequency • Location • TX Power • Exercise number • Modulation • Bandwidth • Crypto parameters • Frequency Hopping/HQ parameters • State (On, Off, On_Tx or ACTIVE) Within RMS, you can see all active TX PDU IDs that have been received by a telestra. In RMS, you will see all local and remote DIS IDs on the net work. In short, Tx PDUs are a radio's (or other object in MBV, i.e. transmitter, network intercom) way of saying, “who, what and where I am.” Rx objects in MBV scan Tx PDUs to determine who is in range. Transmitter PDUs are put out periodically if the radio is stationary (five second default) or when the radio has changed state; that is moved, started/ended transmission, or changed parameters. 20 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4.1.2. Signal PDU Signal PDUs are required for telestras to operate in a networked mode. They are both transmitted and received by Telestra systems. The signal PDU is a UDP packet, which contains encoded voice information or data messages. When actively transmitting or receiving from a radio, for example, you will Rx/Tx a continuous packet flow during this time. The audio is encoded with the settings (uLaw, PCM, CVSD) in a given radio/intercom object. The default audio encoding type can be set through RMS. Also within MBV you can override the default on and per radio buses. 4.1.3. RX PDU The RX PDU is not necessary for MBV to run, however it is built into MBV as a standard feature. RX PDUs transmit receiver state information, such as the received power level. It is for informational purposes only, and does not cause the Telestra to make any adjustments based on the values received. The Rx PDU says, “who I am in tune with” for each receiver, and whether or not they are actively receiving audio. 4.1.4. Entity State PDU Entity state PDUs are not necessary for MBV to run and are not generated by the telestra. The Telestra receives entity PDUs to obtain position information for radios when an “Radio_Entity” object is used. For example, the radios in MBV can be moved by a Mod Semi Automated Force (SAF) entity generator. Copyright © 2008 Advanced Simulation Technology inc. 21 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 5.0. Host Interface The host interface is used to receive simulation state data for control of the local audio model(s). This host simulation computer will normally provide simulation state and sound model control parameters such as engine RPM, radio frequency, radio position, communications panel switch settings, etc. This data is transmitted over an Ethernet network to the Telestra and received via the host interface network card. Communications with the Telestra are asynchronous. The host computer transmits packets at the host defined iteration rate. The Telestra ethernet hardware receives and buffers the packet in local memory. The value is then read into the model at a rate of 100 Hz. Some model state data and system health parameters can also be transmitted back to the host. Packet transmission for data being returned to the Host can take place in each model iteration, or be reduced in frequency via host setting parameters in RMS. Data received is buffered and brought in to the model using various control objects available in the MBV development environment. The user can inspect packet data through MBV and RMS. For transferring simulation state parameters, the Telestra supports IEEE 802.3 standard UDP level protocol with IP addresses. The use of UDP facilitates the reception of state data from multiple simulation sources by selection of independent port numbers. The user will need to configure the Telestra with the appropriate network settings to ensure proper network operation. The Telestra can receive host data on 1 or more UDP ports for MBV. Additionally, the Telestra can send host data on 1 or more UDP ports. 22 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.0. Getting Started with Telestra and RMS 6.1. Cold Starting Telestra The Telestra Cold Start Procedure allows the users to build Telestra systems from scratch. There are three main reasons for using the Telestra Cold Start Procedure. 1. Installing the latest software version 2. Rebuilding a damaged hard disk 3. Creating spare hard disks The following provides an overview of the Telestra Cold Start Procedure for detailed information on the procedure please see the ASTi Telestra Cold Start Procedure (DOC-01-TELS-CS-3). 1. Verify BIOS settings match configuration settings listed in the Telestra Cold Start Guide 2. Turn on the Telestra system via the power switch on the front of the chassis. 3. The system may or may not fully boot, and you may receive an error message. 4. Insert the Telestra Software CD into the CD-ROM drive. 5. Reboot the system using the “Reset” button on the front of the chassis. 6. The system will begin to boot from the CD. You will be given the option of installing the software with or without a graphical interface. At the “boot:” prompt, press the ENTER key to install in graphical mode. The screen may go blank for about a minute as the X server (graphical interface) starts. This is normal, and the process should not be interrupted. 7. The Telestra Software Installer will load, and the software installation will proceed without any further user action. 8. When the installation is complete, the CD tray will slide open. Remove the CD from the tray. 9. Click the “Exit” button in the graphical interface if you have a mouse connected to the Telestra system. Otherwise, press the ENTER key to select “Exit”. 10. The Telestra system will reboot and start from the hard disk. Copyright © 2008 Advanced Simulation Technology inc. 23 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.2. Uploading Options File The Telestra Options file is a program-specific encrypted file containing software packages for all of the Telestra systems delivered under that program. A single Telestra Options file may be installed on multiple Telestra platforms but will only activate the appropriate software packages on each platform. The software functionality, as defined by the Telestra Options File, is linked directly to the Telestra system’s hardware configuration. The Telestra Options screen in RMS allows the user to manage the Telestra Options file. Overview of the Options File Background • The Options file contains the software license key, which is required for MBV operation. • The Options file enables certain software modules available on the Telestra platform (e.g. HF server, Terrain server) and specifies the number of credits allocated to the Telestra • The number of credits determines the scope of the models that can be created and run in MBV. • The Options file is keyed to the MAC address of Telestra 6.2.1. Instructions to Upload the Options File 1. Insert the Telestra Options CD into the machine running the RMS browser. 2. The following steps apply only if the Options CD has been inserted into Telestra: 2a. Go to console • In Embedded or Recover y Mode, press ALT-F2 • In Development Mode, press CTRL-ALT-F2 2b. Login to console as root 2c. Type “mount /cdrom” at prompt 2d. In Development Mode, press ALT-F7 to return to X Windows environment 2e. ** After uploading options file per the steps below, return to console and type “eject” at prompt 3. In the RMS browser, go to the Telestra >> Options screen 4. Select the “Choose File” button to locate the file on your local workstation. 5. Select “Upload New Options File” button Important: Selecting an Options File with the same name as the currently-installed Options File will result in the new file over-writing the existing file. Click on the filename of the existing Options File to download it to your local workstation for archiving and backup purposes. 24 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 20: RMS Options File Copyright © 2008 Advanced Simulation Technology inc. 25 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.3. Configure Basic Settings RMS allows user to enter basic information that identifies and describes a Telestra platform. The Telestra >> Preferences screen shows the system’s basic settings, such as installation and contact information. It also provides the ability to add and delete Telestra user accounts, which are important in MBV model management. Settings include: • Description (e.g. Comms Telestra) • Installation Facility (e.g. NLX Corporation) • Installation Location (e.g. Sterling, VA) • Installation Trainer (e.g. E-2C WST) • Contact Name • Contact Phone • Contact Email Figure 21:Telestra System Status 26 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.4. Network Settings RMS allows the user to configure the following network settings on the Telestra platform. • General Networking. This section encompass network-wide, interface-independent settings such as Autodiscovery, DNS nameserver and router gateway IP addresses. • Time Server. This section allows you to specify and test connection to a network time server (NTP server) for synchronizing Telestra’s internal clock. Other settings allow you to tweak Telestra’s NTP client variables. • Ping Utility. Enter another computer’s hostname or IP address to send five pings (echo requests) to it. Positive response indicates that computer is reachable over the network, using any of Telestra’s three network interfaces. • Network Interfaces. These sections allow you to specify IP address, card mode and subnet mask for each of Telestra’s three Ethernet interface cards. Operational Warning: Making changes to the interface settings (especially eth0), such as changing manual IP address, or setting card mode to DHCP may result in your not being able to access RMS at the original (previous) IP address. If you change these settings, you must then specify the new IP address in your browser’s Address slot to access RMS at its new network location. Copyright © 2008 Advanced Simulation Technology inc. 27 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Instructions to Configure Network Settings 1. In RMS browser, go to the Telestra >> Networking screen 2. Click on the “Edit Configuration” link under the section of interest 3. Enter data into appropriate fields 4. Select “Make Changes” button to commit the changes Figure 22: RMS Telestra Networking Page 28 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.5. Model Management Model management allows you to stop, reload, copy, delete or backup the model. In Development mode, each user’s “default” model will be loaded in MBV when it is launched. In embedded mode, the “Embedded Operation” default model is automatically loaded and started when the Telestra system is booted. Users can copy models from other users to work with them, but they cannot copy over other user’s models. For more information on Model Management in RMS, see the Telestra 3.0 Users Guide (DOC-01TELS-UG-3), Chapter 6. Figure 23: RMS Telestra Models Management Page Copyright © 2008 Advanced Simulation Technology inc. 29 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.6. Detecting USB Devices The USB devices must be connected and running properly with the Telestra. There are two ways to ensure the USB devices are working. The first way of detection is by looking at the LED lights on the USB hardware. For more information on the location of the LED see the specific user guide for the device. The second way is through RMS Hardware>>Layout page. The Hardware Layout displays the arrangement of all detected USB devices. Each device has its own icon and the black arrow indicates the Telestra USB traffic. The blue arrow indicates remote distribution of USB traffic and the orange arrow indicates local distribution of USB traffic. The dotted arrow indicates a physical cable connection between USB devices. 6.6.1. Instructions for discovering USB Hardware in RMS 1. In RMS browser, go to Hardware >> Layout 2. Select “Reset USB devices” button 3. Wait for all devices to be detected 4. Hardware layout will be displayed when detection is complete Figure 24: RMS Hardware Detection Page 30 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) If the USB devices are not recognized disconnect all USB cables and connect in the following order. 1. Connect Axis* and Prisms* and discover via RMS 2. Connect 1 Iris* to Axis* 3. Connect Spectrum* to Prism* and discover via RMS 4. Connect remaining Iris* devices and discover via RMS *- power cycle the device (ie prism, axis) prior to connecting Telestra Axis Step 1 Connect Axis and Prism Step 2 Connect 1 Iris to Axis Prism AXIS Out A Out B Advanced Simulation Technology inc. Out C Out D www.asti-usa.com Iris Spectrum Step 3 Connect Spectrum to Prism via Cat 5 Cable Step 4 Connect remaining Irises Iris Iris Iris Figure 25: USB Detection Copyright © 2008 Advanced Simulation Technology inc. 31 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.7. Mapping Iris Devices There are two parts to mapping the hardware. First the user must setup the software side in MBV by adding Iris assets in the model. Then the user must map the Iris assets to the physical Iris devices in RMS. Hardware Setup and Mapping Step 1 (MBV) Assign Iris cables to Iris Assets Model Folder Assets Folder Digital audio input and output “Pilot” Iris Cable Iris Asset Iris Cable Step 2 (RMS) Map Iris Assets to Hardware devices (serial number) “Pilot” 3-xxx “Copilot” 3-yyy “Instr” 3-zzz Figure 26: Hardware Setup and Mapping 32 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Iris assets in the model route audio and digital I/O to physical devices. The physical “On-Wire” Iris devices must be mapped to Iris assets in the model. Iris mapping is saved with the model in the hardware mapping file. The following instructions provide an overview on how to map Iris devices. Instructions 1. In the RMS browser, go to Hardware >>Mapping. You will see a list of Irises and quite a few “Map it” buttons. 2. 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 (shown below). 3. For each Iris component, select an Iris serial number from the pulldown list. 4. Once all components have been mapped, select the “Map Hardware” button. 5. Wait for the model to reload until the “Model is now Loaded” message is displayed. For more information on mapping Iris devices see the, ASTi Telestra 3.0 User Guide (DOC-01TELS-UG-3), Chapter 6. Figure 27: RMS Iris Hardware Assignments Page Copyright © 2008 Advanced Simulation Technology inc. 33 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6.8. Configuring Model Network Settings UDP cables in the model receive and transmit host data. The host network settings for UDP cables in the model must be configured in RMS. The RMS Models Host Interface page also lets you select the interface on which all multicast UDP host traffic is output. The host must configure the following settings: • IP address / Ethernet interface • UDP port number • Endianness • Periodicity (timeout period) The settings are saved with the model in the hardware mapping file. The user must reload the model to apply the changes Configuring Network Settings in RMS 1. In the RMS browser, go to Models > Host Interface 2. Configure the settings for all UDP cables 3. Select “Change IP Addresses / Ports” button when complete 4. Wait for the model to load until “Model installing complete” message is displayed 34 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 28: RMS Models Host Interface Configuration Page Copyright © 2008 Advanced Simulation Technology inc. 35 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7.0. Operation and Maintenance 7.1. Saving Model Archives Models are saved through the RMS Model Management screen or through RMS Telestra Actions in RMS. Models are saved as tgz archive files. The archive includes all files and subdirectories under the model directory. Model archives can be uploaded to another user. by selecting “Copy.” Instructions to Backup in Model Management 1. In RMS browser, go to Models >> Management screen 2. Select “backup” link next to model to be saved 3. Select the files to backup from the list which include: • Model • Model Folder • Services Folder • Assets Folder • Hardware Mapping • Components • Debug • Profiles • ICD • Soundfiles 4. Select “Start Backup” and RMS will generate the model archive 5. Select the download location in the file browser window 6. Select “OK” to save model archive Note: RMS facilitates archiving and restoring only the models in the user accounts. If users choose to store any other information in their directories they are responsible for backing it up. 36 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7.2. Saving Settings RMS provides a backup utility that allows users to save current configuration in archive files for the radio environment including the DIS network settings and DIS protocol settings. The user can also backup the Telestra configuration including preferences settings, network settings, and the options file. Instructions to Backup in Telestra Actions 1. In RMS browser, go to Telestra > Actions. 2. Select the “Backup System Configuration” link. 3. Select the checkbox(es) next to configuration files to be saved or select “All” checkbox. 4. Select the “Start Backup” button. 5. RMS generates a configuration archive tgz file. 6. Select download location in file browser window. 7. Select “OK” to save file to browser machine. Figure 29: RMS Telestra Actions Copyright © 2008 Advanced Simulation Technology inc. 37 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 30: RMS System Configuration Backup Page 38 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7.3. Restoring Settings There are two ways to restore model settings in RMS. The first is through the Model Management screens. There are two ways for the user to start a model installation or restoration in Model Management. The user can choose to upload a model from their workstation OR choose to restore a model archive already stored on the Telestra. For detailed instructions please see the Telestra 3.0 Users Guide (DOC-01-TELS-UG-3), Chapter 6, Uploading & Installing Model Files. The second way to restore model settings in RMS is through the Telestra Actions screen. Instructions 1. In RMS browser, go to Telestra > Actions. 2. Select the “Restore System Configuration” link. 3. Select the “Choose File” button. 4. Select “Restore Now” next to the model file you want to restore. 5. Check the files to restore or select the “Check All” button. 6. Select “Start Restoration”. 7. Restart your Telestra to apply the restoration. Copyright © 2008 Advanced Simulation Technology inc. 39 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7.4. Installing Telestra Software Upgrade In RMS, the Packages Update System will display the Software Update screen, shown below. Telestra software updates may be installed without performing a system cold start Instructions 1. In RMS browser, go to Packages >Update System. 2. Insert the Telestra Software CD into Telestra. Figure 31:Telestra Software Upgrade 3. Check the “Verify CD Checksum” box to allow you to verify the integrity of the installation media. The verification will fail if any file on the CD is unreadable due to scratches, marks, etc. 4. Select the “Read CD” button. 5. Telestra mounts the CD and lists software packages to be installed (Please be patient this may take a few minutes). 6. After the Telestra determines which packages to update, another page will display any appropriate release notes, and lists the packages to be upgraded on your system. 40 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7. Review the packages then select the “Install updates” button. The Telestra will then proceed to install the necessary package updates. 8. When done, RMS will display a confirmation screen, “Update completed successfully” wait for the message to display. 9. Remove CD from the CD-ROM drive. IMPORTANT! At this point, you must remove the CD from the CD-ROM drive of the Telestra system before doing anything else! Failure to remove the update CD from the drive will result in a full-up system installation (including complete erasure of the hard disk) the next time the Telestra system is started. 10. Reboot Telestra from the Telestra > Actions page. Copyright © 2008 Advanced Simulation Technology inc. 41 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7.5. Hardware Readiness Tests RMS’ hardware readiness test allows you to verify hardware setup, cable connections and Iris operation. Navigate to Hardware Readiness to display a confirmation screen, shown below. Figure 32: RMS Hardware Readiness The test will create a custom readiness model based upon all the “on wire” USB devices that have been properly initialized. This readiness model provides testing of audio in and out channels, as well as digital in by way of PTT. To perform the test, you will need at least a headset for connecting to the Iris device(s) to be tested. The recommended test rig, consists of: • Iris-to-PTT cable (DB-15 male to female, 6-pin XLR) • Inline ASTi PTT box • Stereo headset with microphone and male, 4-pin XLR connector Running the Hardware Readiness Test 1. Connect the stereo headset and in-line ASTi PTT to Iris Channel 2. In RMS browser, go to Hardware > Readiness 3. Select the “Run Readiness Test” button 4. Verify that a tone is heard in the headset without distortion • On Channel A, a beeping tone is heard • On Channel B, a steady tone is heard • On either channel, a tone frequency changes when PTT is keyed • On either channel, a tone frequency changes with channel select knob position 5. Verify microphone input is heard in headset without distortion Important: When you are done with the readiness test, you must reload the desired MBV model to replace the custom readiness test model. 42 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.0. Model Builder Visual Introduction The user must operate in Development mode to create models in MBV. The user must setup a user account and password in RMS to operate in Development mode. 8.1. Creating a User Account 1. Boot the Telestra in Development mode. If a username and password is requested, use rmsuser and astirules for the password. Do not stay in Development mode with this username, you must create a new username. 2. Select the RMS icon to launch the web browser and navigate to Telestra >> Preferences page. 3. Left click on “Add New User Account.” 4. Type in the new username and password and select “Create User.” 5. Navigate back to Telestra >> Preferences. 6. Under the Boot menu, select Development. 7. Navigate to Telestra >> Actions page and select “Reboot Telestra System.” 8. Once the Telestra reboots, type in the new username and password. You are now ready to begin developing models in MBV. Note: MBV takes a few minutes to start the real-time framework, load the components library and load the model. To develop a working model the user must know how to: • Add objects • Connect links to the objects • Route using the Channel Handle • Control the inputs using the ICD tool • Drive the hosts Copyright © 2008 Advanced Simulation Technology inc. 43 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 33: RMS Telestra Preferences Page Figure 34: RMS New User Account 44 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.2. MBV Navigation While navigating in MBV is fairly self-explanatory, the following provides a quick overview. • To enter a folder in MBV either • Double-click on folder icon in workspace area or • Click once on folder in explorer window • To view components in MBV either • Double-click on component icon in workspace area or • Right-click on component icon in workspace area then select “Open” • To run a model either • Select “Resume Scenario” from Scenario menu or • Press F3 key • To stop a model either • Select “Pause Scenario” from Scenario menu or • Press F3 key A few nuisances of MBV need to be mentioned before beginning model development. • When creating a new object/asset or a new link between objects/assets, the model needs to be reloaded before the object/asset can be edited or used. This is not to say that multiple objects can't be placed and linked together before reloading, but it is good practice to reload after a group of objects/links have been created. Note: The links in MBV represent audio when red and controls when blue. • Saving the model. Whenever something is changed in the model, MBV automatically saves. This is why there is not “Save” function. The “Save As” function creates a copy and any further edits are saved on that copy. Use this option if you want to retain a certain state When creating a new object/asset or a new link between objects/assets, the model needs to be reloaded before the object/asset can be edited or used. This is not to say that multiple objects can’t be placed and linked together before reloading, but it is good practice to reload after a group of objects/links have been created. Note: The links in MBV represent audio when red, and they represent controls when blue. Note: When naming models the model name cannot have spaces, the user should insert underscores (_) for spaces, for example, MBV_Model_Tutorial. Copyright © 2008 Advanced Simulation Technology inc. 45 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.3. Component Overview The Components consist 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 generate sounds. This group includes components such as a wave generator, an amplitude modulator, an audio mixer, and a vox. This component plays sound object filter. Control components provide logic for a model. This group includes components such as a logic table, a math function, a lookup table, byte control, etc. DRED components include objects that are used to create the daily readiness test model. The readiness model is dynamically generated when triggered by a user via Telestra RMS. This group includes components such as Amp mode, bit to Byte, Gain, input, math functions, mixers, and wave. Engine components include both rotor and engine sounds. The audio from the engine and rotor components changes dynamically based on inputs such as RPM, whine frequency, and gain. Intercom components relate to internal communication paths within the model. This group includes the communication panel and local intercom buses. Audio on intercom buses is never transmitted onto the voice network. These buses are used internally to pass audio around. If put in a radio, for example then audio can be sent out on the DIS network. Platform components simulate power distribution to both individual assets such as radios, intercoms, and communication panels and to groups of assets. Radio components include communication assets whose audio is transmitted to or received from the voice network. The radio components include generic radios, transmitters, receivers, network intercoms, etc. • Schematic • Displays graphical layout of component code • Primitives (building blocks of component) • Mousing over primitive displays current values of primitive variables • Connections between primitives • Data Viewer • Displays primitive details in a list format (tree view) opposed to the graphical layout of the schematic. The user can view or set values of primitive variables. • Link Inspector 46 • View incoming and outgoing link data • Right-click on source or destination component to access menu • Go to data view tab of source / destination component • Go to link inspector tab of source / destination component Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.4. MBV ICD Tool (with Tutorial) 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 the XML packet layout. When creating an ICD, the user creates the packets that makeup the ICD and the members that makeup the packets. For every model with network host inputs the user must create a new ICD. Before getting started boot MBV on your Telestra and login. The remainder of this section describes how to create a new ICD and provides a step-by-step tutorial. Step 1: Creating a New ICD 1. Navigate to file in the top menu bar and select ‘Start a New Model.’ Name the new model ICD_Tutorial Note: This will be an “empty” model focusing on the demonstration of the ICD tool. 2. Navigate to the top menu bar and under Tools select ‘ICD Tool.’ Then open the ICD tool and click ‘Create’ to create a new ICD. Figure 35: Creating an ICD Copyright © 2008 Advanced Simulation Technology inc. 47 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Naming the ICD You will need to name your ICD. This name is just an arbitrary name that will identify the ICD from the others. The standard naming convention is to use a name which corresponds with the function of the ICD. Figure 36: ICD Name 48 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.4.2 Adding Packets The packets makeup the ICD. The user enters the values for each packet which will makeup the packets structure. Existing packets can also be edited by selecting a packet under the ‘Current Packet’ pull down menu. The following inputs define the packet. • Endian- Selects the default Endianess (Big or Little) of the packet data. This can also be set and overridden in the RMS>>Host pages. ASTi recommends using RMS to set this value. • Direction- Defines whether the packet data is to be received as input or is to be transmitted as output. • Timeout (ticks)- This value represents the number of 100 Hz system frames that can occur before loading the initialization/default values set in the UDP inputs assets in your model. Loading these values will only occur if packet information is not received on this port within the time represented by the number of frames. If a packet is received in this time frame, the count is rest. A value of zero (0) means the interface never times out and initialization/default parameters are not loaded. • Port- The port number selects the default UDP receive port for the packet data if this is an input packet, or the transmit UDP port if this is an output packet. This can also be set and overridden in the RMS>>Host pages. ASTi recommends using RMS to set this value. • IP Address- If the packet is an output packet this field will allow setting the destination IP address (i.e. the host computer you wish to send the data to). This can also be set and overridden in the RMS>>Host pages. ASTi recommends using RMS to set this value. Figure 37: ICD Packet Information Step 3: Adding a Packet to the ICD 1. Select the packet icon from the top tool bar and name it Packet1 2. Select Packet1 from the ‘Current Packet’ pulldown list. You have added a packet, now you must add members continue to the next tutorial. Copyright © 2008 Advanced Simulation Technology inc. 49 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.4.3. Choosing a View Mode There are two ways to view the ICD interface, most of the changes will be performed in ‘Offset’ view. • Offset view shows the “variable” name. This is the name of the packet entry at its lowest level. One level up from this is a wire name. • Wire view allows abstraction of the variable name. It is the name you see on the MBV desktop when you middle-click on a component to create a link. It is also the name you see in the Host UDP assets and cables in your model. Wires can also be bundled by adding a name to identify the bundle. 8.4.4. ICD Packet Members The user adds members to define each packet. The following inputs must be defined for each member. • Name- Enter the variable name. If you change the variable name of an existing member than the wire name under the wire view needs to be changed as well. • Type- Sets the variable type and data type for the member. ASTi recommends sticking to common/basic <type> variables. Note: This variable type must match the variable type of the component variables it connects to in the model. • Offset- Sets the offset location in the ethernet packet for the data associated with this member. • Bit Offset- This is only needed for bit packed booleans. • Size- Identifies the size of the data in bytes. • Units, Range, and Comments- These are used to provide additional information and are not used for anything functional. • Default- This input is not used. 50 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Adding a Member You can add a member by clicking the icon button at the top of the ICD page or right-click in the workspace (shown below). You’ll be asked to provide a member name (in this case the same name will be used for the wire names.) Add a member and name it, SineWave_Frequency Note: The user can also edit, move, or delete existing members by right-clicking or choosing the proper icon in the tool bar. Figure 38: Adding Members Copyright © 2008 Advanced Simulation Technology inc. 51 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 5: Defining the Member After adding a member, you must define the member name, type, offset, bit offset, and size. Hint: To find the type variable for your member open up the object and view the schematic (see arrow 1 below). Then double-click on the input option needed (2). Look under the Type values to find the value needed (3). Return to the ICD packet member inputs and enter the Type (4). After you have finished editing the packet select ‘Ok’ and your member is created. Figure 39: Setting the Member Type 52 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.4.5. Setting Offsets To set offsets the view mode must be in Offset mode. There are several ways to edit offsets individually or grouped together. • Edit offsets by editing each member through the edit member window. • Highlight a particular member and use the +/- keys to increment and decrement the current offset number. • Highlight a block of members (drag your mouse across them or click on the first entry and then shift/click on the last entry) and use the +/- keys to increment and decrement all offset values in the highlighted block. Hint: You can also select different members across the packet and use the control button to perform the same operation (i.e. the members do not need to be in a continuous block.) • There is also an auto offset function which will automatically set the offsets of all the highlighted members. Highlight a block of members and right-click to select “auto Index/offset.” This will set the offsets starting at the input offset number (shown below). Note: You can click on any of the column names to sort the list (alphabetical, etc.) The tool does not currently check for overlaps so be diligent! Figure 40: Setting Offset Copyright © 2008 Advanced Simulation Technology inc. 53 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.4.6. Saving Changes After completing changes to the ICD the user should either Save or Save As. Use Save As to change the name of the XML file to help track revisions. This saves the changes to the XML file but have yet to be implemented in the model. 8.4.7. Implementing Changes in Your Model After saving the ICD XML file, the changes need to be added to the model. To add the changes to the model, click on the ‘Create Assets’ (magic wand) icon button or select this action from the top menu under model. MBV will then recreate the Host Assets in the model using the currently selected (and updated) ICD file. These changes will be made to the currently loaded MBV model. A prompt will appear when this process is complete. Larger models may take a few minutes, so be patient. After implementing the changes, reload the model in MBV and look for warning/error entries in the reporting screen at the bottom of the MBV development environment window. Hints: You can also select the ‘Clear MBV Log’ entry under the Debug menu before reloading because it is easier to find errors. Watch for warnings regarding type or size mismatches and link errors which could occur if you change the wire name of a variable. To correct type/size problems you'll need to return to the ICD tool. To correct link errors you'll need to create a new link and delete the old one. Reload after these changes and check the reporting window to see if you have cleared everything. 54 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8.5. Changing an Existing ICD The user must change the existing ICD to make changes to the host interface. The following describes how to edit a member in a step-by-step example. 1. Load the model you wish to change and select the ICD tool. 2. When the ICD tool opens you will have two options: A) Create a new ICD or B) Open an existing ICD You will choose to open an existing ICD. When you select to open an existing ICD you will be given a list of XML files from previous ICD files generated and saved by the tool for the currently loaded model. Note: If you don’t purge these files you can rack up a long list. The ICD files are found in the ICD folder one level down from your top level model folder. 3. Pick the file you wish to change (this will most likely be the latest file). 4. Change the view mode to Offset. 5. Double-click on the entry/member you wish to modify, or click to highlight the entry. 6. Right-click and select Edit Member/Wire, or click on the gear icon at the top of the page. The Edit Packet Member window will pop up. After making changes to the ICD tool, save the changes and then click the “Magic Wand” tool to create the asset. Copyright © 2008 Advanced Simulation Technology inc. 55 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 56 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9.0. Creating a Basic Model in MBV The following subsections in this chapter will walk the user through creating a basic MBV model, demonstrating how to use the most common objects in MBV. The model will be built in 4 blocks, or tutorials, which will build upon each other by adding new components and illustrating new concepts and tools. The following diagram outlines the final model. Counter Trigger Dur. 10 ms End 1 Start 0 X TableXY X ICD Comparator Type Y Z Sine Wave X Y 1 100 2 200 3 300 4 400 5 500 Y Iris Cable Vox Threshold Vox Enable PTT Audio In Trigger 4Ch.PTT 4Ch.PTT Decoder Amp Bit 0 Bit 1 Bit 2 BitToByte IcomTx Mixer Control Input 1 IcomRx Vox Threshold Vox Enable PTT Audio Input 3 IcomTx IcomRx Rx Vol 1 Rx Vol 2 Psound Trigger Index Sound 1 Sound 2 Sound 3 Iris Input 2 Freq Vox Audio Out Rx Vol 3 IcomTx IcomRx Math 2 0-100 Rx Volume Master Volume Y= (scale)=.01 X Figure 41: Model Tutorial Overview In order to successfully complete all the tutorials, you will need the following hardware: • One Iris properly connected to the Telestra • Headset • Microphone • 4 Channel PTT Switch • Speaker (optional) The first tutorial will focus on the wave object and three different control objects used to control and modify the input fields of the wave object. Specifically, the Wave object will generate a sine wave. A TableXY control object will determine the sine wave’s frequency. The Amplitude will be driven in a square wave fashion using a counter and a comparator to generate the square wave amplitude input. The ICD tool will be utilized to drive inputs into the control objects, demonstrating a host controlling the sine wave. Copyright © 2008 Advanced Simulation Technology inc. 57 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) The second tutorial will focus on the Vox object. Audio from a mic will route through the Iris into the Vox, and then back out through the Iris and into the headset as sidetone. The ICD inputs will drive the Vox parameters. The third tutorial will focus on play sounds using the PSound255 object. This tutorial will demonstrate how the Sound Editor library tool is used and how the Psound255 object is used to manage sound files within a model. A Four Channel PTT switch will be used to select which play sound files will play when triggered via host control. The fourth tutorial will focus on the mixer object and how to use channel handles to internally route the audio generated from the previous three tutorials to the mixer object. A Math2Function object will control Audio volume and a BitToByte object will control the mixing of the audio signals. Before beginning each tutorial refer to the Telestra MBV Quick Components Reference Guide (DOC-01-MBV-QCRG-1)for explanations of each component. 58 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9.1 Tutorial 1 - Sine Wave This tutorial will consist of four (4) components. The Iris object and cable will be used with this portion of the tutorial. A Wave object will generate a sinusoidal wave whose signal will be routed via the Iris cable to an Iris asset. The Frequency of the sine wave will be controlled by the TableXY component. Host control (ICD tool and packet) will drive input integers with values of 1 through 5 into the TableXY object and a corresponding frequency value will output from the TableXY object and drive the frequency field of the sine wave. Two components will work in tandem to modulate the amplitude of the sine wave. A Counter object will continuously count and input its signal into the Comparator object. This will cause the Comparator object to alternately output a 0 or 1 which in essence becomes a square wave signal. This square wave signal drives the input of the amplitude field of the sine wave. The final output of the sine wave will be a beeping sound. By the end of this section the user should be familiar with: • Creating a new model • Setting up Iris assets • Mapping Model Iris's to ‘on the wire’ Iris's • Using Model Subfolders • Generating a Sine Wave • Routing audio from a model to a headset • Using a Counter, Comparator, and Table object • Driving component fields with host controls (ICD Tool) Copyright © 2008 Advanced Simulation Technology inc. 59 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 1: Creating a New Model Open MBV in development mode and left click on “File”, select “New”, name the model MBV_Component_Tutorial Remember: The model name cannot contain spaces. Underscores must be used in lieu of space characters. Your screen should look like the figure below. This creates a blank canvas for building your model. Figure 42: Creating a New Model 60 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Setting up the Iris Before building the sine wave you must setup the hardware assets in MBV to allow you to hear the signal. 1. Under Model Explorer (upper left window in MBV), open up the Assets tree by left-clicking on the plus symbol next to Assets. 2. Select ‘Telestra.’ 3. Right-click in the workspace. 4. Select “iris” and name it Iris1 5. In order to edit the Iris values, you must reload your model. The reload button is the circle with a blue arrow rotating clockwise. 6. After reloading, double left-click on Iris1 asset to open its properties. 7. Next you will set the gain levels, this you to hear the audio out after you finish creating the model. To do this, scroll down to the atmel_gains box and double-left-click on it to open the properties. 8. Set all the values to 15 by double-clicking each name and typing in the value. Select “Set Default” and select Close. Figure 43: Setting up the Iris Copyright © 2008 Advanced Simulation Technology inc. 61 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Creating the Sine Wave 1. Under Model Explorer, open up the Model folder by left-clicking on it. 2. Right-click in the workspace, under Audio select Wave and name it Sine_Wave Remember: The object names cannot contain spaces. Underscores must be used in lieu of space characters. 3. Reload the model, so you can edit the fields in the Sine_Wave. 4. Open the Sine_Wave object and in the schematic open wavetype and select the sine wavetype by double-leftclicking on kin and selecting it from the drop down menu. This must be done to hear sound in the model after the model is finished. 5. Navigate back to the workspace and right-click to add an IrisCable, name it IrisCable1 6. Reload the model. 7. Right-click on IrisCable1 and select ‘assign to an Iris’, then select Iris1 62 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. To route the audio from the Sine_Wave out to the Iris middle-click on the Sine_Wave object and select from Signal >> all of Important! Between this step and the next step, once you select the ‘all of’ with the middle mouse button, you can only navigate the folders with the left mouse button before finishing the link with the middle mouse button. If you do hit another button you will lose the link “focus” you have from the sine wave. 9. Then middle-click on the IrisCable1 and select to stereoOperator >> AudioOutA Copyright © 2008 Advanced Simulation Technology inc. 63 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Creating the Table 1. Right-click in the workspace and select Control and TableXY16, rename this to Sine_Freq_Table 2. Reload the model. 3. Open the Sine_Freq_Table, double-click Table and open the tree table. Expand the table data and set Data X and Y values for the data fields 0 through 4. The ‘X’ values range from 1 to 5. The ‘Y’ fields will be the corresponding frequencies, shown below. Note: Continue to set values as ‘Default.’ Close the window after setting the values. 64 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4. Then double-click on the ‘X’ input from the schematic view. In the fields list, under Type view select Uint from the pulldown list. Set as Default and close the window. 5. To drive the table output into the Sine_Wave navigate back to the workspace, middle-click on the Sine_Freq_Table object and select from Output_kout_float Then middle-click on the Sine_Wave object and select to Frequency The result should be linked as shown below. Copyright © 2008 Advanced Simulation Technology inc. 65 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 5: Driving the Amplitude by Creating a Counter and Comparator 1. To add the Counter component right-click in the workspace and under Control select Counter. Name the new Counter object Sine_Amp_Counter 2. Reload the Model. 3. Double-click the Sine_Amp_Counter to set the values. Open Duration and set kin to 10. Open End Value and set kin to 1. Open Start Value and set kin to 0. Then open the Counter and set Continuous to TRUE. 66 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4. To add the comparator component return to the workspace and right-click and under Control select Comparator. Name the comparator object Sine_Amp_Comparator 5. Reload the model. 6. To set the comparator values, open the comparator object. Open the ‘Y’ and set the kin to 0.5. Open Compare and set the LessThan value to 1. Copyright © 2008 Advanced Simulation Technology inc. 67 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7. To link Sine_Amp_Counter inputs to Sine_Amp_Comparator navigate back to the workspace and middle-click on the Sine_Amp_Counter object and select from Count_kout_float Then middle-click the Sine_Amp_Comparator and select to X 68 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. To set the Sine_Wave amplitude middle-click the Sine_Amp_Comparator object and select from Output_kout_float Then middle-click the Sine_Wave and select to Amplitude Copyright © 2008 Advanced Simulation Technology inc. 69 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 6: Creating a New ICD 1. Navigate to tools in the top menu bar and click on ‘ICD Tool.’ Create a new ICD and name it Host_ICD Note: The ICD name cannot contain spaces, using spaces may cause problems in MBV. Underscores must be used in lieu of space characters. 2. Then create a new packet and name it Component_Tutorial_Inputs (This ICD and packet will be used in tutorials throughout section 9.0.) 3. Under Current Packet, select the new packet Component_Tutorial_Inputs. 4. Add a new member and name it Sine_Counter_Trigger 5. Set the member information as shown below. Remember: To find the type open the Sine_Amp_Counter object and open the Trigger input. The default type is basic/boolean, as shown below. 70 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Add another new member and name it Sine_Freq_Table_Select The type for this member can be set to various options but for this tutorial set it to basic/ uint32. 7. Highlight both the members and right-click, select ‘Auto Index/Offset’ and set to 0. 8. Save the new ICD and then hit the “magic wand” tool to create the assets. Copyright © 2008 Advanced Simulation Technology inc. 71 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 7: Linking the ICD to the Model 1. Navigate back to the workspace. Right-click and add a UDPinCable and rename it Tutorial_Inputs 2. Right-click on Tutorial_Inputs and assign the UDP cable to the Component_Tutorial_Inputs packet. 3. To set the trigger in the Sine_Amp_Counter middle-click Tutorial_Inputs and select from host packet >> Sine_Counter_Trigger 4. Then middle-click Sine_Amp_Counter and select to Trigger 72 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 5. Middle-click on Tutorial_Inputs and select from/to host packet >> Sine_Freq_Table_Select 6. Then middle-click Sine_Freq_Table and select to x_kin_uint 7. Reload the model and the log list should look like the list below (no errors). Remember: The log list is found at the bottom of the main MBV page. Drag it up with the mouse arrow to allow a larger viewing area. Copyright © 2008 Advanced Simulation Technology inc. 73 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 8: Mapping the Iris You will route the audio to the Iris cable using RMS. This step maps the actual Iris hardware device to the Iris1 asset you created in MBV. Before you can map the Iris, you must load the current model in RMS Model>> Management. 1. Open RMS and navigate to the Hardware>>Mapping page. 2. You should see two Irises that have a “Map It” button under the Model Asset Column. 3. Select the first Iris “Map It” button, in the drop down box of Iris1, select one of the two numbers. The numbers correspond to the Iris’s hardware serial numbers. If you look at the front of your two Irises you should see the serial numbers in the upper right hand corner. 4. After choosing the serial numbers, select “Map Hardware”. 5. Return to MBV and in the top toolbar under Models, select “Start Model”. Figure 44:Mapping the Iris Hardware 74 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Now you have completed your Sine_Wave, plug your speaker or headset into channel A of the Iris you just mapped. To hear your different sine wave tones open the Component_Tutorial_Inputs UDP cable and change the Sine_Freq_Table_Select values between 1-5. You should hear different frequencies as you change the values. Copyright © 2008 Advanced Simulation Technology inc. 75 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 9: Organizing Your Model As you continue with the following tutorials in section 6.0 or as you build a large model, you will want to organize different parts of the model into subfolders. 1. Highlight the entire model workspace created in this tutorial, right-click and select cut. 2. Right-click and create a new model subfolder and name it SineWave. 3. Paste the contents of your model into the SineWave folder. Figure 45: Final Model 76 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9.2. Tutorial 2- VOX This section is intended to follow and build upon the model from Tutorial 1 in section 9.1 The second tutorial will focus on the Vox object. This tutorial will demonstrate how to route audio into the model from an ‘on the wire’ object. In this case, we assume it is an operator using a mic to transmit a voice signal. The additional components in the model will be the Vox object, Iris cable and UDP input cable. The audio input will be routed back out to the Iris so the operator can hear his/her voice, much like a side tone. A PTT switch can be used to enable/disable voice signal output. The host driven input from a UDP pack can enable/disable the Vox to detect the mic sound. By the end of this section the user should be familiar with: • The Vox object • Enabling/disabling the Vox object and adjusting its detection level • Using the PTT switch to activate voice transmission Step 1: Creating a Vox subfolder 1. Click in the workspace under the main Model folder and add a new model subfolder. Name the folder Vox. 2. Open the Vox folder, use this folder workspace to create the remainder of the Vox tutorial. Step 2: Creating the Vox object and Iris Cable 1. Right-click in the workspace and under Audio select Vox. Name the Vox object Mic_Input_Vox 2. Right-click to add an Iris cable, name it IrisCable1 3. Right-click on the IrisCable1 and select assign to an Iris >> Iris1 This assigns the Iris cable to the Iris asset in the model. Copyright © 2008 Advanced Simulation Technology inc. 77 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4. To route the audio from the Iris to the Vox, middle-click IrisCable1 and select from/to stereo Operator >> AudioInA 5. Then middle-click on the Mic_Input_Vox object and select to AudioIn >> all of 6. To route the audio from the microphone to the Vox out, you will need to middle-click Mic_Input_Vox and select from AudioOut >> all of 7. Then middle-click IrisCable1and select to stereoOperator >> AudioOutA 78 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. To route the PTT, middle-click IrisCable1 and select from/to stereoOperator >> digital_inA1 >> digital_inA1_kout_bool 9. Then middle-click Mic_Input_Vox and select to PTT Copyright © 2008 Advanced Simulation Technology inc. 79 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Creating New Vox Members in the ICD and Assigning to the Model 1. In the workspace right-click and add the UDPincable, name it Tutorial_Inputs (the same name used in the previous tutorial). 2. Right-click on Tutorial_Inputs and select Assign UDP Input Cable >> Telestra[Component_Tutorial_Inputs_PortXXXXXX] 3. Navigate to the menu bar and open the ICD tool. Open the ICD and packet created in the previous tutorial. 4. Add a new member and name it Vox_Level 5. Set the required settings as shown below. 6. Add a second member and name it Vox_Enable 7. Set the required settings. 80 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. Highlight all the members in the packet, right-click and select ‘Auto Index/Offset.’ Enter 0 for the starting offset number. 9. Save the ICD and click the “magic wand” to create the assets. 10. Return to the Vox folder workspace, middle-click Tutorial_Inputs and select from/to hostPacket >> Vox_Level 11. Then middle-click on Mic_Input_Vox and select to VoxLevel Copyright © 2008 Advanced Simulation Technology inc. 81 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12. Repeat step 10 above for Vox Enable by middle-clicking Tutorial_Inputs and select from/to host packets >> Vox_Enable 13. Then middle-click on Mic_Input_Vox and select to VoxEnable 82 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 14. The last step is to turn on your mic. Return to the Telestra object in the Assets folder. Open the Iris1 and open the input settings. 15. Set the mic_preamp_a to 1(default). 16. Set the mic_preamp_b to 1(default). Reload and start your model to test your work. You should hear the 100 Hz Sine Wave from the first tutorial as soon as you start the model. Then select the press-to-talk (PTT) button to hear yourself talk. Open up the Tutorial_Inputs and change the Vox_Enable setting to TRUE to hear yourself without having to use the PTT. Adjust the Vox_Level value to change how the Vox object picks up your voice and transmits it. Copyright © 2008 Advanced Simulation Technology inc. 83 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9.3. Tutorial 3- Play Sounds This section is intended to follow and build upon the models from Tutorial 1 and 2 in sections 9.1 and 9.2. This tutorial will demonstrate how to use the Play sound object to play wave files. The Sound Library tool will be used to build a library of a group of wave files. The wave files will be assigned to positions in the PSound255 object. The 4 Channel PTT will control the played soundfiles. Each channel on the PTT switch will play a different sound file. Host controls will trigger the playing of the sound files. By the end of this section the user should be familiar with: • The Sound Library Editor • The PSound255 object • The 4 Channel PTT 84 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Before using the Sound Library the user should be aware of the loop modes. There are three loop mode options in the Sound Library. • One-shot- set this to play the sound from beginning to end, one time only. • Simple Loop- set this to play the file from beginning to end in a continuous loop. • Complex Loop- set this to play a subsection of a file in a loop for a designated time and then it continues on after the second trigger and finishes playing the remainder of the file. Simple Loop Start Finish Complex Loop Trigger Trigger Loop Start Finish Figure 46:Simple and Complex Loop Diagram Copyright © 2008 Advanced Simulation Technology inc. 85 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) The PSound is an audio object that allows for the playing of one or multiple audio files. The audio files must be in the following format: • Wave 16-bit PCM (*.wav) • 48 kHz sample rate • Mono Controls for the PSound object: • Trigger: When true, causes the soundfile located in the playfiles[Index] to play • Pause: When true, pauses the playback of the audio • Index: Pointer which specifies which playfiles[index] will be played. • Gain: playback volume of the output audio Playsounds Pause Trigger Aout 32 Index Gain Psound: playfiles [32] Sound Library Editor “Stall” Filename= /home/..../.../...../.wav Start= 0 End= 1000 Loop Mode= one-shot/simpleloop/complexloop Play All=yes/no [0] = Stall [1] = TACAN Tone [2] = Weapon fire [3] = Rain : : [31] = ..... Figure 47: Playsounds 86 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) After completing the following tutorial you should be able to: • Use the sound library • Assign playsounds to the Iris asset • Change input/output settings to hear sounds Note for the purpose of this tutorial three sound files are available on the asti web site at http:/ www.asti-usa.com. These files are chopper, tankfire, and airtraffic. To continue with this tutorial you will need to save the wave files into the .soundlibrary directory under your model directory. Figure 48: MBV Sound Library Copyright © 2008 Advanced Simulation Technology inc. 87 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 1: Creating Playsound Object and Using the Sound Library 1. Create a new model subfolder and name it Playsound. 2. Open the Playsound folder and in the workspace rightclick and under Audio select PSound255, name it Audio_Psound 3. Reload and then open the edit sound library under ‘Tools’ in the top tool bar. 4. In the sound library, click the play file icon and type Chopper. Then go to browse and find the chopper.wav file. Open the file and set the loop mode to one-shot start to end. 88 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 5. Open another play file and name it tankfire. Then go to browse and select the tankfire.wav file. Open the file and set it to simple loop. Note: Do not check ‘Play All.’ 6. Open another play file and name it Airtraffic. Then go to browse and select the incoming.wav file. Open the file and set it to one shot and check ‘Play All.’ Then click ‘Ok’. Copyright © 2008 Advanced Simulation Technology inc. 89 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Assigning Sounds to Playsound Object 1. Navigate back to the playsound workspace and open Audio_Psound. In the schematic, open psound and expand playfiles. 2. Right-click on playfile 0 and under playsound file select chopper. Set playfile 1 to tankfire and playfile 2 to Airtraffic. Close the window. 90 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Routing the Audio to the Iris 1. Right-click in the workspace and add an IrisCable. Name it, IrisCable1 2. Right-click on the IrisCable1 and select assign to an Iris >> Iris1 3. Middle-click on Audio_Psound and select from Aout >> all of 4. Middle-click on IrisCable1 and select to stereoOperator >> Audio Out A 5. Reload the model. Copyright © 2008 Advanced Simulation Technology inc. 91 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Creating the 4 Channel PTT Psound Index 1. Navigate back to the Playsound workspace and right-click under Control select FourChPTTDecoder and name it 4chPTT_Psound_Index 2. Reload the model and open the 4chPTT_Psound_Index. Under the ‘Data Viewer’ tab expand the LevelMap, expand the table and under data (3) set the ‘y’ value to 3. Set data (2) ‘y’ value to 2 and set data (1) ‘y’ value to 1. 92 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 3. Navigate back to the workspace and middle-click on 4ChPTT_Psound_Index and select from ChannelBitMask 4. Then middle-click Audio_Psound select to index 5. Next open IrisCable1 and open digital_inA2 and make sure the mode is set to Analog Mode (this is the default mode). Copyright © 2008 Advanced Simulation Technology inc. 93 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Navigate back to the workspace and middle-click on IrisCable1 and select from/to StereoOperator >> digital_inA2 >> digital_inA2_kout_float 7. Then middle-click the 4ChPTT_Psound_Index and select to LevelIn This routes the analog signal from the 4ChPTT_Psound_Index to the decoder object in the model. 8. Right-click in the workspace and add the UDPinCable and name it Turorial_Inputs 9. Reload and right-click Tutorial_Inputs to assign UDPInputCable and select Telestra [Component_Tutorial_Inputs] 94 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 10. Open the ICD tool and open the ICD and packet created in the previous tutorials. Create a new member and name it Psound_Trigger 11. Set the required settings (basic/boolean). 12. Highlight all the members and right-click and select Auto Index/Offset 13. Save and create the assets by selecting the “magic wand” tool. Copyright © 2008 Advanced Simulation Technology inc. 95 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 14. To assign the host packet to Audio_Psound navigate back to the workspace and middleclick Tutorial_Inputs and select from/to hostPacket >> Psound_Trigger 15. Then middle-click Audio_Psound and select to Trigger 16. Open the Tutorial_Inputs UDP cable and set the Psound_Trigger to True 17. Reload and start the model. Use the PTT channels to listen to the play sounds. You have successfully created a model with the Psound component! As you change the PTT channels you should hear the different sound files. You should also hear the continuous sine wave and if you press the PTT switch you will hear your voice (or if you have Vox enable set to True you should hear your voice as you speak into the mic without using the PTT switch.) You will hear all three tutorials sounds at the same time because all three audio outputs were routed to the same channel. In the next tutorial, you will learn how to use a mixer to pick and choose any combination of audio outputs. 96 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9.4. Tutorial 4- Mixer and Channel Handles The final tutorial of this series is intended to incorporate the models developed in Tutorials 1, 2 and 3 from sections 9.1, 9.2 and 9.3. Up until this point of the tutorial the audio output signals from all three tutorials could be heard at the same time. In this final stage of the tutorial the mixer object will be used to select and combine any combination of the three previous tutorial audio outputs onto one audio stream. A BitToByte object will take in host control Boolean inputs representing each tutorial’s audio signal and they will be combined to form a bit mask which will be used to control which signals are mixed in the Mixer object. A Math2 function will use a host driven integer value with a range from 1 to 100 and convert it into a percentage of total volume which is used to control the output volume level. The audio signals generated from the three previous tutorials will be transmitted on and off an internal audio bus using the IcomTx and IcomRx. The audio bus is created using the Channel Handle tool. By then end of this section the user should be familiar with: • The Mixer Object • The BitToByte Object • The Math2 Function Object • The IcomTx object • The IcomRx Object • The Channel Handle tool Copyright © 2008 Advanced Simulation Technology inc. 97 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 1: Creating the Mixer and Iris Cable 1. In the workspace, right-click and create a new model subfolder and name it Mixer 2. Open the Mixer folder and right-click in the workspace and under Audio select Mixer8, name it Tutorial_Mixer8 3. Right-click in the workspace and create an IrisCable, name it IrisCable1 4. Right-click on IrisCable1 and assign it to Iris1. 5. Route the mixer audio out through the Iris by middle-clicking on the Tutorial_Mixer8 and select from output >> all of 6. Then middle-click on IrisCable1 and select to StereoOperator >> AudioOutA 98 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Deleting Audio Out Links from other Subfolders 1. Since we will be using the mixer in this tutorial, you will need to delete all the other audio out links in the other subfolders (from the previous tutorials). 2. Right-click on each folder and highlight to expand. 3. In the Vox folder delete the audio out (the Iris cable to Vox). 4. In the Psound folder delete the audio out link. 5. In the SineWave folder delete audio out link and the IrisCable1. 6. Highlight the box around the folder objects by using the mouse. When the box turns red, select reduce. This will reduce the models back into their subfolders. Copyright © 2008 Advanced Simulation Technology inc. 99 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Setting up the Bus and Mixer 1. To create the channel handle navigate to the top tool bar to Tools and open Edit Channel Handle then select “New Handle,” name it SineWave Note: Telestra software version 3.28-1 or later features an easy way to unselect a channel. Open the playfile list in your model and right-click a playfile and select “No Playsound” and the channel handle will be set to 0 or <None>. 2. Assign SineWave to channel 1 and then hit ‘Apply.’ 3. Add two new channel handles for Vox and Playsound, assign them to 2 and 3, then hit ‘Apply.’ 4. Open the SineWave folder to create the Intercom object. In the workspace, right-click and in Intercom select IcomTx and name it SineWave_IcomTx Reload the model. 100 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 5. Open SineWave_IcomTx and then open the Asset definition. Expand kin and asset and right-click on channel then left-click to select Sinewave. 6. To assign the Sine_Wave audio to route out to IcomTx return to the Sine_Wave workspace and middle-click on Sine_Wave, then select from Signal >> all of... 7. Then middle-click on Sinewave_IcomTx and select to TxAudio >> all of... Copyright © 2008 Advanced Simulation Technology inc. 101 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. Add IcomTx in the Vox and Playsound subfolders, open each IcomTx and set the asset definition channel to the corresponding name, as shown below. 102 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9. Assign the Vox signal to route out to the IcomTx by returning to the Vox workspace and middle-clicking on Mic_Input_Vox, then select from AudioOut >> all of 10. Then middle-click on Vox_IcomTx and select to TxAudio >> all of 11. Reload the model. 12. Assign the Playsounds signal to route out to the IcomTx by returning to the Playsound workspace and middle-clicking on Audio_Psound, then select from Aout >> all of 13. Then middle-click on Psound_IcomTx and select to TxAudio >> all of 14. Reload the model. Copyright © 2008 Advanced Simulation Technology inc. 103 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 15. Navigate back to the Mixer folder and right-click and under Intercom select IcomRx and name it SineWave_IcomRx 16. Then add two more IcomRx’s and name them Vox_IcomRx and PSound_IcomRx 17. Reload the model. 18. Open up each IcomRx and in the schematic open the asset definition and select the corresponding channel handle name. For example, for SineWave_IcomRx assign the channel to Sinewave. 104 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Routing Audio 1. Middle-click on the SineWave_IcomRx and select from RxAudio >> select all of 2. Then middle-click on Tutorial_Mixer and select SignalIn0 >> all of 3. Repeat Step 1 and 2 for Vox_IcomRx and for step 2 select SignalIn1 >> all of 4. Repeat Step 1 and 2 for Playsound_IcomRx and for step 2 select SignalIn2 >> all of Copyright © 2008 Advanced Simulation Technology inc. 105 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 5: Selecting the Sound 1. Right-click in the Mixer workspace and under Control select BitToByte, name it Mixer_Control_BitToByte 2. Reload the model. 3. Middle-click on Mixer_Control_BitToByte and select from Output kout uint8 4. Then middle-click Tutorial_Mixer8 and select to Control 106 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 6: Adding Members to the ICD Packet 1. Open the ICD tool and open the previously created ICD and packet. 2. Add a new member and name it Mixer_Select_Sinewave 3. Enter the member’s required values (basic/boolean). 4. Add two new members and name them Mixer_Select_Vox and Mixer_Select_Psound 5. Enter the required values for each member. 6. Add a new member and name it Mixer_Master_Volume 7. Enter the required values. 8. Add 3 new members and name them Mixer_Sig0_Volume, Mixer_Sig1_Volume, and Mixer_Sig2_Volume 9. Highlight all members and right-click, select Auto Index/Offset. 10. Save the model and select the “magic wand” tool to create assets. Copyright © 2008 Advanced Simulation Technology inc. 107 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 108 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 7: Assigning the ICD to the Model 1. Navigate back to the Mixer folder workspace, right-click and to add the UDPInCable and name it Tutorial_Inputs 2. Reload the model. 3. To assign the ICD packet controls, middle-click Tutorial_Inputs and select from/to host packet >> Mixer Select Sinewave 4. Then middle-click Mixer_Control_BitToByte and select Bit 0 5. Middle-click Tutorial Inputs and select from/to host packet >> Mixer_Select_Vox 6. Then middle-click Mixer_Control_BitToByte and select Bit 1 7. Then repeat this for Psound but select Mixer_Select_Psound>> bit2 8. Then middle-click Mixer_Control_BitToByte and select Bit 2 Copyright © 2008 Advanced Simulation Technology inc. 109 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9. Middle-click on Tutorial_Inputs and select from/to host packet >> Mixer_Sig0_Volume 10. Then middle-click Tutorial_Mixer8 and select to SignalGain0 11. Middle-click on Tutorial_Inputs and select from/to host packet >> Mixer_Sig1_Volume 12. Then middle-click Tutorial_Mixer8 and select to SignalGain1 13. Middle-click on Tutorial_Inputs and select from/to host packet >> Mixer_Sig2_Volume 14. Then middle-click Tutorial_Mixer8 and select to SignalGain2 Note: Sig 0 -> Sinewave Volume Sig 1 -> Vox Volume Sig 2 -> Psound Volume 110 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 15. Right-click in the Mixer workspace and under Control select MathFunction2. Name the math function Mixer_Volume_Control 16. Reload the model. 17. Open the Mixer_Volume_Control and double-click on Function and set Type to Multiply 18. Open the ‘Y’ and set the kin to .01 (and the type should be float). 19. Open the ‘X’ and set the type to uint. Do not set the value for ‘X,’ this is done with the ICD. 20. Middle-click on Tutorial_Inputs and select from/to hostPacket >> Mixer_Master_Volume Copyright © 2008 Advanced Simulation Technology inc. 111 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 21. Then middle-click Mixer_Volume_Control and select to X_kin_uint 22. Then middle-click Mixer_Volume_Control and select from Output_kout_float 112 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 23. Then middle-click Tutorial_Mixer8 and select to OutGain 24. Reload the model and start. 25. Open the Tutorial_Inputs to change the volume values and drive the model. Set the Mixer_Select object to True. Hint: Don’t forget to map the Iris and set the Iris asset gains, if you have not already done so. Play the audio generated from the selected component. Try different combinations to see how to mix different audio sources. You can also set the individual volumes for each with the Mixer_Sig(#)_Volume fields setting Sig0 for the Sinewave, Sig1 for the Vox, and Sig2 for Psound. The Mixer_Master_Volume will change the volume for all. Copyright © 2008 Advanced Simulation Technology inc. 113 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Figure 49: MBV Components Tutorial Complete Model 114 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 10.0. Creating a Radio Model in MBV 10.1. Tutorial- Radio Model The two radio and two operator tutorial presented here is intended to show the user how a simple communications model is constructed. It will demonstrate the basic principles and main components upon which more complex communications models are developed. The model consists of Radio, Entity, ComSing and Vox objects. The Radios portion of the model uses the Radio and Entity objects. The Radio object simulates a radio to a level of fidelity customizable by the user. In this tutorial, only the essential parameters are covered that are needed to operate the radios. All the possible configurations of a Radio are beyond the scope of this tutorial. The Entity object is used to set a world position for the radio (one of the essential parameters). The operator portion of the model uses the ComSing and Vox objects. The ComSing is a simulated communications panel and is arguably the heart of any communications model. The CommPanel allows an operator to select amongst any number of Radio assets, in any combination, to transmit and receive on. (The Comm Panel audio signals routed to an operator are not just limited to Radios. Any type of audio signal can be selected and routed to an operator). The Vox object allows for more control and flexibility of how an operator’s voice is passed to the communications panel and ultimately a radio’s transmitter. The Vox object is capable of detecting filtered audio levels in order to auto transmit a voice signal. In this tutorial, only the Voxs' ability to detect a given audio threshold will be explored. The filter capability of the Vox will be left for the users exploration. In both the operator and radio sections, a host control interface will be used to set and drive the object parameters such as frequency selections and communication panel asset receive and transmit selections. Copyright © 2008 Advanced Simulation Technology inc. 115 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 1: Creating the Iris Asset 1. In MBV, create a new model and name it Radio_Tutorial 2. Navigate to Assets and add an Iris asset in Telestra and name it Iris_Op1_Op2 3. Reload the model. 4. Open Iris_Op1_Op2 and open the input_settings set the preamps to 1. Then open the atmel_gains and set the gains to 15, as shown below. 116 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Creating the Entity Object 1. Navigate back to the models workspace. 2. Create a new model subfolder and name it Radios 3. Create a new model subfolder within the Radios subfolder and name it World_Position 4. Open the new World_Position folder and right-click in the workspace, under radio select entity and name it Radio_WP Note: For this tutorial the world position will be used for multiple radios. If the radios are located in two different locations you need two world positions, but for radios in the same position only one world position is needed. 5. Reload the model. 6. Double-click on the Radio_WP to open the schematic. 7. Open Entity and set kin to 1 8. Open Local and set kin to TRUE 9. Open Network and make sure the default is set to DIS Copyright © 2008 Advanced Simulation Technology inc. 117 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) . 118 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Creating a New ICD 1. Navigate to Tools in the top menu and select ICD Tool to create a new ICD. 2. Name the new ICD Radio_Tutorial_ICD 3. Create a new packet and name it Radio_Tutorial_Inputs 4. Under the Current Packet pull-down list select Radio_Tutorial_Inputs. 5. Add a new member and name it Rad_Pos_X Set the member packet Type to float 64. Remember: To find the Type open the corresponding Radio object input, as shown below. 6. Add a new member and name it Rad_Pos_Y Set the member packet Type to basic/float 64. 7. Add a new member and name it Rad_Pos_Z Set the member packet Type to basic/float 64. Copyright © 2008 Advanced Simulation Technology inc. 119 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. Highlight the members and right-click to select Auto Index/Offset. 9. Save the ICD and select the “magic wand” tool to create assets. 120 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Creating the UDP Cable and Links 1. Navigate back to the World_Position subfolder workspace and rightclick to add the UDPinCable and name it Radio_Tutorial_Inputs 2. Right-click on Radio_Tutorial_Inputs and select Assign UDP Input Cable >> Radio_Tutorial_Inputs 3. Middle-click Radio_Tutorial_Inputs and select from/host packet >> Rad_Pos_X 4. Then middle-click Radio_WP and select to WorldGeocentric >> X Copyright © 2008 Advanced Simulation Technology inc. 121 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) You will repeat steps 1 and 2 for radio position ‘Y’ and ‘Z.’ Follow the steps below. 5. Middle-click Radio_Tutorial_Inputs and select from/host packet >> Rad_Pos_Y 6. Then middle-click Radio_WP and select to WorldGeocentric >> Y 7. Middle-click Radio_Tutorial_Inputs and select from/host packet >> Rad_Pos_Z 8. Then middle-click Radio_WP and select to WorldGeocentric >> Z 122 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 5: Creating the Radio 1. Navigate to the Radio subfolder workspace. Right-click in the Radios subfolder and create a new subfolder, name it Radio_1 2. Navigate to the top menu and under Tools select Edit Channel Handle. Create two new handles and name them Radio_1_Bus (Assign to Channel 1) Radio_2_Bus (Assign to Channel 2) 3. Navigate to the Radio 1 subfolder to add a radio object. Right-click and under Radio select Generic and name it Radio 4. Reload the model. 5. Double-click on the Radio object to open the schematic. Copyright © 2008 Advanced Simulation Technology inc. 123 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Open the Entity Handle input. The Entity Handle in the Radio object is linked to the Radio_WP Entity. Set these to the same values. For this tutorial set the kin to 1 124 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7. In Radio 1, open the MainAssetDefinition and left-click on kin then right-click on Channel. Choose Intercom bus and select Radio_1_Bus Copyright © 2008 Advanced Simulation Technology inc. 125 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 6: Adding Members to the ICD Packet for Radio 1 1. Open the previously created ICD and select the same packet. 2. Add three new members to drive the radio frequency, mode, and squelch. Name them and set the Types: Radio_1_Frequency, Type: basic/uint64 Radio_1_Mode, Type: basic/uint32 Radio_1_Squelch, Type: basic/float32 3. Click on Name to reorganize the new and old members by name. 4. Highlight the members and right-click and select Auto Index/Offset. 5. Save the ICD and select the “magic wand” tool to create the assets. 126 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Navigate back to the workspace for Radio 1, right-click to add UDPincable name it Radio_Tutorial_Inputs 7. Right-click on Radio_Tutorial_Inputs and assign it to Radio_Tutorial_Inputs 8. Middle-click Radio_Tutorial_Inputs (UDP cable) and select from/to hostPacket >> Radio_1_Frequency 9. Then middle-click Radio and select to MainFrequency 10. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Radio_1_Mode 11. Then middle-click Radio and select to MainMode 12. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Radio_1_Squelch 13. Then middle-click Radio and select to MainSquelch 14. Reload the model. The model workspace should look like the image to the right. Copyright © 2008 Advanced Simulation Technology inc. 127 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 7: Creating Radio 2 1. Navigate back to the Radios folder and right-click on the Radio_1 folder and copy and paste it in the workspace. MBV automatically names it Radio_2. 2. You will need to change some specific things in the Radio_2 object settings to differentiate it from Radio_1. 3. Open Radio_2 schematic and open Radio ID and set kin to 2 4. Also open the Main Asset Definition select channel and choose radio 2 bus 5. In the Radio_2 subfolder delete the links by right-clicking and selecting delete for each one. 128 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 8: Adding Members to the ICD for Radio 2 1. Open the ICD tool, and the previously created ICD and packet. 2. Add three new members to drive the radio frequency, mode, and squelch. Name them and set the Types: Radio_2_Frequency, Type: basic/uint64 Radio_2_Mode, Type: basic/uint32 Radio_2_Squelch, Type: basic/float32 3. Click on Name to reorganize the new and old members by name. 4. Highlight the members and right-click and select Auto Index/Offset. 5. Save the ICD and select the “magic wand” tool to create the asset. Copyright © 2008 Advanced Simulation Technology inc. 129 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Right-click on Radio_Tutorial_Inputs and assign it to Radio_Tutorial_Inputs 7. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Radio_2_Frequency 8. Then middle-click Radio and select to MainFrequency 9. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Radio_2_Mode 10. Then middle-click Radio and select to MainMode 11. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Radio_2_Squelch 12. Then middle-click Radio and select to MainSquelch 13. Reload the model. 130 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 9: Creating Operator 1 1. Navigate to the main model folder and add a subfolder, name it Operators 2. In the Operators subfolder, add another new subfolder, name it Operator_1 3. Open Operator_1 subfolder and in the workspace right-click and under Intercom select ComSing, name it Comm_Panel 4. In the workspace right-click and under Audio select Vox, name it Vox 5. Reload the model. Copyright © 2008 Advanced Simulation Technology inc. 131 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Next you need to set the Operator settings. Open the CommPanel schematic. Open AssetDefinition0 and expand kin, set the channel to Radio_1_Bus 7. Open AssetDefinition1 and set the channel to Radio_Bus_2 8. Open RxGain0 and RxGain1 set kin to 1 9. Open PTT and set kin to TRUE 10. Open SidetoneGain set kin to 1 132 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 10: Adding Members to the ICD for Operator 1 1. Open the ICD tool, and the previously created ICD and packet. 2. Add a new member. Name it and set the Type: Operator_1_VoxEnable, Type: basic/boolean 3. Add a new member. Name it and set the Type: Operator_1_Voxlevel, Type: basic/float32 4. Add two (2) new members. Name them and set the Types: Operator_1_ InputSelector, Type: basic/uint8 Operator_1_OutputSelector, Type: basic/uint8 5. Click on Name to reorganize the new and old members by name. 6. Highlight the members and right-click and select Auto Index/Offset. 7. Save the ICD and select the “magic wand” tool to create the asset. Copyright © 2008 Advanced Simulation Technology inc. 133 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 11: Creating the UDP in Cable and Assigning Links 1. Navigate back to the Operator_1 subfolder workspace. Right-click to add the UDPincable, name it Radio_Tutorial_Input 2. Right-click on Radio_Tutorial_Input and assign it to Radio_Tutorial_Inputs 3. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_1_VoxEnable 4. Then middle-click Vox and select to VoxEnable 134 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 5. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_1_VoxLevel 6. Then middle-click Vox and select to VoxLevel 7. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_1_InputSelector 8. Then middle-click Comm_Panel and select to InputSelector Copyright © 2008 Advanced Simulation Technology inc. 135 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 9. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_1_OutputSelector 10. Then middle-click Comm_Panel and select to OutputSelector 11. Next you need to connect the Vox audio to the Comm_Panel audio. Middle-click Vox and select from AudioOut >>all of 12. Middle-click Comm_Panel and select to TxAudio >> all of 13. Reload the model. 136 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 12: Creating Operator 2 and Adding Members to the ICD Packet 1. Navigate back to the Operator subfolder. Rightclick and copy the Operator_1 folder and paste it as Operator_2 in the Operator folder. 2. In the Operator_2 subfolder delete the Radio_Tutorial_Input links. 3. Open the ICD tool, and the previously created ICD and packet. 4. Add a new member. Name it and set the Type: Operator_2_VoxEnable, Type: basic/boolean 5. Add a new member. Name it and set the Type: Operator_2_Voxlevel, Type: basic/float32 6. Add two (2) new members. Name them and set the Types: Operator_2_ InputSelector, Type: basic uint8 Operator_2_OutputSelector, Type: basic uint8 7. Click on Name to reorganize the new and old members by name. 8. Highlight the members and right-click and select Auto Index/Offset. 9. Save the model and select the “magic wand” tool to create the asset. Copyright © 2008 Advanced Simulation Technology inc. 137 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 138 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 13: Adding Links for Operator 2 1. Navigate back to the Operator_2 subfolder to change the UDP Input Assignment, and select the Radio_Tutorial_Inputs to Radio_Tutorial_Inputs 2. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_2_VoxEnable 3. Then middle-click Vox and select to VoxEnable 4. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_2_VoxLevel 5. Then middle-click Vox and select to VoxLevel 6. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_2_InputSelector 7. Then middle-click Comm_Panel and select to InputSelector 8. Middle-click Radio_Tutorial_Inputs and select from/to hostPacket >> Operator_2_OutputSelector 9. Then middle-click Comm_Panel and select to OutputSelector Operator 1 and 2 should look identical. Copyright © 2008 Advanced Simulation Technology inc. 139 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 14: Connecting the Iris Asset 1. Navigate back to the Operators folder and right-click to add an Iris Cable, name it IrisCable_Op1_Op2 2. Right-click on the Operator_1 subfolder and select to expand the subfolder. 3. Right-click on IrisCable_Op1_Op2 and assign to IrisCable_Op1_Op2 4. Middle-click IrisCable_Op1_Op2 and select from/to stereoOpertor >> AudioInA 5. Then middle-click Vox (in Operator 1 subfolder) and select AudioIn >> all of 140 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Middle-click IrisCable_Op1_Op2 and select from/to stereoOperator >> digital_inA1 >> digital_inA1 kout_bool 7. Then middle-click Vox (in Operator_1 subfolder) and select to PTT The workspace on your screen should look the same as the screen shown below. 8. Middle-click Operator 1 Comm_ Panel and select from RxAudio >> all of 9. Then middle-click IrisCable_Op1_Op2 and select to stereoOperator >> AudioOutA Copyright © 2008 Advanced Simulation Technology inc. 141 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 10. Right-click on the box around the Operator_1 folder and reduce the contents back into the folder. Then expand the Operator_2 subfolder, shown below. 11. Middle-click IrisCable_Op1_Op2 and select from/to stereoOpertor >> AudioInB 12. Middle-click Vox (Operator 2 subfolder) and select to AudioIn >> all of 13. Middle-click IrisCable_Op1_Op2 and select from/to stereoOperator >> digital_inB1 >> digital_inB1_kout_bool 14. Middle-click Vox and select to PTT 142 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 15. Middle-click Comm_Panel and select from Rx/Audio >> all of 16. Middle-click IrisCable_Op1_Op2 and select to stereoOpertor >> AudioOutB Below is an expanded view of both Operator_1 and Operator_2 subfolders with the Iris cable connections. Below is a folder view of both Operator_1 and Operator_2 subfolders with the Iris cable connections. 17. Reload the model. Copyright © 2008 Advanced Simulation Technology inc. 143 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 15: Mapping the Iris Hardware Devices to the Model 1. Open RMS with your local browser. 2. Login to RMS using the same username you used to log into MBV for your model development. 3. Navigate to the Model >> Management screen and confirm that the model is loaded but not started. 4. Then navigate to the Hardware >> Mapping screen. 5. Click on the “Map Iris Devices to Model” button. 6. Select the serial number for the physical Iris device (if you don't know it look on the Iris hardware). 7. After setting the serial numbers select the “Map it” button. 144 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 16: Running the Model 1. Navigate back to MBV and reload the model. 2. Then start the model and confirm that it is running. 3. Open the Telestra Radio_Tutorial_Inputs. 4. Set the values for the following: • Operator_1_InputSelector to 1 • Operator_1_OutputSelector to 1 • Operator_2_InputSelector to 2 • Operator_2_OutputSelector to 2 • Radio_1_Frequency to 100000000 • Radio_1_Mode to 2 • Radio_1_Squelch to .02 • Radio_2_Frequency to 100000000 • Radio_2_Mode to 2 • Radio_2_Squelch to .02 5. Press the PTT and start talking. Note: The Vox settings are not manually set because they are driven by the host. When setting host driven outputs and inputs for the Comm Panel remember to set output to hear and input to talk. Copyright © 2008 Advanced Simulation Technology inc. 145 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Congratulations, you have now completed the radio tutorial. 146 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 11.0. Converting a 2-operator 2-radio model to an 8operator 4-radio model This model tutorial builds onto the previous Radio Tutorial and shows the user how to convert the 2-operator 2-radio model to an 8-operator 4-radio model. Step 1: Adding Radios 3 and 4 1. In the Radios folder highlight Radio_1 and Radio_2. 2. Right-click the highlighted subfolders and select Copy. Rightclick again in the workspace and select Paste. Two new sub folders named Radio_3 and Radio_4 will appear. Step 2: Adding to the Existing ICD 1. Open the ICD tool and open Radio_Tutorial_ICD.x ml 2. Under the Current Packet pulldown list select Radio_Tutorial_Inputs. 3. Right-click and select Add Member. Name the member Radio_3_Frequency Set the type to basic/uint64. 4. Right-click and add two more members and name them Radio_3_Squelch and Radio_3_Mode Set the types for these two members. Remember that the type for squelch is basic/float32 and Mode is basic/uint32. 5. Add three more members for Radio 4. Name them Radio_4_Frequency Radio_4_Squelch Radio_4_Mode 6. Set the corresponding type for each member. 7. Highlight all members in the ICD, right-click and select ‘Auto Index/Offset’ and set to 0. Copyright © 2008 Advanced Simulation Technology inc. 147 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. Save the ICD and click the “magic wand” tool to create the assets. 148 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 3: Linking the ICD to Radio_3 and Radio_4 1. Navigate back to the Radio_3 sub-folder. Right-click on the UDP Cable and select Assign UDP Input Cable >> Telestra [Radio_Tutorial_Inputs (port 10000)] 2. Right-click one of the links from the Radio_Tutorial_Inputs to the Radio and select delete link. Delete the other two links in this same fashion. 3. Recreate the links using the Radio 3 inputs. To do this link the frequency, squelch, and mode from the Radio_Tutorial_Inputs to the Radio. See the example shown below linking the frequency. Copyright © 2008 Advanced Simulation Technology inc. 149 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4. Reload the model. 5. Navigate to the Radio_4 sub-folder. Again, delete the three links then re-link the Frequency, Mode, and Squelch using the Radio_4 inputs as done with Radio_3. 6. Open the Channel Handle Editor and add two new handles named Radio_3_Bus and Radio_4_Bus and click ‘Apply’ and then click ‘OK.’ 150 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 4: Adding Operators 1. Navigate to the Operator_1 subfolder and double-click on Comm_Panel. Open RxGain2 and set default kin to 1. Repeat with RxGain3. 2. Open AssetDefinition2 and right-click on kin->assets->channel select Choose Intercom Channel and Radio_3_Bus 3. Under AssetDefinition3 add the channel Radio_4_Bus using the same process. 4. Repeat the previous three steps for on the Comm Panel in the Operator_2 sub-folder. 5. Navigate to the Operators folder. In the workspace highlight the Iris Cable and both Operators_1 and Operators_2 sub-folders. 6. Right-click on the Operator_2 sub-folder and select copy. Copyright © 2008 Advanced Simulation Technology inc. 151 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 7. Right-click in the workspace and select paste. Right-click and paste two more times so you have a total of 8 operators. 8. Navigate to the Assets->Telestra Folder. Right-click on Iris_Op1_Op2 and choose copy. Paste a new Iris onto the workspace and rename it Iris_Op3_Op4. Paste another Iris and name it Iris_Op5_Op6. Repeat again and name it Iris_Op7_Op8. 9. Navigate to the Operators folder. Right-click on IrisCable_Op1_Op3 and rename the cable IrisCable_Op3_Op4. 10. Right-click again on IrisCable_Op3_4 and select Assign To Iris then select Iris_Op3_Op4 152 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 11. Right-click on IrisCable_Op1_Op4 and rename the cable IrisCable_Op5_Op6. Rightclick again on the cable and select Assign To Iris then select Iris_Op5_Op6 12. Right-click on IrisCable_Op1_Op5 and rename the cable IrisCable_Op7_Op8. Rightclick again on the cable and select Assign To Iris then select Iris_Op7_Op8 Copyright © 2008 Advanced Simulation Technology inc. 153 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 5: Adding ICD members to Drive the Operators 1. Open the ICD tool and add a new member and name it Operator_3_InputSelector Set the type to basic/uint8. 2. Add another new member and name it Operator_3_OutputSelector Set the type to basic/uint8. 3. Add another new member and name it Operator_3_VoxEnable Set the type to basic/boolean. 4. Add another new members and name it Operator_3_VoxLevel Set the type to basic/float32. 5. Repeat this process for Operators 4 through 8. 154 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 6. Highlight all members, right-click and select Auto Index/Offset. Then save the ICD and click the “magic wand” tool to create assets. Congratulations you have created a 4 radio - 8 operator model!. Copyright © 2008 Advanced Simulation Technology inc. 155 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 156 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.0. The Radio Object Radio Models (also referred to as Comms Models) are the largest, most complex, and most used models in MBV. This chapter contains several specifically focused radio tutorials to demonstrate some of the properties of real radios and MBV simulated radios. This chapter will also focus on the components most often used in comms models and the radio environment. The radio tutorials include the following: • Amplitude Modulation Versus Frequency Modulation • Local vs. Networked • Mode Tables • Crypto • Frequency Hopping • Adding Tones and Noise Effects • Comm Panels Copyright © 2008 Advanced Simulation Technology inc. 157 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.1. Amplitude Modulation (AM) versus Frequency Modulation (FM) Tutorial This radio tutorial will cover the use of the two primary modulations for radio operation, AM and FM. Signals that are produced via FM radio are more resistant to noise and interference than AM radio, and are subject to something called “Capture Effect.” When several FM radios are transmitting on the same frequency, an FM receiver will only be able to receive the strongest signal. The weaker signals are suppressed and the operator will not hear all of the signals from every transmitting radio. When several AM radios are transmitting the AM receiver is not subject to this effect. The aviation industry uses AM communications, since it allows multiple signals to broadcast on the same channel frequency. AM Radio Transmitting 1 FM Radio Transmitting 1 AM Radio Transmitting 2 AM Radio Transmitting FM Radio Transmitting 2 3 3 AM Radio Receives 1, 2, & 3 FM Radio Transmitting FM Radio Receives 3 only Figure 50: Capture Effect 158 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Before getting started with this tutorial you must upload the AM/FM base model named Basic_Model from the ASTi web site. The base model provides several pre-built objects that will be needed for the remainder of the tutorials. Many of these objects are very common to MBV and you should be familiar with them when building models. The details of these components are beyond the scope of this tutorial in order to focus on radio features. The following tutorial will demonstrate the differences between AM and FM and how to set up transmitters and receivers. 1. In MBV, open the Basic_Model and ensure that the soundfiles are also uploaded to your Telestra. 2. Once the model has been loaded, go to RMS and map your Iris hardware to the Iris in the model. For more details on this step see the section “Mapping Iris Devices” in the MBV Basic Training Manual (DOC-01-MBV-BTM-1). 3. Once you've mapped the hardware, the Basic_Model should have the following objects: • Sine wave • ClickingSound • Radio Entity • Iris Asset • AudioOut cable Copyright © 2008 Advanced Simulation Technology inc. 159 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4. Add three generic radios (under Radio->Generic), name them Radio_1, Radio_2, and Radio_3 Reload the model. You've just created three radios that are already in-tune with each other. Note that if you look inside the radio, the MainFrequency is 100Mhz and the MainMode is set to 1. MBV provides default settings for the radios so that the most common configurations are preset. The Generic Radio component comes with 15 preset modes that are fully configurable by the user. These settings are discussed in detail in section 12.3. Mode Tables. When MainMode is set to 1, the radio simulates a typical AM radio. When MainMode is set to 2, the radio simulates a typical FM radio. 5. Open the Radio_1 schematic and set the Entity Handle kin to 1 and set as default. This step provides Radio_1 with a world position. ASTi radios rely on world positions and entities in order to calculate propagation effects. If you are familiar with DIS, the Entity will also set the Exercise ID, Site ID, and other common DIS parameters for the radio. 6. Continue in the Radio_1 schematic and set the AutoPTT kin to TRUE. AutoPTT will put the radio into a VOX mode so that the radio will transmit whenever it detects an audio signal. Remember to set as default, if it is not set to default and the user reloads the model, the AutoPTT will go back to FALSE. 7. Repeat steps 5 and 6 for Radio_2. 8. In Radio_3 set the Entity Handle to 1. For this example, Radio_3 will only be receiving, so you do not need to set the AutoPTT. 9. Link the audio from the Sine wave to the ‘Local Audio’ of Radio_1. 10. Link the ‘Click’ playsound to the ‘Local Audio’ of Radio_2. 11. Link MainAudio (all of…) from Radio_3 to the AudioOut cable and reload the model. Why are the Arrows Different Colors? Notice that every time you make a link in MBV, a colored arrow that connects two objects appears on the canvas. These colors represent the different processing rates of the Telestra. For most connections, the information is passed between objects at 100Hz. This rate is called the ‘K Rate’ and is used for math functions, digital inputs, and host controls. Every time something is processed at the ‘K Rate’ a blue arrow is drawn on the canvas. In order to have good audio quality, MBV needs to process audio streams at a rate much higher than 100Hz. This rate is called the ‘A Rate’ and it is set to 1 kHz. A red arrow indicates an audio stream is passing between the two components at the ‘A Rate.’ 160 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12. Listen to the headphones and you should hear both the Sine Wave tone and a clicking sound. The radios are operating in AM mode and mixing the signals together by the receiver allowing you to hear both sounds. 13. Change all three radios to FM by opening each schematic and changing the MainMode value to 2 and set as default. 14. Listen to the headphones again. Notice that with the radios in FM, you will only hear one sound. 15. Open Radio_2 and adjust the TransmitterGain. You will find that once the TransmitterGain of Radio_2 passes the gain of Radio_1, it will change what Radio_3 receives. Note: Before continuing with the Radio Tutorials, set the power switch to FALSE on all of the radios. This will turn off the radios and prevent them from interfering with the remaining radio exercises. Copyright © 2008 Advanced Simulation Technology inc. 161 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.2. Local Versus Networked Radios This tutorial will cover local versus networked radio models in two main steps. In the first step of this tutorial, the user will set up a simple 2 operator, 2 radio model. The goal is to have two people communicating to each other using the Telestra. In the second step, the two operators on one Telestra will communicate with two operators on a second separate Telestra. Telestra 1 Telestra 2 LAN Op 2 Op 1 Local Op 3 Op 4 Local Networked (LAN) Figure 51: Local versus Networked Step 1: Creating a Local Radio Model 1. Open the Local_vs_Networked subfolder. (Be sure that your base model is loaded, this should include an Iris cable for the audio input.) 2. Right-click in the workspace and add two generic radio objects. Name them Radio_1 and Radio_2 3. Right-click in the workspace and add two entity objects. Name them Entity_Radio1 and Entity_Radio2 For an MBV radio to function properly it must have an attached Entity. The Entity gives the radio a World Position, which is required to do ranging effects. The Entity can also provide network data such as the DIS exercise, site, host and entity IDs. 4. Assign the AudioInA from the Iris cable to Radio_1. 5. Assign the DigitalInA1_bool to Radio_1. This is required to use the PTT. 6. Open the Radio_1 object and set the Radio ID to 1. MBV radios require a unique radio ID to function properly. 7. Open Entity_Radio1 and set the Handle to 37. By setting the Handle to 37, any type of transmitter or receiver can attach to Entity_Radio1 by matching the handle number. Matching handle numbers is equivalent to linking two objects together. 162 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 8. Set the Local to TRUE. Setting the Local flag contains the Entity (or anything the Entity is attached to) from being sent out over the network. As the name implies, it contains the Entity local to the Telestra. Before closing, set the UseGeodetic to TRUE. 9. Repeat steps 4-8 for Radio_2. Choose a different Handle number, radio ID and use channel B of the Iris cable instead of A. 10. Link Radio_1 and Radio_2 to the Iris cable labeled Audio_out_Headset. Then link Radio_1 to AudioOutA and Radio_2 to AudioOutB. 11. In the workspace right-click and add an Iris cable. Name this cable AudioOut 12. Attach Radio_1 and Radio_2 to AudioOut headset. The model is ready for local communication. Operator 1 and 2 should be able to communicate by pressing the PTTs for their headsets. Copyright © 2008 Advanced Simulation Technology inc. 163 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Step 2: Converting the Local Radio Model to a Networked Radio Model 1. Open Entity_1 and Entity_2 and set Networked to DIS. 2. In Entity_1 and Entity_2 set Local to FALSE. 3. Open RMS through your browser. Navigate to the Radio Settings page and ensure that the radios have the same DIS net and port number. Congratulations, you now have a networked model. Save this model and upload onto another Telestra on the network and Operator 1 can communicate with Operator 3. In RMS, the radios should display transmitting and receiving states as shown below. Figure 52: RMS Radios Transmitting and Receiving Note: Before continuing with the Radio Tutorials, set the power switch to FALSE on all of the radios. This will turn off the radios and prevent them from interfering with the remaining radio exercises. 164 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.3. Mode Tables The Generic Radio in MBV can be modeled to simulate hundreds of different types of radios. MBV also allows the user to change from one type of radio to another by simply changing the Main Mode. Each radio can store up to 15 different fully configurable modes that can be set to match desired specifications and fidelity. Each radio mode comes with 20 parameters that are preset within the model. These parameters are referred to as the “Mode Table” for each radio. Mode Tables allow the user to create a high fidelity simulated radio for use in a particular exercise. The mode tables can be set to create a radio that could never exist in the real world, therefore users must know what controls to set for a specific radio. The following section describes the controls, and how to tune them to match the specifications of real world radios. In order to view the mode tables: 1. Open the schematic of a Generic Radio. 2. Double-click on the control parameter labeled MainModeSelect. 3. Expand the browser for a particular mode, i.e. Mode l. Figure 53: Mode Tables Why are they called Mode Tables? The idea that each radio has it’s own mode table, rather than just mode settings, comes from ASTi’s legacy DACS platform. In the DACS environment each radio displayed the modes as rows in a table and the settings as columns. Copyright © 2008 Advanced Simulation Technology inc. 165 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Antenna Gain Real radios have antennas that act differently depending on the radio mode. For example, an FM antenna is typically better at receiving than an AM antenna. MBV allows the user to set different antenna gains for each mode in order to simulate these and other radio effects. The antenna gain units are in dBm, which makes them additive. Therefore, setting the antenna gain inside the mode table will not override the Generic Radio AntennaGain setting. MBV calculates the strength of the receiver antenna by combining both of these values. Note that the antenna gain is receive only, and does not effect how the radio transmits. What is a dBm? dBm is a unit of measuring power ratios and is commonly used in radio, fiber optics, and microwave technology. Unlike decibels, dBm are not dimensionless and use milliWatts as a reference. Therefore, a reading of ‘0’ dBm is equivalent to ‘1’ milliWatt of power. Bandwidth and Bandwidth Overlap Threshold Bandwidth is the operating range around the tune frequency of a radio. For example, if a real radio is transmitting at exactly 6 Mhz, it is actually running in a range of frequencies and is not a single point frequency. This means that a receiver can be set to 6.000001 Mhz, and is considered “in tune” with a radio at 6 Mhz. Setting the bandwidth for each mode allows the radio to operate with a very narrow range or a very broad spectrum depending on the application. In the mode table the bandwidth defaults to 25kHz. .1 MHz bandwidth 0 bandwidth Frequency 5.9 6 6.1 6.2 MHz Frequency 2 Radio Signals without Bandwidth Out of Tune 5.9 6 6.1 6.2 MHz 2 Radio Signals with Bandwidth Out of Tune .4 MHz bandwidth Frequency 5.9 6 6.1 6.2 MHz 2 Radio Signals with Bandwidth In Tune Figure 54: Bandwidth Examples 166 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) The Bandwidth Overlap Threshold refers to the percentage of overlap that a receiver requires to be in-tune with another radio. In the diagram below, there are two radios with bandwidth that overlap by 50 percent each. Therefore, if the receiver BWOverlapThreshold is set to 0.5, the two radios are in-tune. Bandwidth overlap also effects the strength of a signal. If two radios’ bandwidth overlaps by 100 percent, then the radios will have better reception than radios overlapping by only 50 percent. Overlap Overlap Frequency 4 6 8 Tx Rx Frequency 10 MHz 4 6 8 10 MHz Figure 55: Bandwidth Overlap Threshold Examples BWOverlapThreshold is a receive effect, which means the transmitter’s overlap threshold does not have a direct effect in MBV. However, the receiver’s BWOverlapThreshold is in reference to the transmitter’s bandwidth. Meaning, the amount of overlap created by the transmitter’s and receiver’s bandwidths must exceed a percentage of the transmitter’s total bandwidth. This percentage value is defined by the receiver’s BWOverlapThreshold value. In the diagram below, the transmitter (Radio 1) has a smaller bandwidth than the receiver (Radio 2). Radio 1 has a 50 percent bandwidth overlap but Radio 2 only has a 25 percent bandwidth overlap. MBV will consider these two radios in-tune as long as Radio 2 has a BWOverlapThreshold of 0.5 or lower. Conversely, Radio 1 could have a BWOverlapThreshold of 0.9 and the radios would still be in-tune. Overlap Frequency Radio 1 (Tx) 50% Radio 2 (Rx) 25% Figure 56: Bandwidth Overlap Threshold Levels Copyright © 2008 Advanced Simulation Technology inc. 167 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) The diagram below displays the transmitter with a larger bandwidth than the receiver. Notice that even though the radios share the same center frequency, they will not be in-tune since only 25 percent of the transmitter bandwidth overlaps. MBV will indicate that the receiver is jammed rather than in-tune. Overlap Frequency Tx Rx Figure 57: Bandwidth Overlap 168 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Capture Effect This setting allows the user to turn the capture effect on or off. A value of ‘0’ will turn the capture effect off and a value of ‘1’ will turn the capture effect on. When the capture effect is off, the user will hear all the in-tune signals together. When the capture effect is on, the user will only hear the in-tune radio with the strongest signal. For a more detailed description of the Capture Effect see the Amplitude Modulation versus Frequency Modulation Tutorial. Note that it is possible to set up an FM radio without turning on the capture effect. This creates a radio that does not simulate anything in the real world. Crypto System and Crypto Library The Crypto System and Crypto Library parameters relate to the crypto settings for each mode. For more information see the Crypto tutorial. Detail and Major Modulation Type The Major Modulation Type field and the Detail field use a DIS standard to help describe the signal parameters (i.e. the modulation type) of a radio. These two fields are included in the MBV mode tables and are defined per the DIS standard. Common settings for the Generic Radio are: • Generic FM radio: • Major Modulation Type = 2 • Detail = 1 • Generic AM radio: • Major Modulation Type = 1 • Detail = 2 The following table includes the possible Major Modulation Types and the Detail settings that are defined by the DIS standard. Copyright © 2008 Advanced Simulation Technology inc. 169 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Major Modulation Type 1 – Amplitude 2 – Amplitude and Angle 3 – Angle 4 – Combination 5 – Pulse 6 – Unmodulated 170 Detailed Modulation 0 – Other 1 – AFSK (Audio Frequency Shift Keying) 2 – AM (Amplitude Modulation) 3 – CW (Continuous Wave Modulation) 4 – DSB (Double Sideband) 5 – ISB (Independent Sideband) 6 – LSB (Single Band Suppressed Carrier, Lower Sideband Mode) 7 – SSB-Fill (Single Sideband Full Carrier) 8 – SSB-Reduce (Single Band Reduced Carrier) 9 – USB (Single Band Suppressed Carrier, Upper Sideband Mode) 10 – VSB (Vestigial Sideband) 0 – Other 1 – Amplitude and Angle 0 – Other 1 – FM (Frequency Modulation) 2 – FSK (Frequency Shift Keying) 3 – PM (Phase Modulation) 0 – Other 1 – Amplitude-Angle-Pulse 0 – Other 1 – Pulse 0 – Other 1 – Continuous Wave emission of an unmodulated carrier Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Digital Mode In the real world, radios are constantly receiving energy from outside factors. This energy results in background noise that can be heard when listening to a radio. On an analog radio, the static is suppressed via the radio squelch control. However, since the advent of digital radios, signals are now encoded bit streams and the radios are able to remove the noise floor without the use of squelch control. Radios in MBV simulate digital radios via the Digital Mode setting in the Mode Table. Set the Digital Mode value to ‘1’ to allow the digital radio to eliminate background noise. Encoding The encoding mode selects the type of encoding for radio transmission. Each encoding type has a different network bandwidth which causes varying audio quality. The following encoding types are set per the DIS standard. • 0 – uses default encoding (The default encoding parameter is set elsewhere in the radio.) • 1 – muLaw provides a medium level of audio quality (typically 128 or 64 Kb/s) • 2 – CVSD provides a lower level of audio quality (typically 16 Kb/s) • 4 – PCM16 provides a high level of audio quality (typically 256 Kb/s) The payload bandwidth comes from the number of samples per second multiplied by the number of bits per sample for each encoding type. • muLaw = 8 kHz x 8 bit samples = 64 Kb/sec. • CVSD = 16 kHz x 1 bit samples = 16 Kb/sec. • PCM 16 = 8 kHz x 16 bit = 128 Kb/sec. Note that the sample rate is configurable via RMS. The values listed above are the MBV defaults. Full Duplex When this parameter is set to ‘0’, the radio operates in half-duplex mode. Half-duplex mode is when the radio is able to transmit and receive signals, but cannot do both at the same time. In order to allow the radio to operate in full duplex mode set the value to ‘1.’ Typically, full duplex is only used for intercom systems and never for real radios. Copyright © 2008 Advanced Simulation Technology inc. 171 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Noise Every electronic component inside a real radio receiver produces a noise known as their “internal noise.” This noise is also called “thermal noise” and comes from the movement of electrons inside the electrical components such as capacitors and resistors. The radio’s electronic components are chosen very carefully and manufactured to produce a minimum noise. Inside the mode table, the noise parameter refers to the “internal noise” of the radio and is set in units of dBm. Propagation Radios in MBV simulate the propagation losses of the radio waves as they are sent through the air. In order to model a radio to a desired fidelity, the mode tables provide a choice of four different types of propagation. Each type of propagation is turned on by setting the value within the mode table to TRUE and turned off by setting the value to FALSE. Any configured propagation effects are automatically turned off for a radio by placing that radio in the center of the earth (world position of 0, 0, 0). 172 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 1) Ranging Ranging occurs as a result of the distance between two radios. The greater the distance between the radios, the weaker the signal. The principle behind ranging is how the power of the transmitted signal dissipates as it traverses a larger area. In the figure below, Radio 1 and Radio 2 are close together and Radio 3 is farther away. The signal loss due to ranging, is proportional to the square of the distance. Thus, if two radios are twice as far apart, there will be four times the loss. Due to this relationship, ranging effects are referred to as r-squared losses. Radio Signal Strength Radio 1 Distance Radio 2 Radio 3 x 2x Figure 58: Ranging Effects Copyright © 2008 Advanced Simulation Technology inc. 173 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 2) Occulting As a radio moves beyond the horizon, the Earth blocks the radio signal resulting in a propagation loss known as occulting. The radio signal becomes ‘occulted’ due to the curvature of the earth. In the figure below, imagine that the blue oval (the top oval overlapping the earth) is an ellipsoid. MBV examines the cross-section of the ellipsoid where the arrow is located. The crosssection will be a circle, and the percentage of the circle that is blocked by the Earth effects the amount of signal loss. Radio Signals Not Blocked Radio 1 Radio 2 Earth Figure 59:Occulting Effects MBV uses a smooth ellipsoid earth model, WGS84, when determining occulting loss. Note that while all radios experience ranging, HF radios do not experience occulting. Users should turn the occulting effect off for HF radios. 3) Terrain The terrain effects are caused by the loss of signal due to land obstruction such as a mountain. Terrain losses are very similar to occulting and are calculated by MBV in much of the same way, since both are a form of obstruction. The difference between the two is the MBV model of the Earth. For occulting effects MBV uses a simple, smooth Earth model. For terrain effects the model of the Earth is extremely accurate with mountain peaks accurate to the inch, but this model requires a much larger database. These databases are commonly offered on an external ‘Terrain Server’ and MBV sends pathloss requests to them. 174 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 4) Ionosphere The Ionosphere effects occur with High Frequency (HF) radios. Instead of two radios talking to each other in a straight line, the signals will bounce off of the earth’s atmosphere. When the radio signal bounces off of the ionosphere, the propagation loss can change depending on the frequency, whether it is day or night, or different seasons. ASTi’s HF server calculates the effects from the ionosphere by looking at parameters such as time, date, and sun spot number. When the radio uses ionosphere effects, the radio will need the ASTi HF server in order to properly calculate the signal loss. Ionosphere Radio 2 Radio 1 Earth Figure 60: Ionosphere Effects Receive Only Set the Receive Only mode to one (1) to disable the radio transmitter. The radio will be able to receive signals as normal, but it cannot send any transmissions. Receive Offset Receive Offset changes the frequency at which the radio will receive signals. For example, if the Main Frequency is set at 100 MHz and the Receive Offset is set to 60 MHz the radio will receive at 160 MHz. Main Frequency + Offset = Frequency of Receiver Receive offset enables the user to model satellite radios, which rely on using both an uplink (transmit) and a downlink (receive) frequency. Spread Spectrum and System Spread Spectrum and System settings relate to the frequency hopping characteristics of the radio. These settings are discussed in detail in the Radio Frequency Hopping section. Copyright © 2008 Advanced Simulation Technology inc. 175 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Tx Power The Tx Power sets the transmission power of the antenna in Watts. MBV multiplies this value (among many others) to determine the antenna power of a transmitter. Since the value is multiplied, setting this value to zero will effectively turn the antenna off. Note that the radio can still be in a transmitting state, but a receiver can be two feet away and it will not be able to capture the signal. Mode Table Defaults As a reference, the following page displays the Generic Radio mode table defaults. 176 Copyright © 2008 Advanced Simulation Technology inc. Copyright © 2008 Advanced Simulation Technology inc. Noise Propagation Ionosphere Occulting Range Terrain ReceiveOnly RxFreqOffset SpreadSpectrum System TxPower 0 0 3 2 0.0 0.8 25k 1 0 0 1 0 0 0 3 3 0.0 0.8 25k 1 0 0 1 0 0 0 8 4 0.0 0.8 25k 1 0 0 1 1 0 0 2 5 0.0 0.8 25k 1 0 0 1 1 0 0 3 6 0.0 0.8 25k 1 0 0 1 1 0 0 3 7 0.0 0.8 25k 1 0 0 1 1 0 0 2 8 0.0 0.8 25k 1 0 0 1 1 0 0 2 9 0.0 0.8 25k 1 0 0 1 1 0 0 1 10 0.0 0.8 25k 0 0 0 2 0 0 0 1 11 0.0 0.8 25k 0 0 0 2 0 2 0 1 12 0.0 0.8 6k 0 0 0 2 0 False True True False 0 0 0 1 10.0 False True True False 0 0 0 1 10.0 False True True False 0 0 0 1 10.0 False False True False 0 0 0 1 10.0 False True True False 0 0 1 2 10.0 False True True False 0 0 1 2 10.0 False True True False 0 0 1 2 10.0 False True True False 0 0 1 3 10.0 False True True False 0 0 1 3 10.0 False True True False 0 0 0 1 10.0 False True True False 0 0 0 1 10.0 True False True False 0 0 0 1 10.0 -105.0 -105.0 -110.0 -110.0 -105.0 -105.0 -105.0 -105.0 -105.0 -105.0 -105.0 -105.0 0 0 1 Encoding FullDuplex MajorModulation Type 1 0.0 0.8 25k 0 0 0 1 0 Mode AntennaGain BWOverlap Bandwidth CaptureEffect CryptoLibrary CryptoSystem Detail DigitalMode False False False False 0 0 0 0 0 0 0 0 0 13 & 14 0 0 0 0 0 0 0 0 False False True False 0 0 0 1 10.0 -110.0 2 0 8 15 0.0 0.8 25k 1 0 0 1 1 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 177 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.4. Crypto Transmissions between radios are inherently insecure. Since radio waves are sent across the earth, anyone with a receiver set to the proper frequency can hear any messages, secret or otherwise. Radios that use cryptography were created as a way of preventing private signals from being understood. Crypto radios scramble the signals before they are transmitted so that only receivers who know the special key will have the ability to decode them. This allows the radios to produce a secure voice transmission across any frequency. Before getting started with Crypto, the user must set the standard radio environment parameters (e.g. frequency, modulation type, system, frequency hopping parameters) to match between radios. If these radio parameters do not match, secure communication will not occur regardless of the crypto parameters settings. To use crypto settings with a set of radios, the radios must have the following: • Matching Crypto Key and Crypto System settings. If these settings are not equal, then the radios will be in a mismatch state resulting in noise. If the transmitter is set with a Crypto System of 0 it is considered a plain radio. A Crypto Key or Crypto System value of 65535 is used as a wildcard. • Matching Crypto System types. The DIS standard provides values for various Crypto System types (e.g. KY-58, KY-100). • A user defined crypto library inserted into the radio. This is used to model preamble, postamble and mismatch tones, for example. • The Secure Mode must be set to ON. If the Secure Mode is not set, all crypto settings are ignored by the radio including the system, key, and libraries. A crypto radio can be set to receive plain and encrypted transmissions or just encrypted transmissions. 178 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Crypto Key Crypto radios use their particular key to encode and decode transmissions. This allows any other radio with the same crypto key to receive and transmit securely. In MBV, the crypto key provides discrimination among radios operating in secure mode. If the crypto key value is ‘0’, the radio communication is not encrypted. If the crypto keys in the transmitting and receiving radios do not match, the receiving radio will not receive the encrypted transmission. MBV also allows radios to use a wild card crypto key by setting the key to 65535. Wild cards cause transmitters and receivers to match, agnostic of the crypto key. A transmission from a radio with a wild card crypto key, will be received by any radio with a nonzero crypto key and a matching or wild card crypto system value (see Crypto System below). Likewise, a radio with a wild card crypto key, will receive transmissions from any radio with a nonzero crypto key and a matching or wild card crypto system value. Crypto System Crypto System refers to the radio’s type of encryption. A radio can use the same key, but scramble the signal in an entirely different way. Similar to the crypto key, the crypto system provides discrimination among radios operating in a secure mode. However, unlike the crypto key, which applies to the entire radio object, the crypto system is mode specific and represents a different type of encryption. If the crypto system is set to ‘0’ for a given radio mode, encrypted communication will not occur in that radio mode. If the crypto system in the transmitting and receiving radios do not match, the receiving radio will not receive the encrypted transmission. A transmission from a radio with a wildcard crypto system (Crypto Sys = 65535) will be received by any radio with a nonzero crypto system. Likewise, a radio in a mode with a wildcard crypto system, will receive transmissions from any radio with a matching or wildcard crypto key and a nonzero crypto system value. In the Crypto System field, DIS enumerated values are used for the transmitter PDUs for certain radio crypto systems as shown in the table below. Field Value 0 1 2 3 4 5 Radio Crypto System Other KY-28 KY-58 Narrow Spectrum Secure Voice (NSVE) Wide Spectrum Secure Voice (WSVE) SINCGARS Copyright © 2008 Advanced Simulation Technology inc. 179 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Crypto Library The crypto library greatly simplifies encrypted radio simulation by automatically playing sounds (such as a preamble beep, a postamble, or a mismatch tone) at the appropriate times during a secure radio conversation. The use of crypto libraries also ensures that the beeps and tones are only heard by the owner of the radio and do not go out onto the network. Use crypto libraries for automatically playing of the preamble, post-amble, mismatch and other crypto sounds. Beep and tone playfiles are used to signify secure transmit. A library of crypto tones can be associated with each model and crypto system of a given radio object. The table below describes the timing of crypto library sounds. Note: Most radios only use a subset of these tones. Simply leave the playsound entry set to “no playsound” if the crypto gear you are modelling does not implement that feature. Crypto Setting Preamble (rx_pre, tx_pre) Active Match (rx_match) Active Mismatch (rx_mismatch) Active Clear (rx_clr) Active Clear (tx_clr) Active Secure (tx_secure) Post Amble (rx_post, tx_post) 180 Description Plays immediately before a reception or transmission. Plays during a reception when the crypto parameters are equal. Users can use continuous, looping playfiles. Occurs when a receiver’s crypto key or system do not match the transmitter’s. Plays when a crypto radio receives a non-secure transmission. Plays when a crypto radio transmits an unencrypted signal. (i.e. crypto key or system = 0 but secure mode is ON) Plays during a transmission with valid crypto parameters. Plays immediately after a reception of a transmission. Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) The Crypto Library playsounds correspond to the settings shown in the table below. Playsound playsound [0] playsound [1] playsound [2] playsound [3] playsound [4] playsound [5] playsound [6] playsound [7] playsound [8] playsound [9] playsound [10] Setting rx_preamble rx_preamble 2 rx_postamble rx_clr rx_match rx_mismatch tx_pre1 tx_pre2 tx_post tx_clr tx_secure Crypto Tone Gain The Crypto Tone Gain field controls the output gain of all of the sound files in the crypto library. The crypto tone gain can only be set to a fixed value. Copyright © 2008 Advanced Simulation Technology inc. 181 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Crypto Example The base model for this example includes two vox objects, two operator Iris cables, and two radios. 1. Set the required radio fields including Power Switch, Mode, Frequency and Entity ID. Set the Mode to 2 and the Frequency to 45 MHz. 2. Open each Radio object and open the MainModeSelect primitive. Expand Mode 2 and set the Crypto System to 2. 3. Next set the radios to play the secure sounds shown below. In PSound assign the following corresponding playfiles to 0, 2, and 10. • playsound [0] = double beep [0 = rx_preamble] • playsound [2] = single beep [2 = rx_postamble] • playsound [10] = constant beep [10 = tx_secure] Unkeyed Mic Keyed Mic Tx Preamble Post-amble Constant Beep Keyed Mic Rx Unkeyed Mic Beep Preamble Double Beep Post-amble Note: Before continuing with the Radio Tutorials, set the power switch to FALSE on all of the radios. This will turn off the radios and prevent them from interfering with the remaining radio exercises. 182 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.5. Frequency Hopping Frequency Hopping (FH) is a convenient way for radio communication to avoid interference and it was developed to combat signals from getting jammed or intercepted. Frequency hopping works by rapidly switching frequencies while a receiver and transmitter communicate. In order for this to work, the receiver and transmitter have to jump between the same frequencies, at the same speed, and at the same time. Typically, the transmitter and receiver have a set of predefined frequencies and use an agreed upon pseudorandom pattern to hop through the frequencies. The starting point and hopping pattern must be agreed upon ahead of time. Since FH uses a wide range of frequencies it is also referred to as ‘spread spectrum.’ The figure below shows the operation of a jammer. The jammer’s job is to fill up a large bandwidth with heavy noise. The result is that whenever a radio tries to communicate with that band, the noisy signal is received instead of the desired message. By using spread spectrum, the radio can jump across multiple frequencies and only remain in the jammer’s band for a short period of time. FH also adds a level of security. Normal Radio Radio being Jammed Radio Radio Frequency Jammer Frequency Figure 61: Jammer Blocking Radio Frequency Frequency Hopping Spread Spectrum Figure 62: Frequency Hopping using Spread Spectrum FH is not limited to military radios, many wireless devices receive interference from microwaves and other radio traffic. To combat this Bluetooth devices such as laptops and cell phones use 79 different hop frequencies and switches between them 1,600 times a second. Copyright © 2008 Advanced Simulation Technology inc. 183 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) In the simulated world, radios do not actually hop frequencies. The effects, such as noise resistance and time drifting, are simulated but the actual changing of frequencies is not. MBV relies on a set of matching parameters in order to determine if a radio is spread spectrum, and if two radios that are frequency hopping can communicate with each other. In order to enable FH on a radio: • The mode must have Spread Spectrum = 1 • The System must match a valid FH enumeration (see table below). System # 1 2 3 4 5 6 7 DIS Standard Generic HQ HQII HQIIA SINCGARS CCTT SINCGARS JTIDS / MIDS Why do I need to set the System Type? The system number selects the radio’s type of frequency hopping. There are multiple hopping algorithms and different kinds of frequency hopping. HAVE QUICK (HQ) frequency hopping was created specifically for UHF radios because by the 1970’s, anyone with an inexpensive police scanner could intercept sensitive military communications. HQII is considered an improvement on the system, but neither it nor HQ can communicate with the CCTT SINCGARS type, which was developed specifically for use with CVSD encoding. In Frequency Hop mode, the tune frequency is used for free space path loss calculations and ranging. The generic radio contains two sets of frequency hopping parameters, SINCGARS type and HAVE QUICK type. Radios will be considered in tune if all the proper Frequency Hopping parameters match. 184 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) HAVE QUICK The HAVE QUICK Frequency Hopping extensions are applied when the system types are HQ, HQII or HQIIA. The HAVE QUICK radios must have the following inputs: • Net ID • Sync Offset • Time of Day ID • Transec Key • Word of the Day ID Note that for all parameters, a value of zero acts as a wild card. Figure 63: Setting Frequency Hopping HAVE QUICK Parameters Copyright © 2008 Advanced Simulation Technology inc. 185 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) SINCGARS The SINCGARS Frequency Hopping extensions are applied when the system type is Generic, SINCARS, or CCTT SINCGARS. Once enabled, a SINCGARS radio requires that the Net ID be set to non-zero to begin frequency hopping. The input parameters are similar to HAVE QUICK. The SINCGARS must have the following inputs: • Clear Channel* • HopSetID • LockoutID • NetID • SyncOffset • TSecID * Setting the Clear Channel input to a non-zero number will cause MBV to ignore the other five FH parameters. In addition, all ranging and propagation effects are turned off and the radio acts as an intercom. Figure 64: Setting Frequency Hopping SINCGARS Parameters 186 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Frequency Hopping Example The frequency hopping base model will include two radios, two operators, two Iris cables, and FH_Controls. The FH_Controls will act as the host computer to drive the packet. Note that the radio power is turned off by default. For SINCGARS: 1. In both FH_Radio and FH_Radio2, open the Mode table and select the correct System mode for SINCGARS. 2. In both FH_Radio and FH_Radio2, open the Mode table and set the Spread Spectrum to 1. 3. Return to the model workspace and middle-click the FH_Controls and select the SINCGARS NetID. Then middle-click the FH_Radio and assign it to the SINCGARS NetID. Repeat this for the remainder of the SINCGARS parameters. After you have finished, right-click on a link and select to inspect the links. 4. Repeat step 3 above for FH_Radio2. The links should match up as shown below. Figure 65: Frequency Hopping Link Inspection Copyright © 2008 Advanced Simulation Technology inc. 187 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 1. In both FH_Radio and FH_Radio2 set the NetID to a number other than 0. 2. Reload the model. Test your model. The radios should work. 3. Set the remaining SINCGARS parameters as needed or leave at 0 for wildcard. 188 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) For HAVE QUICK: 1. In both FH_Radio and FH_Radio2, open the Mode table and select the correct System mode for HAVE QUICK. 2. In both FH_Radio and FH_Radio2, open the Mode table and set the Spread Spectrum to 1. 3. Return to the model workspace and middle-click the FH_Controls and select the HQ NetID. Then middle-click the FH_Radio and assign it to the NetID. Repeat this for the remainder of the HQ parameters. After you have finished, right-click on a link and select to inspect the links. The links should match up as shown in the SINCGARS example above. 4. Repeat step 3 above for FH_Radio2. 5. Open both FH_Radio and FH_Radio2 and set the NetID’s to a number other than 0. 6. Reload the model. Test your model. The radios should work. 7. Set the remaining HQ parameters as needed or leave at 0 for wildcard. Figure 66: Frequency Hopping Model Copyright © 2008 Advanced Simulation Technology inc. 189 ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 12.7. Comm Panels The Comm Panel provides a control interface for an operator to various radios and communication options, such as navigation aides or radar warnings. Panels manage transmit and receive selections of multiple but separate communication channels and include controls for volume and sidetone selection. This is similar to the communication panels that are found on real aircraft, which provide pilots a central location to handle all of their communication assets. The comm panel component inside MBV is called ComSing. The user must link radios to the channel service via the Asset Definition, and the component provides two-way communication between the channel and the bus. The panel provides Asset Definition 0 through 7 or up to 8 channels. A control called ‘input select’ is a bit mask that allows voice transmissions across several radio assets by routing the input audio stream of the panel, such as the mic from an operator’s headset. A press-to-talk (PPT) control is included to work in conjunction with the input audio. Similarly, the Output Select mask determines which assets are fed out of the panel to the earphones of an operator’s headset. A master volume and individual volumes are available for each asset (RxGain0-7). Note: The 8 channels are synonymous to the communication assets used anytime you see Asset Definition in MBV. The user must create a channel handle to connect the radio to the comm panel. Some quick points to remember about comm panels: • The channel handle editor must be used to create a channel name representing the comms assets that can be added to the panel. • The input audio can be transmitted across all eight channels simultaneously or any combination of the eight channels. Use the control ‘input selector’ to select where to route the audio. • Use the ‘output selector’ control to listen to all eight channels simultaneously or any combination of the eight channels. • Comm panels have a single PTT connection, a master volume, and individual channel volumes as well. • Comm panels provide users the ability to create a central location for managing communication assets and also enable radio sharing. 190 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) Input Select >> Bitmask Comm Panel Bus Output Select >> Bitmask ON AssetDefinition0 * RxGain0 ON AudioIn OFF AssetDefinition1 * RxGain1 OFF ON AssetDefinition2 * RxGain2 OFF OFF AssetDefinition3 * RxGain3 ON OFF AssetDefinition4 * RxGain4 ON ON AssetDefinition5 * RxGain5 ON OFF AssetDefinition6 * RxGain6 OFF AudioOut Master Volume ON AssetDefinition7 * RxGain7 OFF Figure 67: Comm Panel Example 191 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 13.0. Model Troubleshooting There are two ways to view/debug specific variables within a running model. The user can view model objects directly in the MBV development environment or the user can create debug sets in RMS. By creating debug sets in RMS, the user can quickly scan model inputs for debugging. 13.1. Creating Debug Sets in RMS The user must be operating in Advanced Mode to create new sets for debugging. 1. Select Debug from the main RMS menu. 2. Click on “create new set” and name the set. This will display the options for creating a new entry. 3. Add an Entry from the pull-down list. This list is compiled from the directories listed in your model. 4. Add an object from the next pull-down list. The object list is compiled of the objects used in the chosen directory. 5. Select a specific variable in the object from the pull-down list. 6. Select the “Add Entry” button to add the new entry to the list. The user can choose to divide the debug sets by creating sections within a page and by creating separate pages. Use the list order option to organize your sets into specific orders. Exit Advanced Mode to view the set for debugging. The debug set can be downloaded and uploaded and is stored with the model. 192 Copyright © 2008 Advanced Simulation Technology inc. ASTi MBV Basic Training Manual (Ver.1, Rev.C.1) 13.3. MBV Debugging To facilitate debugging, ensure that the MBV development environment is configured for advanced mode, which allows viewing internal data of components. Instructions 1. Start MBV Development Environment 2. From File Menu, select “Edit Config” 3. Expand “Advanced” item 4. Right-click over the value and select “yes” 5. Select “Save changes” 6. Select “OK” at confirmation pop-up window 7. Select “Close” 13.4. Viewing RX Buffer Data The UDP input cable data viewer displays the ICD variable values received from the host. The offset indicates byte location within the buffer. The bit-packed variables are not shown in bit order. The value shown for bit-packed variables is the overall byte value. The packet counter at the bottom of the data viewer increments as packets are received from the host. Instructions to View Rx Buffer Data 1. Navigate to Assets / Telestra 2. Find target UDP input cable 3. Double-click the icon or right-click and select “Open” 4. Expand window so that Offset column may be viewed 13.5. Viewing TX Buffer Data The UDP output cable data viewer displays the ICD variable values sent to the host. The offset indicates byte location within the buffer. The bit-packed variables are not shown in bit order. The value shown for bit-packed variables is overall byte value. The packet counter at the bottom of the data viewer increments as packets are sent to the host. Instructions to View Tx Buffer Data 1. Navigate to Assets / Host 2. Find target UDP output cable 3. Double-click icon or right click and select “Open” 4. Expand window so that Offset column may be viewed 193 Copyright © 2008 Advanced Simulation Technology inc.
© Copyright 2026 Paperzz