QNX Technical Articles

Date of this edition: November 16, 2009

Target OS: This software is compatible with target systems running QNX^® Neutrino^® 6.3.0 SP2, 6.3.0 SP3, 6.3.2, or 6.4.0.

Host OS: You must have already installed the QNX^® Momentics^® development suite 6.3.0 SP2, 6.3.0 SP3, 6.3.2, or QNX^® Momentics^® Tool suite 6.4.0. as a self-hosted QNX Neutrino system, or on one of the following hosts:

GF-Specific Installation Instructions

To install the flash-gf player, you need to install the following:

• Advanced Graphics TDK 2.0.0 or later
• Core Patch for the Advanced Graphics TDK (Patch ID 331)
• Image and Input Patch for the Advanced Graphics TDK (Patch ID 841)
• Character-Set Translation and devi-hid Photon Patch (Patch ID 842)

Photon-Specific Installation Instructions

To install the flash-ph player:

1. Complete the "Installation procedure" from the Installation Note for the Image and Input Patch for the Advanced Graphics TDK (Patch ID 841).
2. After installing the patch, open a command shell and type:

   cd base_dir

3. If you use VMWare, rename the vmware graphics driver by typing:

   mv patches/630SP2-0841/target/qnx6/x86/lib/dll/devg-vmware.so patches/630SP2-0841/target/qnx6/x86/lib/dll/devg-vmware_gf.so

4. From the Image and Input Patch for the Advanced Graphics TDK (Patch ID 841) Installation Note, continue the installation by following the "Applying the Patch" procedure.
5. Install the Character-Set Translation and devi-hid Photon Patch (Patch ID 842).

---

Because of driver incompatibilities, the above HMI Player installations can not coexist on the same QNX Momentics baseline installation.

---

Contents...

• Installing this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Uninstalling this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Documentation
• Technical support

For information about what's in this package, see the release notes. For the latest version, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

Installing this package

---

The installers underestimate the amount of disk space that you need in order to install this product. The installation procedure requires excess disk space to install the product. (Ref# 53603) Workaround: You need the following amounts (approximately) for each host OS: Host OS Disk space required QNX Neutrino 26.1 MB Windows 38.8 MB Linux 39.6 MB

---

---

Never install more than one version of the HMI player on the same QNX Momentics baseline installation. You must always uninstall pre-existing versions of the HMI Player from your current baseline before performing a new installation.

---

On a Windows host

---

If you've installed QNX Momentics versions 6.2.1 and either 6.3.0, 6.3.2, or 6.4.0 so that they coexist on your Windows host, please note: You can't install the QNX Aviage HMI Player for Adobe Flash Lite 3 when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0, 6.3.2, or 6.4.0. If you switch from 6.2.1 to 6.3.0, 6.3.2, or 6.4.0, you may have to log out of your user session and log back in before installing this package.

---

1. Log in as a user with system-administrator privileges.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, hmi_player-1.0.1-nnnnnnnnnnn-win32.exe, where nnnnnnnnnnn is an 11-digit build number. The package is in the form of an executable (.exe) file.
4. Double-click the file in Windows Explorer or run it at the command line.
5. Follow the instructions provided by InstallShield.

   ---

   Windows XP SP2 may display a security warning when you install this package. You can verify the package's checksums when you download the file from our website.

   ---

On a Linux host

1. Log in as root, or as a user with administrative privileges on Ubuntu.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, hmi_player-1.0.1-nnnnnnnnnnn-linux.bin, where nnnnnnnnnnn is an 11-digit build number. The package is in the form of a .bin script.
4. Run chmod to make the script executable. For example:

   chmod a+x hmi_player-1.0.1-20081234567-linux.bin

5. Run the script at the system prompt:
   • If you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment. For example:

     sudo -E ./hmi_player-1.0.1-20081234567-linux.bin
         

   • On other hosts, type (for example):

     ./hmi_player-1.0.1-20081234567-linux.bin
         

6. Follow the instructions provided by InstallShield.

On a QNX Neutrino host

1. Log in as root.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, hmi_player-1.0.1-nnnnnnnnnnn-nto.sh, where nnnnnnnnnnn is an 11-digit build number. The package is in the form of a shell script.
4. Run chmod to make the script executable. For example:

   chmod a+x hmi_player-1.0.1-20081234567-nto.sh

5. Run the script at the system prompt. For example:

   ./hmi_player-1.0.1-20081234567-nto.sh
       

6. Follow the instructions on your screen.

Uninstalling this package

---

If you decide to uninstall QNX Momentics, uninstall its related products first, or you'll leave your system in an inconsistent state.

---

On a Windows host

1. Log in as a user with system-administrator privileges.
2. Open the Control Panel (e.g. on Windows 2000: Start-->Settings-->Control Panel).
3. Select Add or Remove Programs.
4. Select QNX Aviage HMI Player for Adobe Flash Lite 3, and then click the Remove button.

On a Linux host

1. Log in as root, or as a user with administrative privileges on Ubuntu.
2. Go to the base_dir/_uninstall/hmi_player/1.0.1 directory.
3. Start the QNX InstallShield application:
   • On Ubuntu, run:

     sudo -E ./uninstaller.bin
         

   • On other hosts, run:

     ./uninstaller.bin
         

   InstallShield will now remove the package.

On a QNX Neutrino host

1. Log in as root.
2. Go to the base_dir/install/hmi_player/1.0.1 directory.
3. Run the uninstaller script:

   ./uninstall.sh
       

Documentation

The functionality provided by this package is described in the QNX Aviage HMI Player Developer's Guide, which you'll find in the IDE's help system. On self-hosted Neutrino systems, you can find the documentation in the Photon helpviewer, or, you can use a browser to load $QNX_TARGET/usr/help/product/hmi_player_en/bookset.html.

Technical support

To obtain technical support for any QNX product, visit the Support + Services area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.