Hamshack Hotline Wiki

(Author: Dominic / AD8AK / Ext: 5500416)

How to get a Cisco 7961 (and possible other 79xx series) to provision on HH.

This guide is a work in progress and feedback is welcome.

If your phone already has the SIP firmware install, skip to step 2

If your phone does not have the SIP firmware, continue to step 1

• Download and install a TFTP server of your choice

• Download the firmware from: Here

• Unzip these into your TFTP folder

• From here there’s a few ways to proceed. The most straightforward way is to plug the phone directly into your TFTP server temporarily to upgrade your firmware.

• First, open UDP port 69 from to the address of your TFTP server (if you’re unaware how to do this, consult your router’s manual)

• Unplug your phone. Hold the * (Star) button for 60 second as you plug the phone back in. When the lights begin flashing orange, proceed.

• Release the * (Star) button, and dial 123456789*0#. THIS WILL FACTORY RESET THE PHONE.
  The line buttons will flash red, and it will begin to upgrade your phone to the SIP firmware.

• Once complete, the phone will show “Unprovisioned”. You are now ready to proceed to step 2.

• Create a text based provision file using the code found at the bottom of this article.

• Open the file, and edit the following information:

• #TIMEZONE#: Your time zone

• #CALLSIGN#: Your callsign

• #EXTENSION_NUM#: Your extension number

• #HAMSHACK_HOTLINE_PASSWORD# : Your HHUX password

• #FIRMWARE_FILE_NAME#: The firmware LOADS file you have on your phone

• Once edited, rename the file your yourmacaddress.cnf.xml

• Stop the TFTP server, and place this file into your TFTP server folder

• Plug your phone into your router or switch and power it on

• Once booted, press settings →2 →1 →17. Next, press **# (Star Star Pound) to unlock settings.

• Press edit on the TFTP server. Enter your TFTP server address (using a static IP is highly recommended). Then press validate, then save.

• Start the TFTP server. Your phone should start pulling the new files. If this doesn’t happen, reboot the phone (you may need to repeat previous steps to configure TFTP settings)

• Your phone should now have the correct files to provision to HHUX. Proceed to step 4 for router configuration.

• These next step will vary based on your networks capabilities, configuration, and your ISP.

• What worked for me: Cisco phone on DMZ, on a VPN using port 5060, with SIP ALG enabled.
  (Sometimes SIP ALG may need to be set to Disabled)

You will need to create a text based provisioning file for your phone.

Below is what the contents of that file should contain.

<!--
Hamshack Hotline example configuration file for Cisco 7961G
For instructions, please refer to the wiki.
-->
<device>
    <deviceProtocol>SIP</deviceProtocol>
    <sshUserId>cisco</sshUserId>
    <sshPassword>cisco</sshPassword>
    <ipAddressMode>0</ipAddressMode>

    <devicePool>
        <dateTimeSetting>
            <dateTemplate>D/M/Ya</dateTemplate>
            <timeZone>#TIMEZONE#</timeZone>
            <ntps>
                <ntp>
                    <name>129.6.15.28</name>
                    <ntpMode>Unicast</ntpMode>
                </ntp>
            </ntps>
        </dateTimeSetting>

        <callManagerGroup>
            <members>
                <member priority="0">
                    <callManager>
                        <ports>
                            <ethernetPhonePort>2000</ethernetPhonePort>
                            <sipPort>5060</sipPort>
                        </ports>
                        <processNodeName>hhux.hamshackhotline.com</processNodeName>
                    </callManager>
                </member>
            </members>
        </callManagerGroup>
    </devicePool>

    <sipProfile>
        <sipProxies>
            <registerWithProxy>true</registerWithProxy>
        </sipProxies>
        <sipCallFeatures>
            <cnfJoinEnabled>true</cnfJoinEnabled>
            <rfc2543Hold>false</rfc2543Hold>
            <callHoldRingback>2</callHoldRingback>
            <localCfwdEnable>true</localCfwdEnable>
            <semiAttendedTransfer>true</semiAttendedTransfer>
            <anonymousCallBlock>2</anonymousCallBlock>
            <callerIdBlocking>2</callerIdBlocking>
            <dndControl>0</dndControl>
            <remoteCcEnable>true</remoteCcEnable>
        </sipCallFeatures>

        <sipStack>
            <sipInviteRetx>6</sipInviteRetx>
            <sipRetx>10</sipRetx>
            <timerInviteExpires>180</timerInviteExpires>
            <timerRegisterExpires>3600</timerRegisterExpires>
            <timerRegisterDelta>5</timerRegisterDelta>
            <timerKeepAliveExpires>3600</timerKeepAliveExpires>
            <timerSubscribeExpires>3600</timerSubscribeExpires>
            <timerSubscribeDelta>5</timerSubscribeDelta>
            <timerT1>500</timerT1>
            <timerT2>4000</timerT2>
            <maxRedirects>70</maxRedirects>
            <remotePartyID>true</remotePartyID>
            <userInfo>None</userInfo>
        </sipStack>

        <autoAnswerTimer>1</autoAnswerTimer>
        <autoAnswerAltBehavior>false</autoAnswerAltBehavior>
        <autoAnswerOverride>true</autoAnswerOverride>
        <transferOnhookEnabled>false</transferOnhookEnabled>
        <enableVad>false</enableVad>
        <preferredCodec>g711ulaw</preferredCodec>
        <dtmfAvtPayload>101</dtmfAvtPayload>
        <dtmfDbLevel>3</dtmfDbLevel>
        <dtmfOutofBand>avt</dtmfOutofBand>
        <alwaysUsePrimeLine>false</alwaysUsePrimeLine>
        <alwaysUsePrimeLineVoiceMail>false</alwaysUsePrimeLineVoiceMail>
        <kpml>3</kpml>
        <natEnabled>false</natEnabled>
        <phoneLabel>#CALLSIGN#</phoneLabel>
        <stutterMsgWaiting>0</stutterMsgWaiting>
        <callStats>false</callStats>
        <silentPeriodBetweenCallWaitingBursts>10</silentPeriodBetweenCallWaitingBursts>
        <disableLocalSpeedDialConfig>false</disableLocalSpeedDialConfig>
        <startMediaPort>10000</startMediaPort>
        <stopMediaPort>20000</stopMediaPort>

        <sipLines>
            <line button="1">
                <featureID>9</featureID>
                <featureLabel>#EXTENSION_NUM#</featureLabel>
                <proxy>hhux.hamshackhotline.com</proxy>
                <port>5060</port>
                <name>#EXTENSION_NUM#</name>
                <displayName>#CALLSIGN#</displayName>
                <autoAnswer>
                    <autoAnswerEnabled>2</autoAnswerEnabled>
                </autoAnswer>
                <callWaiting>3</callWaiting>
                <authName>#EXTENSION_NUM#</authName>
                <authPassword>#HAMSHACK_HOTLINE_PASSWORD#</authPassword>
                <sharedLine>false</sharedLine>
                <messageWaitingLampPolicy>1</messageWaitingLampPolicy>
                <messagesNumber>*97</messagesNumber>
                <ringSettingIdle>4</ringSettingIdle>
                <ringSettingActive>5</ringSettingActive>
                <contact>#EXTENSION_NUM#</contact>
                <forwardCallInfoDisplay>
                    <callerName>true</callerName>
                    <callerNumber>true</callerNumber>
                    <redirectedNumber>false</redirectedNumber>
                    <dialedNumber>true</dialedNumber>
                </forwardCallInfoDisplay>
            </line>

        </sipLines>

        <voipControlPort>5060</voipControlPort>
        <dscpForAudio>184</dscpForAudio>
        <ringSettingBusyStationPolicy>0</ringSettingBusyStationPolicy>
        <dialTemplate>dialplan.xml</dialTemplate>
    </sipProfile>

    <commonProfile>
        <phonePassword></phonePassword>
        <backgroundImageAccess>true</backgroundImageAccess>
        <callLogBlfEnabled>1</callLogBlfEnabled>
    </commonProfile>

    <loadInformation>#FIRMWARE_FILE_NAME#</loadInformation>
    <vendorConfig>
        <disableSpeaker>false</disableSpeaker>
        <disableSpeakerAndHeadset>false</disableSpeakerAndHeadset>
        <pcPort>0</pcPort>
        <settingsAccess>1</settingsAccess>
        <garp>0</garp>
        <voiceVlanAccess>0</voiceVlanAccess>
        <videoCapability>0</videoCapability>
        <autoSelectLineEnable>0</autoSelectLineEnable>
        <webAccess>0</webAccess>
        <spanToPCPort>1</spanToPCPort>
        <loggingDisplay>1</loggingDisplay>
        <loadServer></loadServer>
        <sshAccess>0</sshAccess>
    </vendorConfig>

    <versionStamp>001</versionStamp>
    <networkLocale>United_Kingdom</networkLocale>
    <networkLocaleInfo>
        <name>United_Kingdom</name>
        <uid>64</uid>
        <version>1.0.0.0-4</version> 
    </networkLocaleInfo>

    <deviceSecurityMode>1</deviceSecurityMode>
    <authenticationURL></authenticationURL>
    <servicesURL></servicesURL>
    <transportLayerProtocol>2</transportLayerProtocol>
    <certHash></certHash>
    <encrConfig>false</encrConfig>
    <dialToneSetting>2</dialToneSetting>
</device>