How to configure audio in a Linux workstation with a Tera1 or Tera2 Remote Workstation Card

Rate this Article
No votes yet

August 27, 2018

Last modified: 11/18/2022, 10:57 pm

Knowledge Base Article Tutorial Performance Remote Workstation Card

Note: This knowledge base article covers older versions of Linux, newer modern versions Linux will automatically pick up the Audio device on the PCoIP Remote Workstation Card and activate the audio drivers. This knowledge base article has been made available for people using old versions of Linux and for troubleshooting unsupported versions of Linux.

Users wishing to add audio support to workstations with Tera1 or Tera2 PCoIP Remote Workstation Cards must install the alsa-driver package. Installing the driver package involves downloading it, potentially modifying some files, building, installing and testing it.

ALSA packages:

  • Support for Tera1 PCoIP Remote Workstation Cards is included in version 1.0.24 and later of the alsa-driver package.
  • Support for Tera2 PCoIP Remote Workstation Cards is included in version 1.0.26 and later of the alsa-driver package.

Tera1 and Tera2 PCoIP Remote Workstation Card users can do one of the following:

  1. Install the latest code from the alsa-driver package.
  2. Install version 1.0.25 of the alsa-driver package and modify it to support Tera2 if they are using Tera2 PCoIP Remote Workstation Cards.
    • Tested successfully using CentOS 6.2. See procedure below.
  3. Install version 1.0.24 of the alsa-driver package and modify it to support Tera2 if they are using Tera2 PCoIP Remote Workstation Cards.
    • Tested successfully using Fedora 14(stock kernel version 2.6.35.14-106). See procedure below.

Note: Tera1 devices typically work without modifying the ALSA driver packages.


Fedora 14(stock kernel version 2.6.35.14-106)

Installing version 1.0.24 of the ALSA driver on Fedora 14(stock kernel version 2.6.35.14-106).

  1. Go to the ALSA website (www.alsa-project.org), find and download alsa-driver-1.0.24.
    • Click the download link above current versions.
    • Find an active mirror or ftp site that holds previous versions of the driver.
  2. Unpack the driver. (e.g. tar -jxvf $/alsa-driver-1.0.24).
     
  3. Edit the file adriver.h located below. This change is necessary to fix a compiler error observed while building the package on Fedora 14.

    $/include/adriver.h

    Change line 1926.
    From: #if LINUX_VERSION_CODE KERNEL_VERSION(2, 6, 37)
    To:     #if LINUX_VERSION_CODE KERNEL_VERSION(2, 6, 35)
     
  4. Edit the file alsa-kernel/pci/hda/hda_intel.c as shown below.  This change is necessary to add support for Tera2.

    Insert the following line after line 2795:
    { PCI_DEVICE(0x6549, 0x2200), .driver_data = AZX_DRIVER_TERA },
     
  5. Follow the instructions below on how to build, install and test the driver.

 

CentOS 6.7 and 7

When installing the Development and Create Workstation Base environment the ALSA driver and mixer is included.


CentOS 6.2

If installing version 1.0.26 or greater skip to build and install the driver.

Installing version 1.0.25 of the ALSA driver on CentOS 6.2.

  1. Go to the ALSA website (www.alsa-project.org) and under current versions, download the latest ALSA driver package. (alsa-driver-1.0.25 used in this example)
     
  2. Unpack the driver. (e.g. tar -jxvf $/alsa-driver-1.0.25)
     
  3. Edit the file hda_intel.c where the location is shown below: This change is necessary to add support for Tera2.

    $/alsa-kernel/pci/hda/hda_intel.c (e.g. vi hda_intel.c)

    Make the following change to the PCI_DEVICE_TABLE (marked with +)

    /* Teradici */
    { PCI_DEVICE(0x6549, 0x1200),
    .driver_data = AZX_DRIVER_TERA | AZX_DCAPS_NO_64BIT },
    + { PCI_DEVICE(0x6549, 0x2200),
    + .driver_data = AZX_DRIVER_TERA },
    /* Creative X-Fi (CA0110-IBG) */
     
  4. Follow the instructions below on how to build, install and test the driver.
     

To build and install the driver, in the terminal window type the following commands:

  1. /sbin/modprobe soundcore
  2. cd $path-to-alsa-driver
  3. make clean
  4. ./configure (This step must complete successfully, note the preceding dot to the command)
  5. make (This step must complete successfully)
  6. make install (This step must complete successfully)
  7. Enable audio on the PCoIP Remote Workstation Card and PCoIP Zero Client by performing the following steps.
    1. Log into the PCoIP Remote Workstation Card administrative web interface
    2. Navigate to the Permissions->Audio web page
    3. Check the Enable HD Audio option
    4. Repeat the three previous steps on the PCoIP Zero Client
  8. Reboot the system for the above changes to take effect and audio starts working.

Configuring the ALSA Mixer:

  1. Type alsamixer. (to run the ALSAMIXER tool to adjust mixer settings alsamixer)
  2. Press the key and select the HDA Teradici sound card.
  3. Press the key to view all lines.
  4. Navigate to each line (Left/Right Arrow Keys) and un-mute the lines with MM at the bottom of the column by pressing the key.
  5. Navigate to each line and adjust the volume. (Up/Down Arrow Keys)
  6. Navigate to each capture line and enable audio capture by pressing the bar. (capture is on when the word CAPTURE is displayed)

Testing the Audio:

  1. Connect speakers to the PCoIP Zero Client audio output (headphone) jack and a microphone to the PCoIP Zero Client audio input (microphone) jack.
  2. Type arecord -f dat -d 5 test.wav to create a 10 second recording stored in the file test.wav.
  3. Type aplay test.wav to replay the previous recording.

Saving the ALSA Mixer settings:

  1. In a terminal, issue the command: alsactl -f /var/lib/alsa/asound.state store
  2. Open /etc/rc.local 
  3. Add the following: alsactl -f /var/lib/alsa/asound.state restore

 

See also:

How do I get audio to work with a PCoIP Remote Workstation Card in Linux?

 

 

Pertains to:
  • Remote Workstation Card 4.0.2
  • Remote Workstation Card 4.0.3
  • Remote Workstation Card 4.1.0
  • Remote Workstation Card 4.1.1
  • Remote Workstation Card 4.1.2
  • Remote Workstation Card 4.2.0
  • Remote Workstation Card 4.5.0
  • Remote Workstation Card 4.5.1
  • Remote Workstation Card 4.6.0
  • Remote Workstation Card 4.7.0
  • Remote Workstation Card 4.7.1
  • Remote Workstation Card 4.7.2
  • Remote Workstation Card 4.7.4
  • Remote Workstation Card 4.7.5
  • Remote Workstation Card 4.9.0