Telestra App Note
Creating a Model for HHTs using ACE Studio Helpers (#83)
The Hand-held Terminal (HHT) provides a highly flexible user interface for controlling and monitoring ASTi simulated radios and intercoms. This application note demonstrates how to create a model in ACE Studio with a single HHT-based operator using a single radio. The steps shown below can easily be extended to build a model with multiple operators using HHTs to access multiple radios. For additional information on HHT operation see the ASTi Hand-Held Terminal Operator Interface Guide with Telestra (DOC-T4-HHT-UG-1).
Follow the six steps below to create a model for the HHTs. Before getting started, open ACE Studio and create a project or open an existing project. Then create a new layout or use the default layout.
Note: This tutorial assumes the Comm Plan is set up with a proper frequency.
- Step 1: Add a Domain
- Step 2: Add a Radio
- Step 3: Add a Channel
- Step 4: Add an ACENet Audio Device
- Step 5: Edit the Telestra Configuration
- Step 6: Install the Project
Step 1: Add a Domain
- Open the Domain Editor.
- Select the '+' and type in the Domain name.
- Select 'OK' to add the Domain.
- Set the Exercise ID.
- Set the host Site ID and App ID.
- Select 'OK' in the Domain Editor.
Step 2: Add a Radio
- Open the Radio Helper.
- Select the '+' and select Radio in the drop down list.
- Type in a radio name and select 'OK.'
- Set the Domain, select the '…' box to select the Domain. All radios on a given Target must have the same Domain to communicate.
- Select to 'Set IDs from Domain' or 'Set IDs Manually' to define the protocol ID. The protocol ID is a string of the format 'DIS:site.app.entity.radio' or 'DIS:entity.radio' or 'DIS:radio', where site, app, entity, and radio are positive integers. If you exclude site and app the radio environment will assign the default site and app from the DIS file in the Domain Editor to the radio. If you exclude entity the radio environment will assign a random, unique number for the entity ID of the radio. Ex: 'DIS:3.4' will use 3 as the radio's entity and 4 as the radio ID. The site and app are populated from the defaults in the Domain.
- Set the Fill. This sets the radio parameters that are set up in the Comm Plan. If using the default fill, be sure to set a proper frequency.
Note: The Crypto Library and World Position are Optional.
- Check the HHT box.
- Optional: Add an identifier as a unique name for the radio. For example, Pilot, Copilot etc.
- Select 'Update'.
Step 3: Add a Channel
The channels are the audio connection points that connect the audio distribution within the model.
- Open the Channel Helper.
- Select '+' and select HHT from the drop down list.
- Type the HHT name and select 'OK.'
- Select the 'HHT' tab and under 'HHT POSN' select the radio, set the RX/TX, and LOCK. This sets the operator’s ability to receive and transmit, if locked the operator cannot change these settings.
- Select 'Update.'
Step 4: Add an ACENet Audio Device
This step connects the hardware ACENet audio device to the software ACENet audio device in the model (this example uses ACE-RIUs). Each ACE-RIU is given a unique identifier name, to view the names see the RMS > ACE-RIU page.
- In the canvas (graphical layout) right-click and select the ACENet device, this example uses an ACE-RIU.
- Set the name and identifier.
- Select the Telestra, Group and Channel. Note that the HHTs can only use Channels A and C on the ACE-RIU.
- Select 'Add.'
Step 5: Edit the Telestra Configuration
- In the canvas (graphical layout) right-click the Telestra and select 'Edit.'
- In the Telestra Editor select the 'SM' tab.
- Check the 'HHT Enable' box and the 'Auto Generate HHT INI File' box.
- Optional: Check the 'HHT Radio Ident Enable' box. Set this if you assigned the radio a unique identifier (Pilot, Copilot, etc.) in the Radio Helper. Note that only the first letter of the name will appear on the HHT screen.
- Select 'Update.'
Step 6: Install the Project
Select the 'Install' button. The model is complete.
This application note was created with ASTi ACE software version 4.12.