Touchstone®

Telephony Firmware

Release 5.0.60

Release Notes and

Letter of Operational
Considerations
Touchstone® Telephony Firmware

Release 5.0.60

Release Notes and

Letter of Operational Considerations
Document release Release 2.0
Document date February 27, 2007

© 2007 ARRIS
All Rights Reserved

Printed in the USA

The information in this document is subject to change without notice. The statements, configurations,
technical data, and recommendations in this document are believed to be accurate and reliable, but are
presented without express or implied warranty. User must take full responsibility for their applications of any
products specified in this document. The information in this document is proprietary to ARRIS.

ARRIS, ARRIS International, and Voice Port are trademarks of ARRIS Licensing Company. Cornerstone is a
registered trademark of ARRIS Licensing Company.

The firmware described in this document is furnished under a license agreement and may only be used in
accordance with the terms of that license.
Publication History
February 15, 2007 Initial Release, v.0.1
February 16, 2007 Approver Comments Added, v. 1.0
February 27, 2007 Approved for SIP Support, v. 2.0
Table of Contents

1 OBJECTIVES OF THIS DOCUMENT _____________________________ 1

1.1 ARRIS COMMITMENT ____________________________________________ 1
1.2 PURPOSE AND SCOPE OF THIS RELEASE _______________________________ 1
1.3 PRODUCT IDENTIFICATION _________________________________________ 1
1.4 HARDWARE COMPATIBILITY LIST ___________________________________ 3
1.5 MINIMUM FIRMWARE BASELINE FOR HARDWARE _______________________ 4
1.6 PRODUCT DOCUMENTATION _______________________________________ 5
2 RELEASE NOTES ____________________________________________ 6
2.1 NEW PRODUCT FEATURES _________________________________________ 6
2.2 RESOLVED PRODUCT DEFICIENCIES _________________________________ 14
3 LETTER OF OPERATIONAL CONSIDERATIONS __________________ 59
3.1 OPERATIONAL CONSIDERATIONS ___________________________________ 60
3.2 UPGRADE CONSIDERATIONS ______________________________________ 67
3.3 EVENT REPORTING CHANGES FOR TS 5.0 ____________________________ 69
3.4 LOGS AND ALARM CHANGES FOR TS 5.0_____________________________ 70
3.5 DEPRECATED MIBS FOR TS 5.0 ____________________________________ 70
4 CUSTOMER SERVICE AND SUPPORT __________________________ 72

APPENDIX A: FEATURE MATRIX _________________________________ 73

APPENDIX B: COMPLIANCE MATRIX ______________________________ 75

APPENDIX C: NEW MIBS & OIDS FOR TS 5.0 _______________________ 76

APPENDIX D: NEW CLIS FOR TS 5.0 ______________________________ 81

APPENDIX E: TLV-39 MIB IMPLEMENTATION _______________________ 87

Touchstone Telephony Firmware - Release 5.0.60

1 Objectives of This Document

1.1 ARRIS Commitment

ARRIS is committed to developing high quality, value-added products and services to the
Multi-Service Operator (MSO). ARRIS continually strives toward meeting our
customer’s needs with solutions that will help achieve their business objectives.

1.2 Purpose and Scope of This Release

This document describes the value-added features and anomaly resolutions associated
with this release. It also informs operators of known Operational Considerations
associated with this product release that have been identified either through ARRIS’
testing or field operations.

1.3 Product Identification

Described in this document is the Touchstone Telephony Firmware. This Touchstone
Firmware release is intended for ARRIS manufactured EMTA cable devices (see 1.4
Hardware Compatibility List) that support DOCSIS™, Euro-DOCSIS™, and
PacketCable™ standards.

Product Description Touchstone Telephone Firmware – Release 5.0.60

DOCSIS™ Compatibility DOCSIS

 1.1, and DOCSIS
 2.0

TS050060_021307
Firmware Filename

SysDescriptor SW_REV: 5.0.60

PacketACE Version 7.8

Maintenance Supplemental Release for NCS and SIP
Validation Sequence
Customers
Purpose of Load: Not all versions of a load are created
Load Name Extension
for every release.
_NA.img North America signed firmware image

_EU.img European signed firmware image

TELNET_ON Loads with Telnet access permanently enabled

MODEL_4_5 Supports TM4XX models (TM402) and TM5XX models (TM502)

SIP Supports SIP

EURO Supports Euro-PacketCable including Euro-Provisioning Changes

Release Notes & Letter of Operational Consideration 1

Touchstone Telephony Firmware - Release 5.0.60

D11PLUS Features to easily transition from DOCSIS 1.0+ to DOCSIS 1.1

OPT177 Loads which support Option Code 177 ONLY for provisioning

MODEL_WR Supports the WTM552 wireless router module

Release Notes & Letter of Operational Consideration 2

Touchstone Telephony Firmware - Release 5.0.60

1.4 Hardware Compatibility List

The ARRIS products listed will operate using this Touchstone Firmware. The firmware is
not intended for any other device at this time. The table below briefly shows the feature
set of each unit.

No Li-Ion 1 Line 2 Lines Multiple Indoor Outdoor

Battery Battery of of Voice Unit Unit
Voice Voice Lines
TM401A/B
TM402A/B/C
TM402G/H
TM402P
TP402 N/A N/A
TP404 N/A N/A
TM501A/B
TM502A/B/C
TM502G
TM502H
WTM552A/B
WTM552G/H

Release Notes & Letter of Operational Consideration 3

Touchstone Telephony Firmware - Release 5.0.60

1.5 Minimum Firmware Baseline for Hardware

The table below shows the minimum released firmware needed to operate a specific
model of hardware.

Hardware Model Firmware Image

TM402X TS040122_071504 (TS4.1.22)
TM401X TS040431_041805 (TS4.4.32)
TP40X TS040435_042805 (TS4.4.35)
TM502A/B/G TS040514_071305 (TS4.5.14)
TM502C/H TS050014_071306 (TS5.0.14)
TM501X TS040552_121405 (TS4.5.52)
WTM552A/B/G/H TS050050B_111406 (TS5.0.50B)

Release Notes & Letter of Operational Consideration 4

Touchstone Telephony Firmware - Release 5.0.60

1.6 Product Documentation

Other relevant information is included in the following documentation:
Product
Touchstone® Telephony Modem End User Licensing Agreement (EULA)
Touchstone® Telephony Feature Guide (TS5.0)
Touchstone® Telephony Management Guide (TS5.0)
Touchstone® Telephony Provisioning Guide (TS5.0)
Touchstone® Telephony Troubleshooting Guide (TS5.0)
Touchstone® Telephony Modem 402 Installation Guide
Touchstone® Telephony Modem 402 Quick Installation Guide
Touchstone® Telephony Modem 402 User’s Manual
Touchstone® Telephony Modem 502 Installation Guide
Touchstone® Telephony Modem 502 Quick Installation Guide
Touchstone® Telephony Modem 502 User’s Manual
Touchstone® Telephony Modem 501 Installation Guide
Touchstone® Telephony Modem 501 Quick Installation Guide
Touchstone® Telephony Modem 501 User’s Manual
Touchstone® Telephony Modem 552 User’s Guide

Release Notes & Letter of Operational Consideration 5

Touchstone Telephony Firmware - Release 5.0.60

2 Release Notes
The Release Notes describe the New Product Features introduced in the Touchstone
Firmware for the ARRIS Touchstone Telephony Modem(s) and the Touchstone
Telephony Port(s). Included in the Resolved Product Deficiencies section is a list of
resolved operational considerations noted in previous releases.

2.1 New Product Features

Added in TS5.0.60

Support for @NetHome Monitoring MIB

The TS 5.0.60 release introduces support for the @NetHome-EMTA-MIB-v2.3. These
MIBs are accessible only on the TM402C and the TM502C hardware.

Added in TS5.0.50C
No new features were added in this release.

Added in TS5.0.50B

Support of WTM552
The TS 5.0.50B release introduces support for the new WTM552 wireless hardware
platform. WTM552 provides two lines of telephony service and a wireless router module
with four Ethernet ports and an 802.11B/G wireless access (no USB port).

Added in TS5.0.50

Non-Service Affecting DHCP Operations

Touchstone firmware now provides a feature which can prevent an eMTA IP address
from changing during an active call. This feature has been implemented through the
addition of the arrisCmDevDhcpNoSvcImpact MIB object. Value settings are described
below:

• off(1) – Feature is off by default and DHCP operations adhere to RFC2131

(present operation).
• dontSend(2) – When a line is offhook, DHCP messages from the MTA will be
suppressed and messages from the DHCP server will be ignored until the line
goes onhook or until the IP address lease expires.
• sendIgnore(3) – When a line is offhook, DHCP messages will be sent by the
MTA and messages from the DHCP server will be stored, but not acted on, until
the line goes onhook or until the IP address lease expires.

Release Notes & Letter of Operational Consideration 6

Touchstone Telephony Firmware - Release 5.0.60

CAUTION: ARRIS strongly recommends extremely careful consideration be performed

before choosing to implement the setting “sendIgnore(3)”. Use of this option could
potentially lead to IP address duplication and conflicts in the network.

The TS5.0.50 load will default this object setting to “off(1). In addition to the above
MIB, logs have been added to support this feature and are presented in Section 3.4

CM DHCP Request Message Flag Setting Change

Beginning with this firmware release, CM DHCP REQUEST message used to request the
acceptance of a particular DHCP OFFER from a DHCP server will set the broadcast flag
to unicast instead of the broadcast. This change only affects the DHCP REQUEST
message used to respond to a DHCP OFFER message. DHCP REQUEST messages used
to as port of the DHCP RENEW and DHCP REBIND operations are not affected by this
change.

Behavior Change to Clear Cable Modem Reset Command

Beginning with this firmware release, default behavior to the ‘Clear Cable Modem Reset’
command has been changed. The eMTA now treats this command the same way it
handles an SNMP set of docsDevResetNow MIB (i.e., the CM will perform a full re-
initialization). In previous loads, the CM treated this command the same as a T4 timeout.

TLV-39 MIB Implemented to Control Enabling of DOCSIS 2.0

Operation Mode
Beginning with this firmware release, the DOCSIS TLV-39 has been implemented to
control enabling of DOCSIS 2.0 mode of operation. See Appendix A for flow charts that
detail TLV-39 implementation.

Battery Over-Temperature Alarm and Charger Disabling for TM502

TS5.0.50 release includes two new temperature alarms for only the TM502 hardware.
The first alarm allows the customer to set a provisionable threshold that when reached the
EMTA will generate a “Charger Temperature High” alarm notification. Additionally, the
TS5.0.50 release will disconnect the battery and raise a “Charger OverTemp Shutdown”
alarm when a temperature over 90C is detected. This feature is controlled by the MIBs
under arrisMtaDevPwrSupplyControl table. Please refer to Appendix C for the new
MIBs and Appendix D for the CLI information.

Transmission of DHCP Option Code 51 during DHCP Renew

The TS5.0.50 introduces a new feature to allow MSO’s the ability to control if the
EMTA should include the DHCP Option Code 51 in the DHCPREQUEST message
during IP address renewal operation. This feature is controlled by the MIB object
arrisCmDhcpOption51Override in the CM or the MTA configuration file. Please refer to
Appendix C for the new MIB.

Release Notes & Letter of Operational Consideration 7

Touchstone Telephony Firmware - Release 5.0.60

Checking for SNMP Entity Changes during DHCP Renew

The TS5.0.50 introduces a new feature to allow MSO’s the ability to control if the
EMTA should strictly enforce that the SNMP Entity Option 122/177 suboption 3
parameter be the same for a DHCP Renew/Rebind response from the DHCP server that it
was in the original DHCP Offer. This feature is controlled by including the MIB object
arrisMtaDevDhcpOptionOverride. Please refer to Appendix C for the new MIB.

Dynamic Equalizer Feature

The TS5.0.50 release introduces the Dynamic Equalizer (DEA) feature (Patent Pending)
for the TM50x hardware models. This feature helps to improve Bit Error Rate
performance and improve initial lock on a downstream signal with large impairments. A
new MIB object has been added to enable operators to turn the DEA feature on or off.
The default value for this feature is on. Please refer to Appendix C for the new MIB.

Downstream Frequency Scanning Enhancements

The TS5.0.50 introduces an enhancement to the Downstream Frequency Scanning
Algorithm for North American DOCSIS customers. The new scanning algorithm will
check for round number frequencies (e.g. 702000000, 601000000, 505000000, etc…)
earlier in the scanning process. This will result in faster installation times for those
customers that are using North American DOCSIS and not utilizing the Standard or HRC
frequency plans but adheres to a round frequency scheme.

New Poland Line Card Template

The TS5.0.50 release introduces a new Poland line card template. This new template can
be selected by setting the ppCfgMtaCountryTemplate MIB parameter to “Poland1010”
(Country Code Value = 30). The linecard template is identical to the Poland template
with the exception of the following items:

• The Tx and Rx loss values are both set to 10 dB.

• HookFlashMin setting is changed to be 70 ms.
• HookFlashMax setting is changed to be 250 ms.

Additionally, all tone definitions for this template are identical to the existing Poland
country code template.

TM502 Hook Detection Hysteresis Changes

The TS5.0.50 release introduces Hysteresis with regards to detecting on-hook and off-
hook conditions. This change reduces the possibility of potential faults causing on-
hook/off-hook oscillations. Note: This addition only applies to the TM502 hardware
models.

New Loop Diag Demo CLI Command

Release Notes & Letter of Operational Consideration 8

Touchstone Telephony Firmware - Release 5.0.60

The TS5.0.50 release adds a new CLI command in the “Linecard” menu. The new
command is called ‘lpdemo’ and allows the user to run loop diags when the modem is not
ranged and registered. Please refer to Appendix D for the new CLI command.

New ARRIS Device Parameters MIB

The TS5.0.50 release adds the new MIB arrisMtaDevParameters to provide access to
several pieces of network type data. Please refer to Appendix C for the new MIBs

Retaining Reversed Modem Tone Detection Mode Settings over

Reboots
The TS5.0.50 release contains a change for reversed modem tone detection mode setting
persistence. If the reversed modem tone detection mode is set through SNMP, then this
value will be persistent over reboots.

Updated Line Card State MIB Object

The TS5.0.50 release contains an additional update to the arrisMtaDevLineCardState
MIB object to remove line card states that are no longer supported.
The TS5.0.50 release has updated this MIB object definition as follows:
OOS (0),
IDLE (1),
ADDRESSING (2),
TALKING (3),
FRWD DISC (5),
RINGING (6),
ONHOOK TX (7),
PLO (14)

Added in TS5.0.26

Loop Diagnostics WebGUI Support

Beginning with this firmware release, the Loop Diagnostics feature to remotely
troubleshoot in-house wiring problems may now be invoked from the ARRIS Advanced
Web Page. From this interface the operator has the option of executing diagnostics even
when the phone is off-hook and a voice call is established. Please refer to the
Touchstone Release 5.0 Troubleshooting document for detailed instructions on using this
feature via the WebGUI.

Release Notes & Letter of Operational Consideration 9

Touchstone Telephony Firmware - Release 5.0.60

Loop Diagnostics Support for TM502

The Loop Diagnostic Feature is now supported on the TM502 models via SNMP, CLI
and WebGUI interfaces. Please refer to Appendix C for the details on the new MIBs for
initiating Loop Diagnostics via SNMP, and Appendix D for details on CLI commands.

Ability to Suppress FQDN and IP Address in Webpage Event Logs

New functionality has been added to allow the MSO to suppress the printing of FQDN
and IP address information in the event log when viewed via the WebGUI interface. This
feature is controlled by the MIB arrisMtaDevEventHideFQDNandIPAddress. Please
refer to Appendix C for the new MIBs.

Different SIP Proxy per Line

Added functionality to support a different SIP proxy per line for customers that use a
“multi-homed” provisioning setup. This can be accomplished by adding in extra
provisioning information to the sipCfgPortEntry MIB table. Please refer to Appendix C
for the new MIBs.

SIP Feature Customization via Configuration File

Added a new MIB object sipCfgPortFeatureSettings for customization of SIP feature
content via the configuration file at boot time, including the ability to disable CallerID,
Call Waiting, 3WCing, and enable anonymous call rejection. Please refer to Appendix C
for the new MIBs.

Server Lookup Support for SIP Proxy Server Addresses

Touchstone firmware can now support server (SRV) lookup for SIP proxy server
addresses by setting a bit in the SIP feature switch MIB. Please refer to Appendix C for
the new MIBs.

Single-Step MTA Upgrade from NCS to SIP

Touchstone firmware can now support a single-step upgrade when converting from an
NCS network to a SIP network by treating all SIP provisioning methods as “DOCSIS-
only” for all non-SIP loads.

Added in TS5.0.10

Loop Diagnostics
Touchstone Release 5.0 introduces a new feature that enables MSO’s to remotely
troubleshoot in-house wiring problems. This feature is referred to as Loop Diagnostics,
and is supported on the TM402x and TP40x models via SNMP and CLI. Please refer to

Release Notes & Letter of Operational Consideration 10

Touchstone Telephony Firmware - Release 5.0.60

Appendix C for the new MIBs for Loop Diagnostics and Appendix D for the CLI
information.

G.729/DTMF Relay Support

Touchstone Release 5.0 includes support for the G.729 codec and DTMF Relay
capability. This includes the ability to revert to the G.711 codec during fax and modem
calls.

Automatic Telnet Session Time-out

Touchstone Release 5.0 introduces a new security and robustness enhancement for telnet
and Secure Shell debugging session that is enabled for an indefinite amount of time, thus
potentially allowing unauthorized access to this interface. TS 5.0 release adds a MSO-
configurable session timeout feature that can be used to automatically disable a telnet or
Secure Shell session. Please refer to Appendix C for the new MIB and Appendix D for
the CLI information.

Webpage Display of Loop Current Mode

Touchstone firmware releases prior to TS 5.0 provided a MIB object which controlled the
setting of the EMTA loop current to either Normal or Boost modes. To determine how
the loop current mode was set, a craftsperson had to have SNMP access to this MIB
object. In TS 5.0, the line card current mode is now available on the “CallP/QoS”
webpage as well as in a new CLI command. Please refer to Appendix D for the CLI
information.

Ability to Obtain Line Card Status via SNMP

Touchstone Release 5.0 adds a new arrisMtaDevLineCard MIB object under
arrisMtaDevMibObjects so that a craftsperson can obtain the line card status of an
EMTA via SNMP. In the previous releases, the line card status was only available via
the webpage and through a CLI command. Please refer to Appendix C for the new MIB.

Periodic Time of Day Re-synchronization

DOCSIS specification requires a device to acquire the time of day from an RFC868-
compliant Time of Day server during initialization. However, there is no requirement to
ever update the time of day with this server after initial registration. Over time, this
could lead to a difference in the time of day value on a device versus the time of day in
the network. TS 5.0 introduces a new feature to allow an MSO to have the ARRIS
EMTA automatically resynchronize this time value. Please refer to Appendix C for the
new MIB and Appendix D for the CLI information.

Release Notes & Letter of Operational Consideration 11

Touchstone Telephony Firmware - Release 5.0.60

Retaining Loop Current Mode Settings over Reboots

Touchstone Release 5.0 contains a change for loop current mode setting persistence. If
the loop current mode is set through SNMP, then this value will be persistent over
reboots.

Querying DHCP Information via SNMP

Touchstone Release 5.0 introduces a new read-only MIB objects that can be queried to
obtain the both CM’s and MTA’s DHCP information. This information was previously
only available through webpages and CLI commands. Please refer to Appendix C for the
new MIBs.

Blocking PacketCable Provisioning When TOD Server Does not

Respond
Touchstone Release 5.0 includes a new feature that allows the MSO to block EMTA
provisioning attempts when a network’s Time of Day server fails to respond. For
networks deploying full PacketCable secure provisioning, this feature can be used to
significantly reduce network congestion caused by recurring EMTA provisioning
failures. By adding a value of 0x200 to the MIB, ppCfgMtaFeatureSwitch, this
functionality will be enabled.

Line Card State Display Changes

Touchstone Release 5.0 includes changes to the EMTA’s CallP/QOS webpage’s CallP
Table to remove line card states that are no longer supported.
The new table supported on the webpage is:
"OOS ", //0x00
"IDLE ", //0x01
"ADDRESSING ", //0x02
"TALKING ", //0x03
"", //0x04
"FRWD DISC ", //0x05
"RINGING ", //0x06
"ONHOOK TX ", //0x07
"TIP OPEN ", //0x08
"", //0x09
"", //0x0A
"TRUNK C ", //0x0B
"PROTECTION ", //0x0C

Release Notes & Letter of Operational Consideration 12

Touchstone Telephony Firmware - Release 5.0.60

"DIAGS ", //0x0D

"PLO ", //0x0E

The obsolete table removed from the webpage:

"", //0x00
"IDLE ", //0x01
"ADDRESSING ", //0x02
"TALKING ", //0x03
"", //0x04
"DISCONNECT ", //0x05
"RING ", //0x06
"PLAYVMWI ", //0x07
"TIPOPEN ", //0x08

Release Notes & Letter of Operational Consideration 13

Touchstone Telephony Firmware - Release 5.0.60

2.2 Resolved Product Deficiencies

ARRIS continues to resolve any product deficiencies discovered. This Touchstone
Firmware release contains closure for the detailed issues listed in the following section.
Considerations that apply to a specific feature implementation will be designated with
one of the following prefixes included in the heading:
• X-JC : Japan experimental NCS package
• EU : European Provisioning Sequence
• SIP : SIP Call Sequence
• T.38 : T.38 Feature Specific Issue
• SSH : Secure Shell
The following issues were resolved in release 5.0.60

2.2.1 MTA does not Generate NCS Error for Incorrect Digit Map
Tracking No. PROD00092843
Description Customer reported that the MTA did not send up a “510
Protocol Error” for an incorrectly formatted Digit Map sent
from the CMS.
Impact Potential Service (depending on digit map error)
Occurrence High
Affected loads Prior to 5.0.60

2.2.2 Local Log contains Duplicate Battery Test-In Progress

Log
Tracking No. PROD00092601
Description On initial power-up or reset Local Event Log (viewable on the
Web-GUI), it will contain a duplicate Battery Test-In Progress
log. This is a one time event and will not be seen during
normal operation.
Impact Operational
Occurrence Low
Affected loads Prior to 5.0.60

Release Notes & Letter of Operational Consideration 14