Performing an Air Upgrade of the DECT Handset

Transcription

1 Performing an Air Upgrade of the DECT Handset Date: April 2008 Version: v2.0 Abstract: Applicability: Updates: This application note provides technical information on how to perform an air upgrade of the DECT handset. This application note applies to DECT handsets (model TH58 with firmware build v1602) using the THOMSON TG797 R8.1.1 (software version ). Thomson continuously develops new solutions, but is also committed to improving its existing products. For more information on Thomson's latest technological innovations, documents and software releases, visit us at

2 Chapter 1 1 Introduction Air upgrade Performing an air upgrade of the DECT handset implies that the DECT handset can be updated through a wireless DECT connection (L2CAP). This means the DECT handset cradle does not have to be plugged into the Thomson Gateway to perform an upgrade. Checking whether or not perform an air upgrade can be triggered in various ways: Time based: One hour after board boot, then each eight days. Manually: By forcing the DECT handset to update. In future releases it will also be possible to trigger the DECT handset via TR-069. In If multiple DECT handsets are in range (see graphic below) with the Thomson Gateway, a forced trigger to upgrade will affect all DECT handsets. Prerequisites Before upgrading your DECT handset, the following prerequisites must be fulfilled: The DECT handset must be subscribed and in range with the Thomson Gateway (see graphic below). NotSubscribed Handset pairing with TG Pairing unsuccessfull Subscribing Handset unsubscribing Pairing successfull Subscribed Handset being in range with TG InRange Handset going out of range Upgrade successfull Handset upgrading Upgrade not successfull Upgrading The DECT handset must be in call state idle meaning it is not involved in a call. There must be a server available where the most recent DECT handset firmware files are located. 2

3 Chapter 1 Upgrade cycle The graphic below shows the interaction between the DECT handset, the Thomson Gateway and the server during the upgrade cycle:. DECT Handset Thomson Gateway Server Option A: Forced request to check Option B: Timebased check Request: * firmware_version.txt * firmware_version.txt.sig *resource_version.txt * resource_version.txt.sig Display message: No update needed TG informs HS Request acceptance Compare with: * Softwareversion * Hardwareversion * ResourceSoftwareVersion Option 1: No update needed Option 2: Upgrade needed Option B: Timebased check Download requested files Request with: * authentication * signature HTTP download of requested files Display message: New software available. Upgrade? Flash first part of file(s) and restart Confirm Transmit first part with MD5 check for integrity Reconnect and back in range Option A: forced request from: * HS * firmware_version.txt... Flash last part of file(s) and restart Transmit next part with MD5 check for integrity Reconnect and back in range Display message: Download complete Files and parameters to perform check When checking if an upgrade is needed the following files are requested by the Thomson Gateway to the server: firmware_version.txt which contains the following entries: DECT_FIRMWARE_VERSION: Gives latest available firmware for this handset type. DECT_FIRMWARE_FORCE: When set to 1 this forces an upgrade. DECT_FIRMWARE_RESOURCE_NEEDED: Informs the Thomson Gateway if a resource file needs to be downloaded and flashed along with the firmware (optional). firmware_version.txt.sig which contains the signature verification for firmware_version.txt. 3

4 Chapter 1 resource_version.txt which contains the following entry: DECT_RESOURCE_VERSION: Gives filename of the resources to flash along with the firmware. resource_version.txt.sig which contains the signature verification for resource_version.txt. The parameters Softwareversion, Hardwareversion and ResourceSoftwareversion of a registered DECT handset: are only known if the DECT handset got in range with the Thomson Gateway at least one time to store them in its RAM. have to be restored in the RAM of the Thomson Gateway after a reboot. contain the string unknown for an unknown version. Upgrading files The following upgrades are possible, depending on what is actually needed: firmware file resource file firmware and resource files The downloading and flashing of the new data on the DECT handset is performed in three consecutive steps: handset firmware from address 0x0 to 0x40000 handset firmware from address 0x40000 to the end resource file If the air transmission fails during one of these steps, the transmission and flashing is restarted where failed and the upgrade process is resumed. 4

5 Chapter 2 2 Configuring the Thomson Gateway for DECT Handset Air Upgrade Introduction To perform an air upgrade of your DECT handset, the Thomson Gateway needs to be configured first. All DECT handsets will use an URL, constructed as follows: Handset-HW-Version. Therefore the following parameters need to be configured via Command Line Interface (CLI). They must be provided by your Internet Service Provider (ISP): Username and password Machine Port Directory State The protocol used for the firmware download from the server is HTTP (port 80). Each firmware download from the server will be verified by means of a signature. Username and password Set the user name and password. There is only one user name and password for all DECT handsets subscribed to a Thomson Gateway. :voice decthandset config username=username :voice decthandset config password=password Machine Set the address of the server (machine). This can be an IP address or a Fully Qualified Domain Name (FQDN). :voice decthandset machine=handset-ips.inventel.com Port Set the port of the server where the firmware files are located. For HTTP this is typically port 80. :voice decthandset port=80 Directory Set the path (directory) where the DECT handset firmware builds are located. :voice decthandset directory=inventel/dect_handset/sales_generic/release 5

6 Chapter 2 State The firmware download for DECT handsets can be enabled/disabled. Set this parameter to enabled. :voice decthandset state=enabled Viewing your configuration on the Thomson Gateway Check your configuration on the Thomson Gateway by executing the following command: :voice decthandset list username : username machine : handset-ips.inventel.com port : 80 directory : inventel/dect_handset/sales_generic/release state : Enabled 6

7 Chapter 3 3 Manually Triggering an Air Upgrade of the DECT Handset DECT Handset The graphic below shows the TH-58 DECT handset and its controls: The table below gives you an overview of the keys on the DECT handset: Letter Description Letter Description A Call key D Navigation wheel B Left selection key E End key C Right selection key F Key pad 7

8 Chapter 3 Manually triggering an air upgrade To manually trigger an air upgrade of the DECT handset execute the following procedure: 1 On the DECT handset, which does not have to be cradled, select menu with the selection keys. 2 Go to Settings with the navigation wheel and confirm with the left selection key. 3 Go to Handset Settings with the navigation wheel and confirm with the left selection key. 4 Go to Handset Update with the navigation wheel and confirm with the left selection key. 5 The Thomson Gateway checks if an upgrade is possible (see Upgrade cycle) and performs the appropriate action: Displayed message Not available No update needed Process already busy Download complete Action The server where the firmware files are stored is not available. There is no new firmware version available on the server. There is no upgrade necessary for this DECT handset. The DECT handset is in the middle of a previous update process (triggered manually or time based). The DECT handset has been updated to the most recent firmware. During the upgrading a progress bar is shown with the status of the upgrade. 8

9

10 Visit us at: Coordinates: Thomson Telecom Prins Boudewijnlaan 47 B-2650 Edegem Belgium Copyright 2008 Thomson. All rights reserved. The content of this document is furnished for informational use only, may be subject to change without notice, and should not be construed as a commitment by Thomson. Thomson assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. The information contained in this document represents the current view of Thomson on the issues discussed as of the date of publication. Because Thomson must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Thomson, and Thomson cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. Thomson MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE INFORMATION IN THIS DOCUMENT. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.