PIKA WARP the Appliance User Guide
Contents
1. PIKA TECHNOLOGIES INC PIKA WARP the Appliance 2 0 User Guide Copyright c 2009 All rights reserved PIKA WARP the Appliance 2 0 Table of Contents 1 Copyright Information 1 2 Contacting PIKA Technologies 2 3 Introduction 3 3 1 Related Documents 4 4 Getting Started Hardware Installation 5 5 Telephony Interfaces 9 6 Getting Started System Configuration 12 6 1 Logging in to the Appliance 12 6 2 Network Setup 13 7 Making Asterisk Calls 16 8 Asterisk Configuration Using the Asterisk GUI 19 9 Advanced Configuration 28 10 Software Upgrade 34 11 Hardware Information 35 11 1 Hardware Reset 35 11 2 LCD 35 11 2 1 BRI Link State Display 36 7 9 2009 2 0 6 15 User Guide Page iii PIKA WARP the Appliance 2 0 11 3 Using an SD Card 11 4 Using the USB Port 11 5 Power Failure Transfer 11 6 Thermal Management 11 7 Wall Mounting 12 Troubleshooting 13 Hardware and Software Specifications Index Page iv User Guide 37 39 40 40 41 42 44 7 9 2009 2 0 6 15 Copyright Information COPYRIGHTS Copyright 2009 PIKA Technologies Inc TRADEMARKS PIKA is a registered trademark of PIKA Technologies Inc All other trademarks product names and company names and or logos cited herein if any are the property of their respective holders DISCLAIMER This document is provided to you for informational purposes only and is believed to be accurate as of the date of its publication and is subject to chan2. appliance should be mounted with the LCD at the top and not mounted sideways otherwise the unit will be unstable The following image shows the slots used to hang the unit on the screws that are inserted into the wall The screw heads must protrude 5 16 from the wall The wall mounting template can be found at www pikatechnologies com appliancedownloads NOTE When printing the template page scaling in the print menu on Adobe should be set to none 7 9 2009 2 0 6 15 User Guide Page 41 Troubleshooting Additional information can be found in the FAQ and Troubleshooting sections on the PIKA Technologies web site http www pikatechnologies com appliancedownloads Voicemails are distorted when sent to var spool asterisk If this occurs within the number of simultaneous calls specified in performance benchmarks configure Asterisk to send voice mails to an SD card as described in Advanced Configuration pg 28 Analog Ports are Locked and or Asterisk Won t Start Ensure that your analog modules are compatible with your FPGA version Analog modules Rev A 02 or earlier and FPGA version 2 0 2 2 or later are not compatible Errors such as those below may appear at the serial console taco FPGA 00212019 Modules A FXO B FXS 1 FXO 3 Bad silabs rev 14 1 FXO 4 Bad silabs rev 4 taco FPGA 00212019 Modules A FXO B FXS 1 FXO 3 Bad silabs rev 4 1 FXO 4 Bad silabs rev 4 Asterisk may restart continuously showing the following me
3. IP address will be displayed on the LCD Network Settings in the PADS User Manual describes more detailed information about the network information settings The additional information in this section is important when configuring the appliance for software development Page 14 User Guide 7 9 2009 2 0 6 15 6 2 Network Setup PIKA WARP the Appliance 2 0 More advanced configuration changes for both the appliance itself and Asterisk are described in section Advanced Configuration pg 28 These sections assume that the standard software packages are installed on the appliance To customize the appliance software refer to the PADS User Manual 7 9 2009 2 0 6 15 User Guide Page 15 Making Asterisk Calls Once you have completed your network configuration you are ready to make calls using Asterisk For your first call on the appliance it is recommended that you connect a standard phone set into the built in green FXS port and dial 600 This will connect you to the Asterisk echo test recording and will guide you through a set of audio prompts for the play and record functions in Asterisk The following table lists some default Asterisk extensions that you may find useful Extension Purpose Destination Asterisk echo test recording Asterisk demo congratulations recording Voice mail setup Attempts an IAX connection to a Digium server This will only work if you have provisioned IAX trunks in Asterisk they are not configured by defa
4. Menu 38 Incoming Calls Define how your incoming calls should be handled amp configure DID Direct inward Dialing Add an Incoming Rule X Active Channels This screen shows call activity on channels of the appliance The example below shows a call in progress on analog FXS channel 3 and indicates the dial plan used to route the call Page 26 User Guide 7 9 2009 2 0 6 15 PIKA WARP the Appliance 2 0 22 Home Active Channels oo Users Transfer Hangup s9 Conferencing lt unknown gt 74007 fxs 1 PIKAIdigital 1 PIKAIS 4 29 Service Providers 74007 None PIKAKS 4 PIKAIdigital 1 as BRI Config PIKAldigital 3 Up lt unknawn gt s macro stdexten 1 SIP 4007 103c1ec0 s2 Calling Rules SIPi4007 103clecO Up 4007 None PIKAIdigital3 38 Incoming Calls 28 Voice Menus aa Call Parking ag Ring Groups 29 Active Channels Monitor active analog channels Activate Changes Move the mouse over to a field to see tooltips TEL so Asterisk CLI ag Options 7 9 2009 2 0 6 15 User Guide Page 27 PIKA WARP the Appliance 2 0 9 Advanced Configuration To further customize your configuration you will need to access the appliance either through SSH or a serial connection Refer to Logging in to the Appliance pg 12 for information Configuring the Appliance for BRI If there are one or more BRI modules present BRI interfaces are configured upo
5. Point Public Telephone Switch PBX Ss Interface BRI sS Interface NT 1 Point to MultiPoint Public Telephone Switch a S Interface BRI Other Endpoint 7 9 2009 2 0 6 15 User Guide Page 11 PIKA WARP the Appliance 2 0 6 1 Logging in to the Appliance Getting Started System Configuration PIKA WARP the Appliance for Asterisk is shipped with the necessary software installed to function as an Asterisk PBX Refer to section Hardware and Software Specifications pg 44 for more details The major software components on the system include e Linux operating system with appliance specific modifications PIKA HMP drivers to support the appliance hardware e Asterisk PBX software e Web based Asterisk GUI to configure Asterisk e PIKA Asterisk channel driver to support the appliance hardware with Asterisk e Software utilities including SSH and NTP The appliance is ready to use when the system finishes booting this will take up to thirty seconds After configuring your network settings the system is ready to make Asterisk calls The next sections describe how to log in to the appliance and configure the appliance for access from your network Logging in to the Appliance There are two ways to log in to the appliance e using SSH e via the serial console The appliance ships with a root user account and the corresponding password is pikapika Using SSH Use an SSH client to open a session to the IP address of
6. The file etc networking conf on the appliance contains the information required to configure the appliance for use on your network The initial contents of this file based on the preset factory defaults are Default Warp network configuration HH IP_LAN IP address to configure on the network interface IP_LAN 192 168 1 80 Ht NETMASK_LAN Netmask to configure on the network interface relative to IP_LAN 7 9 2009 2 0 6 15 User Guide Page 13 PIKA WARP the Appliance 2 0 6 2 Network Setup NETMASK_LAN 255 255 255 0 HH GATEWAY_LAN IP Address of the default route GATEWAY_LAN 192 168 1 1 HH HH DHCP_LAN Use dhcp to configure networking IP_LAN must not be set for DHCP_LAN yes to be honored yes no DHCP_LAN no Ht DNS_LAN IP address of the DNS server to use DNS_LAN 192 168 1 1 Ht HOSTNAME Name under which this host should be known HOSTNAME warp You may add an optional entry no default is present to enter the domain for your LAN such as yourcompany com DOMAIN_LAN Change the values as appropriate for your network configuration When you have finished entering the necessary information enter the command reboot at the Linux prompt on the appliance to reset the appliance to enable your configuration changes You can now reconnect your PC back to your local network and then reboot to return to your normal network settings Once the appliance has finished rebooting the new
7. analog ports a built in FXS port and eight additional ports using four port FXS and FXO daughter boards in any combination that plug in to the base board The appliance also supports up to four BRI ports maximum 8 possible channels using two port BRI daughter boards The Ethernet port provides support for VoIP stations and trunks The Appliance for Asterisk uses PIKA s HMP Host Media Processing software for analog and BRI support The Asterisk software and PIKA s Channel Driver for Asterisk provide analog BRI and IP PBX support The Asterisk GUI software can be used from any standard web browser to configure the appliance for use with Asterisk Key Features e AMCC Power PC 440EP Embedded Processor e 10 100BT Ethernet port e 256 Megabytes of RAM e One USB 1 1 host port e One FXS port with every unit e Two module expansion bays e Modules available can be installed in any combination 4 port FXS module 4 port FXO module e 2 port BRI module e An RJ 11 power failure transfer jack is available on each four port analog module e Audio in Audio out jacks for music on hold and paging functions e Externally removable SD flash memory card e 40 character image 2 x 20 reversible LCD backlit display with toggle button API controlled e Reset Button e External brick format universal power supply e Surface standalone stackable or wall mountable to accommodate any space requirements 7 9 2009 2 0 6 15 User Guide Page 3 PIKA WARP the Applia
8. not present the call will be routed to voice mail These extensions call the sample SIP Agents defined in sip conf If the SIP agent associated with the extension is not registered the call will be routed to voice mail PIKA FAX receive test Connect a FAX machine to one of the FXS ports dial this extension and the appliance will receive the FAX A tiff file will be stored in tmp warpfax PIKA FAX transmit test Connect a FAX machine to one of the FXS ports dial this extension and the appliance will send a test FAX the PIKA logo to your FAX machine Calls out on an available FXO trunk If no FXO trunks are available congestion will be received Calls out on an available BRI trunk If no BRI trunks are available congestion will be received Note Voice mail passwords for extensions 4001 through 4010 are 1234 The PIKA FAX application has been enabled for both FXO and FXS lines If FAX tones are detected on any analog line a call is automatically placed to extension 4060 to receive the FAX For more information about the PIKA FAX application please visit http www pikatechnologies com asterisk 7 9 2009 2 0 6 15 User Guide Page 17 PIKA WARP the Appliance 2 0 7 Port Numbering Provisioning versus LCD On the LCD ports are numbered sequentially one through nine regardless of the module type inserted into the module bay When phones and trunks are provisioned in Asterisk configuration files ports are numbered sequent
9. the appliance which is displayed on the LCD When logging in for the first time use IP address 192 168 1 80 Enter the user name and password at the prompts Using the Serial Console Connect a serial cable as described in section Configuring Serial Access in the PADS User Guide Enter the user name and password at the prompts Page 12 User Guide 7 9 2009 2 0 6 15 6 2 Network Setup PIKA WARP the Appliance 2 0 After logging in to change the root password for the appliance enter the following at the Linux command prompt on the appliance passwd root Follow the prompts to enter and confirm the new password Password information is preserved across reboots Network Setup In order to access the appliance from your network you will need to enter some additional information You will need an IP address that is valid on your local network as well as information about your local network configuration to complete this step Connect one end of a standard network cable to the NIC port on the appliance Connect the other end of the cable to the NIC port on a regular PC running Linux The default IP address of the appliance is 192 168 1 80 Enter the following Linux commands on the PC connected to the appliance These commands will change the PC s IP address to one on the 192 168 1 sub network and configure it for a point to point connection with the appliance ifconfig ethO down ifconfig ethO pointopoint 192 168 1 81 ifconfig ethO up
10. 2 1 4 21 2 1 0 Page 46 User Guide 7 9 2009 2 0 6 15 14 Index Advanced Configuration 28 Asterisk Configuration Using the Asterisk GUI 19 BRI Link State Display 36 Contacting PIKA Technologies 2 Copyright Information 1 Getting Started Hardware Installation 5 Getting Started System Configuration 12 Hardware and Software Specifications 44 Hardware Information 35 Hardware Reset 35 Introduction 3 LCD 35 Logging in to the Appliance 12 Making Asterisk Calls 16 7 9 2009 2 0 6 15 PIKA WARP the Appliance 2 0 Network Setup 13 Power Failure Transfer 40 Related Documents 4 Software Upgrade 34 Telephony Interfaces 9 Thermal Management 40 Troubleshooting 42 Using an SD Card 37 Using the USB Port 39 Wall Mounting 41 User Guide Page a
11. 7 9 2009 2 0 6 15 9 PIKA WARP the Appliance 2 0 e values e client default value indicates a TE device e network indicates an NT device The following example shows the settings for the first soan on a board It is configured as a TE device in a point to point configuration BRI_25800717_0 interface board1 0 networkconfig pp switchtype etsi countrycode europe line_compandmode alaw node client numbertype national numberplan isdn channelselect exclusive endpoint true addsolEEnd false resetChidExtensionBit false enableT309 true permanentActivation false The following example shows the settings for the second span on a board It is configured as an NT ina point to multi point configuration BRI_25800717_ 1 interface board1 1 networkconfig pmp switchtype etsi countrycode europe line_compandmode alaw node network numbertype national numberplan isdn channelselect exclusive endpoint true addsolEEnd false resetChIidExtensionBit false enableT309 true permanentActivation false Asterisk must be restarted for the configuration changes to take effect 7 9 2009 2 0 6 15 User Guide Page 29 PIKA WARP the Appliance 2 0 9 Configuring the PIKA Asterisk Channel Driver The channel driver is a specialized piece of software that enables Asterisk to use the appliance hardware It is included as part of the standard software shipped with the appliance The configuration file for the software is generated at startup time based
12. Parking a8 Ring Groups PIKA WARP the Appliance 2 0 Welcome to the Asterisk Configuration Panel Asterisk Configuration Engine Username Password V Connected Activate Changes Move the mouse over to a field to see tooltips Users The Users screen is shown below The default FXS and SIP extensions described in section Making Asterisk Calls pg 16 are shown in the center panel Note that the extensions for the FXS ports are present regardless of whether the appliance has an FXS module installed Fields for a selected user extension can be modified from this screen Existing extensions can be deleted and new users can be added 7 9 2009 2 0 6 15 User Guide Page 21 so Home a9 Users Users is a short cut for quickly adding and removing all the necessary configuration components for any new phone sa Conferencing 33 Voicemail oo Service Providers 38 BRI Config sg Calling Rules 28 Incoming Calls a9 Voice Menus sg Call Parking 88 Ring Groups 28 Active Channels so Asterisk CLI ag Options Service Providers User and Phone Configuration User Extensions 4001 Pika fxs1 4002 Pika fxs2 4003 Pika fxs3 4004 Pika fxs4 4005 Pika fxs5 4006 Sip1 4007 Sip2 4008 Sip3 4009 Sip4 4010 Sip5 providers can be added PIKA WARP the Appliance 2 0 8 Activate Changes Move the mouse over to a field to see tooltips Extension Name Passw
13. Software Specifications Chassis Overview Top View Rear View USB port Page 44 User Guide 7 9 2009 2 0 6 15 PIKA WARP the Appliance 2 0 Base Board Processor AMCC Power PC 533 MHz Flash 4MB NOR 256 MB NAND RAM 256 MB DDR SDRAM Rear accessible removable storage e SD card Network Interface e 10 100BT Ethernet port USB 1 1 Ports one rear accessible Audio Line In Out Ports 3 4 KHz audio quality FXS port e 48 Volt ringing Form Factor 8 780 W x 2 026 H x 6 585 D e Stackable or wall mountable Power Requirements e 12 Volts DC 2 A NOTE The LPS power supply provided must be used with the appliance as per safety regulations Externat uss Stave Interface Externat Masti er aaa Interface AMCC Uart NAND SORAM Comtrotier Ctrl NAND lash N F R3232 7 9 2009 2 0 6 15 User Guide Page 45 PIKA WARP the Appliance 2 0 13 Refer to the PIKA WARP the Appliance Hardware Manual for more details Software Specifications The following table lists the versions of the major components included in the factory default software of the appliance Refer to Software Package Information for complete details Component Version Linux kernel with appliance specific modifications 2 6 26 5 PIKA HMP drivers and SDK 2 7 X PIKA GrandPrix SDK 2 7 X PIKA Asterisk channel driver 3 6 x 1 4 9
14. WARP the App Calling Rules liance 2 0 Activate Changes List of DialPlans new DialPlanl delete Allow Parked Calls Move the mouse over to a field to see tooltips m List of Calling Rules in the selected DialPlan Add a Calling Rule S No RuleName Dial Pattern Call Using Options 1 default Begins with 9 and followed by 2 or Ports fxo txo Edit Delete more digits 12 fxol3 fxol4 2 bri_defautt Begins with 7 and followed by 2 or Ports Edit Delete more digits digital 2 3 4 Incoming Calls This screen defines how incoming calls are routed A default rule is provided which routes incoming calls from the the FXO or BRI ports of the appliance to the default voice menu extension if the digits do not match any existing extension Note that this calling rule will be shown regardless of whether there is an FXO or BRI module 7 9 2009 2 0 6 15 installed User Guide Page 25 PIKA WARP the Appliance 2 0 8 so Home Move the mouse over to a field to see tooltips oo Users a9 Conferencing Incoming Call Rules 2a Voicemail S No Incoming Rule Options a8 Service Providers 1 Route all unmatched incoming calls from provider Ports fxoM fxo 2 fxo Edit Delete j 7 13 fxo 4 to 4999 Yoice Menu 2 BRI Config 2 Route incoming calls from provider Ports digital 2 3 4 that match pattern Edit Delete a a a9 Calling Rules exten _X to 4999 Yoice
15. ar power socket on the appliance and plug the other end into your AC electrical outlet The appliance s auto sensing power supply can be plugged into either 110V or 220V electrical service A zip tie can be used as shown to secure the power cable to the appliance chassis to prevent accidental disconnection Page 6 User Guide 7 9 2009 2 0 6 15 4 PIKA WARP the Appliance 2 0 Audio In Out Ports The appliance provides one line in and one line out port which deliver telephony audio quality The line in port can receive audio from an external source for example an MP3 player a CD player or FM radio The external audio is typically used for music on hold Line out allows a live person or pre recorded message to be played outside the system for example to a paging system Standard 3 5 mm audio jack cables should be used with the audio ports Network Connection Connect one end of a standard network cable to the NIC port on the appliance as shown below Refer to section Network Setup pg 13 for details about configuring the appliance for network access 7 9 2009 2 0 6 15 User Guide Page 7 PIKA WARP the Appliance 2 0 4 Page 8 User Guide 7 9 2009 2 0 6 15 5 PIKA WARP the Appliance 2 0 5 Telephony Interfaces FXS FXO Port Connections The FXS Foreign eXchange Subscriber interface is the port that delivers battery current ring voltage and dial tone to the phones Phones are plugged into FXS ports The wall jack wh
16. ard Note that if any applications have files open on the SD e g Asterisk the applications must be stopped first umount mnt sd Refer to the ext2 File System Utilities section in the PADS User Guide for instructions to format the card for an ext2 file system Refer to section File System Layout in the PADS User Guide for instructions to change the default file system type e g from ext2 to FAT SD cards with a capacity of up to 4 GB are compatible The following SD cards are recommended for use with the appliance e SanDisk SDSDB 2048 2 GB e SanDisk SDSDB 4096 4 GB e HP L1876A 1 GB e PNY SD M01G 1 GB e Lexar 2 GB Using the USB Port The USB port 1 1 compliant can be used for logging auto flashing the appliance during production refer to Using the Autoflash Feature in the PADS User Guide for auto flash instructions or as a general purpose external hard drive Note that the USB drive is not automatically added to the Linux file system in the appliance regardless of whether it is inserted into a system at run time or before system startup Once you have inserted the USB drive to add it to the file system enter the following command at the Linux prompt on the appliance mount mnt usb Before removing the USB from a live system you must unmount the USB key from the file system or data may be lost Enter the following command at the Linux prompt on the appliance before removing the USB device Note that if any appl
17. e software development kit Refer to Writing Software Images to Flash Using the Warploader in the PADS User Guide Page 34 User Guide 7 9 2009 2 0 6 15 11 2 LCD PIKA WARP the Appliance 2 0 11 Hardware Information 11 1 Hardware Reset The reset button is located on the back of the appliance beside the SD slot A pointed object such as a pen must be used to press the button A hardware reset may be necessary if the appliance is non responsive when attempting to enter commands at the Linux prompt or if SSH access is failing and the serial port is not connected to another system To avoid possible data loss it is recommended that a software reboot is attempted first 11 2 LCD The LCD on the appliance displays system information and the line status of the channels At system start up after approximately twenty to thirty seconds the IP address is displayed and when initialization is complete the line states are shown The line state display is updated only if Asterisk is running on the system Asterisk is installed and will start automatically A single press of the LCD toggle button beside the LED and highlighted below will display the IP address Pressing the button again will return to the line state display The LCD will display the default IP address if the network configuration has not been set up refer to section Network Setup pg 13 The display is updated when a line state changes When a line goes offhook the icon for
18. efore the login screen with a reminder that Internet Explorer is not supported We recommend that you use FireFox The first screen shown below is the login screen The default username is admin and the default password is admin Enter the usename and password and click Login 7 9 2009 2 0 6 15 User Guide Page 19 PIKA WARP the Appliance 2 0 8 a2 Home Welcome to the Asterisk Configuration Panel Asterisk Configuration aan 7 j Panel Please click on a Asterisk Configuration Engine Move the mouse over to a field to see tooltips panel to manage related features Username pe Password Please login The configuration tool homepage is shown below The pages use a common layout style The left most panel provides menu links to configure Asterisk and system options The center panel is where information pertaining to the selected menu item is displayed and entered The right most panel displays tool tips which provide help information about a given field when the mouse pointer is positioned over the field The Activate Changes option restarts Asterisk which may be necessary if you have made any changes to your Asterisk configuration Page 20 User Guide 7 9 2009 2 0 6 15 29 Home Asterisk Configuration Panel Please click on a panel to manage related features so Users sa Conferencing sa Voicemail 38 Service Providers a9 BRI Config s9 Calling Rules s8 Incoming Calls 29 Voice Menus ag Call
19. ere the lines from the telephone company enter the local premises is also an FXS port The FXO Foreign eXchange Office interface is the port that provides on off hook indication loop closure to the public telephone network It is also the plug on a phone or fax machine Since an FXO port is attached to a device such as a fax or phone the device is often called the FXO device FXO ports are connected to the FXS wall jack where the lines from the telephone company enter into the local premises FXO and FXS are always paired that is they are similar to a male female plug Note All cables to FXO and FXS ports must use wire thicker than 26 AWG The appliance includes one built in FXS port to connect to phone or fax devices For easy identification the ports on the appliance are color coded the FXS ports are green while the FXO ports are orange The opposite color port on each module is the power failure transfer port Refer to Power Failure Transfer pg 40 for more information When the modules are installed channel status information is displayed on the LCD Refer to section LCD pg 35 for more information Wall Jack FXO FXS Public Telephone Switch 7 9 2009 2 0 6 15 User Guide Page 9 PIKA WARP the Appliance 2 0 5 BRI Connections The appliance supports ISDN Basic Rate Interface BRI connectivity through two port BRI modules Each port is a single span which supports 2 B channels and 1 D channel A BRI de
20. ess Call progress uses inband tone patterns such as ringing busy or fast busy received from remote devices to determine why a call has been disconnected Enabling call progress ensures that billing does not start until a two way speech connection has been established Call progress is enabled by default for the analog ports on the appliance Only North American call progress tones have been defined and therefore call progress may not work outside of North America Two options are available for this situation 1 Disable call progress recommended e In the file etc pika pikagp cfg change all entries in the file that match callpa callpa_settings to callpa callpa_settings Page 32 User Guide 7 9 2009 2 0 6 15 PIKA WARP the Appliance 2 0 e In the file etc pika pikagp_aoh cfg change all entries in the file matching answer speech or answer speech to answer none 2 Modify the tone definitions in etc pika inccpa cfg to correspond to the values for your country The comments in the file and the following websites provide information about defining the tones www 3amsystems com wireline tone search htm e www itu int dms_pub itu t oth 02 06 T02060000040002PDFE pdf 7 9 2009 2 0 6 15 User Guide Page 33 PIKA WARP the Appliance 2 0 10 Software Upgrade The warploader command line tool is available to upgrade the appliance software either with software downloaded from PIKA s website or with software developed using th
21. ettings for each span The second table lists channels on the BRI module Settings for BRI cannot be changed from this page Refer to Advanced Configuration pg 28 for information about BRI settings 7 9 2009 2 0 6 15 User Guide Page 23 PIKA WARP the Appliance 2 0 8 22 Home Digital Card Configuration Wizard so Users 1 BRI Card s detected a8 Voicemail Edit pikagp_aoh cfg to modify Card Port Configuration Country 28 BRI Config BRI configuration from the board1 0 client TE pp europe asterisk GUI board1 1 network NT pp europe List of BRI Service providers trunks Trunk Name Ports digital 1 2 3 4 1 4 w sg Calling Rules 28 Incoming Calls a9 Voice Menus sg Call Parking a Be a8 Ring Groups L Copyright 2008 2007 Digium Inc Digium and Asterisk are registered trademarks of Digium Inc Al Rights Reserved Legal information Calling Rules The Calling Rules screen is shown below This screen defines dial plans which specify how calls are routed based on dialed digits Default calling rules are provided which use the FXO and BRI ports of the appliance Note that this calling rule will be shown regardless of whether there is an FXO or BRI module installed Page 24 User Guide 7 9 2009 2 0 6 15 so Home so Users a9 Calling Rules The Calling Rules define dialing permissions and least cost routing rules 28 Incoming Calls PIKA
22. ge without notice PIKA Technologies Inc assumes no responsibility for any errors or omissions in this document and shall have no obligation to you as a result of having made this document available to you or based upon the information it contains 7 9 2009 2 0 6 15 User Guide Page 1 Contacting PIKA Technologies Customer Care PIKA Technologies provides free technical support to all customers For support issues phone or e mail our Customer Care department at the following Tel 1 613 591 1555 FAX 1 613 591 9295 Email support pikatech com International Headquarters PIKA Technologies Inc 535 Legget Drive Suite 400 Ottawa Ontario Canada K2K 3B8 Tel 1 613 591 1555 FAX 1 613 591 9295 Email sales pikatech com Internet Visit our website at www pikatechnologies com for the latest news product announcements downloads online community documentation updates and contact information Page 2 User Guide 7 9 2009 2 0 6 15 3 PIKA WARP the Appliance 2 0 Introduction PIKA WARP the Appliance for Asterisk is designed for low cost Asterisk based applications in the Small Office Home Office SOHO and Small Medium Enterprises SME markets The appliance eliminates hardware and software integration issues in a reliable solid state brandable form factor and includes traditional hardware based telephony features It is compatible with VOIP phones analog sets and BRI trunks The appliance is available with up to nine
23. ially based on the module type FXS ports are always numbered one through five where port one is always the built in FXS port FXO ports are always numbered one through four BRI channels not ports are numbered one through four in the dial plan The following diagram shows an example of this mapping The FXO module is installed in the first bay which is closest to the built in FXS port The FXS module is in bay two The numbers shown on the back view are the port numbers to use when configuring Asterisk e g fxs 1 in the dial plan The bottom view of the LCD shows the same module installation and the associated port numbering Page 18 User Guide 7 9 2009 2 0 6 15 8 PIKA WARP the Appliance 2 0 Asterisk Configuration Using the Asterisk GUI The Asterisk GUI is included as part of the default software shipped with the appliance It provides a graphical interface for basic Asterisk configuration This section describes enhancements to the GUI for use with the appliance General information about Asterisk configuration can be found at http asterisk org Information about Asterisk configuration specific to the appliance can be found in Advanced Configuration pg 28 Initial Login To access the GUI enter the URL http lt Appliance IP gt 8088 in a standard web browser Internet Explorer is not supported as its use to make configuration changes through the GUI may corrupt Asterisk configuration files There will be a pop up box b
24. ications have files open on the USB the applications must be stopped first umount mnt usb For use with Asterisk the USB drive must be formatted for an ext2 file system Refer to the ext2 File System Utilities section in the PADS User Guide for formatting instructions The factory default software is configured to mount the USB as a FAT file system type Section File System Layout in the PADS User Guide describes instructions to change the default file system type which will be necessary for use 7 9 2009 2 0 6 15 User Guide Page 39 PIKA WARP the Appliance 2 0 11 6 Thermal Management with Asterisk Power Failure Transfer On each FXS and FXO module the opposite colored port is the power failure transfer port green on each FXO module and orange on each FXS module If there is a power failure the appliance ports can continue to draw power from the telephone company to make outgoing calls no other functions of the appliance will work On the FXO module if the line from the phone company is plugged into the first port beside the power failure transfer port a phone can be plugged into the power failure transfer port to active FXO port On the FXS module a line from the telephone company can be plugged into the power failure transfer make outgoing calls power failure transfer FXS port port This allows a phone plugged into the first port beside the power failure transfer port on the module active FXS port
25. mkdir mnt sd asterisk voicemail mkdir mnt sd asterisk voicemail default 3 Connect to the Asterisk console and restart Asterisk by entering the following commands at the Asterisk command line prompt asterisk r Page 30 User Guide 7 9 2009 2 0 6 15 9 PIKA WARP the Appliance 2 0 restart now Alternatively log in to the Asterisk GUI and use Activate Changes on the right side panel of the home page to restart Asterisk Refer to Using an SD Card pg 37 for more information about using the SD card Configuring Asterisk on the Appliance for use Outside North America Asterisk on the appliance is configured by default for North America unless there is a BRI module installed in which case it is configured for Europe which is shown using the country code for France FR BRI is not supported for North America therefore even if the country code US is selected settings for BRI will reflect a European configuration To configure the appliance for operation in other countries perform the following steps 1 Stop Asterisk by entering the following commands At the appliance Linux command prompt svc d service asterisk 2 At the appliance Linux prompt enter the following command pikacf e You will be presented with a series of questions to configure your hardware Choose the appropriate country code and defaults will be selected to configure your FXS FXO ports and BRI ports If your country code does not appear press c
26. n initial hardware discovery Depending on your network configuration you may need to change some settings By default each BRI span is configured as node type client TE and networking configuration point to point These settings can be changed in the file etc pika pikagp_aoh cfg Below are sample configurations Full details about configuration file entries can be found in the PIKA GrandPrix Configuration Guide on PIKA s website under Support and Downloads Documentation This entry defines the configuration for BRI at the board level Regardless of the number of BRI modules present 1 or 2 there will be only one board defined At the board level the only parameter it may be necessary to change is clockmode In most cases this should remain at the default value slave This means that timing for the board is derived from the network The setting master is only applicable in loop back mode which is typically used only for testing DIGITAL_25800717 id 1 serial 25800717 interfacetype bri_eu clockmode slave clocks 1 clockO span0 Each span has its own entry The two important entries for BRI are e networkconfig e specifies whether the appliance is being used in a point to point or point to multi point configuration e values pp default value indicates point to point pmp indicates point to multi point node specifies whether this span on the appliance is functioning as a TE or NT device Page 28 User Guide
27. nce 2 0 3 1 Related Documents e Customizable look so you can promote your brand e Dynamic thermal management Software Components PIKA s HMP software e Asterisk and Asterisk GUI software e PIKA s channel driver for Asterisk e Utilities from PIKA e Third party utilities e Software Development Suite for custom application development refer to the PIKA Application Development Suite PADS User Guide for more information Related Documents The following documents are related to the PIKA WARP the Appliance User Guide These documents are linked together and constitute the complete set of documentation for PIKA WARP the Appliance All documents are available at http www pikatechnologies com appliancedownloads PIKA Application Development Suite PADS User Manual This guide describes the software development kit to develop software for the appliance PIKA WARP the Appliance Hardware Manual This manual describes the base board and plug in modules PIKA WARP the Appliance Release Notes These notes describe the contents of the release including known product issues Page 4 User Guide 7 9 2009 2 0 6 15 PIKA WARP the Appliance 2 0 4 Getting Started Hardware Installation Installing the Modules Ensure that the appliance is powered off You must be grounded with an anti static wrist strap Using a screwdriver remove the screws on each of the side panels on the appliance Remove the top cover Remove the grey panel
28. on the back of the appliance as shown below Use a flat object or thin slot screwdriver to lever the panel at the left and right upper corners By hand push the panel from the back through the slot into the casing Rotate the panel up and down inside the casing to break the lateral tabs Take care when rotating the panel that you do not damage the casing at the top of the slot The black module bay connectors are highlighted in the following image FXO FXS and BRI modules can be inserted into either bay If only one module is present it can be inserted into either bay Align the module pins with the connector and insert the module into the connector The module should be secured to the base board by setting the module on top of the posts provided and the screws should be inserted through the gold holes on the the module NOTE Screws must be used to secure the modules to the base board at all times to provide proper contact for frame grounding 7 9 2009 2 0 6 15 User Guide Page 5 PIKA WARP the Appliance 2 0 4 When the modules are installed and the system is powered up channel status information is displayed on the LCD Refer to section LCD pg 35 for more information Module Connectors a oT E lt it a minut or fy W bia p eee Cot as Be AS lt yy x F bi re i at OTS z E LA CE Saio par ra pae Tea a k RE Post Holes Power Connection Connect the power cable as shown below to the re
29. on the type of hardware modules plugged into the base board The software is ready for use upon initial shipment You can customize the Asterisk features available for the analog ports by modifying the configuration file etc asterisk pika conf Documentation for the configuration file is located at http www pikatechnologies com english View asp mp 463 amp x 605 Select the link for chan_pika html The channel driver can be used for sending and receiving faxes to and from the appliance Fax extensions are listed in the table of PIKA extensions in the section Making a Call pg 16 Sending Voice Mail Messages to the SD When Asterisk generates voice mail files by default Asterisk is configured to store the files in var spool asterisk It is highly recommended that voice mails be stored on an SD or USB device To use the SD it must be inserted at system startup time Note that the SD card must be formatted for an ext2 file system A utility to format the card is provided as part of the standard software on the appliance Refer to the Utilities section in the PADS User Manual for instructions To send voice mail files to the SD card make the following configuration changes 1 Edit the file etc asterisk asterisk conf and change the spool directory to the following astspooldir mnt sd asterisk 2 Create the directory mnt sd asterisk voicemail default by entering the following commands at the Linux prompt mkdir mnt sd asterisk
30. ord VM Password Analog Phone Dial Plan Phone Serial m Extension Options Voicemail In Directory SIP IAX CTI Is Agent Call Waiting 3 WWay Calling Can Reinvite NAT 3 DTMF Mode Insecure Edit Codecs Copyright 2006 2007 Digium Inc Digium and Asterisk are registered trademarks of Digium Inc All Rights Reserved Lesat Information The service providers screen is shown below The FXO ports and BRI channels of the appliance are configured as service providers and these entries cannot be deleted or modified Note that these entries are present regardless of whether the appliance has an FXO or BRI module installed Only VolP service User Guide 7 9 2009 2 0 6 15 Page 22 29 Home Service Providers so Users PIKA WARP the Appliance 2 0 List of Service Providers 88 Voicemail S No Service Provider Type a8 Service Providers 1 Ports digital 1 2 3 4 BRI Options w Service Provigeteata 2 Ports fxo 1 fkO 2 fxo 3 fxo d Analog Options v outbound lines used to allow the system to make calls to the real world Trunks can be YolP lines or traditional telephony lines Add Service Provider s9 BRI Config sg Calling Rules 28 Incoming Calls 59 Voice Menus sg Call Parking Activate Changes Move the mouse over to a field to see tooltips BRI Config ISDN Trunks This screen shows the configuration of any BRI modules installed on the appliance Entries in the first table show the s
31. rmatted for an ext2 file system most cards are formatted as FAT by default The factory default software is configured to mount the SD as an ext2 file system If the SD card is inserted before the system is reset or powered up it will be ready for use when the system completes the startup sequence To use the SD with Asterisk it must be available in the file system before Asterisk is started therefore it is recommended that the card is always inserted before system reset or power up If the card is removed while the system is running and Asterisk is configured to use it Asterisk must be stopped before removing the card from the file system If the card is inserted while the system is running it must be manually mounted in the file system or no data will be stored To add the SD to the file system enter the following command at the Linux prompt on the appliance mount mnt sd If you are unsure about whether the SD has been added to the file system enter the command mount at the Linux prompt on the appliance The output should include a line similar to the following dev mmcblkOp1 on mnt sd type msdos rw fmask 0022 dmask 0022 codepage cp437 Before removing the SD from a live system you must manually unmount the SD from the file system or data may be lost Enter the following command at the Linux prompt on the appliance before removing the Page 38 User Guide 7 9 2009 2 0 6 15 11 4 Using the USB Port PIKA WARP the Appliance 2 0 c
32. ssages continuously on the console Modules A FXO B FXS pkdummy Master is now 1 taco FPGA 00232019 Modules A FXO B FXS taco FPGA 00232019 Modules A FXO B FXS pkdummy Master is now 1 Loud Squealing on an analog line Ensure that your analog modules are compatible with your FPGA version Analog modules Rev A 02 or earlier and FPGA version 2 0 2 2 or later are not compatible Page 42 User Guide 7 9 2009 2 0 6 15 12 PIKA WARP the Appliance 2 0 BRI Spans are Stay Ready After Cable Pull Once a span has gone into power saving mode which is usually initiated by the network side the appliance hardware does not detect a change in the link state When an incoming or outgoing call is attempted the state will be updated accordingly BRI Module is not shown on the LCD or in Asterisk Verify that the FPGA version is 2 0 2 2 or later The display on the serial console at system startup shows the current version BRI modules do not work with older FPGA versions LED Stays Red If a BRI module is plugged in verify that the U Boot version is 1 3 0 65 or later The display on the serial console at system startup shows the current version Earlier versions of U Boot do not detect BRI modules however the BRI module will function We still recommend that you use the latest version of U Boot as it includes hardware verification for the BRI module 7 9 2009 2 0 6 15 User Guide Page 43 PIKA WARP the Appliance 2 0 13 13 Hardware and
33. tely reflect the line state If a channel is considered connected when power saving mode is initiated the LCD will indicate that the channel is connected even if it is subsequently disconnected the cable is unplugged either locally or at the far end If a call is attempted on a disconnected channel the call will fail and the LCD will indicate that the channel is disconnected Using an SD Card The appliance includes a slot for a removable SD card The following images show the insertion and removal of a card A pointed object such as pen must be used to fully insert and release the card from the slot The card will click into place when it is fully inserted and the card will be recessed slightly into the casing 7 9 2009 2 0 6 15 User Guide Page 37 PIKA WARP the Appliance 2 0 11 3 Using an SD Card NOTE The card must click into place If you are unsure about whether it is correctly inserted execute the following command at the Linux prompt on the appliance cat proc driver pikasd Any non zero return value indicates that it is properly inserted The SD is intended to store any run time data that must survive across system resets such as voice mail files log files or to transfer files to another computer It can also be used for auto flashing the appliance during production refer to Using the Autoflash Feature in the PADS User Guide for instructions to auto flash the appliance For use with Asterisk the card must be fo
34. the corresponding line is solid While the line is ringing the icon flashes The icon is solid again once the call 7 9 2009 2 0 6 15 User Guide Page 35 BRI Link State Display PIKA WARP the Appliance 2 0 11 2 LCD has been answered Empty icon boxes for BRI and FXO indicate channels that are not connected FXS channels will always show an icon The following shows the display where port 1 FXS and BRI channels 2 and 4 have calls in progress BRI channels 3 and 5 are active but currently idle BRI channels 6 through 9 are not connected The following shows the display where ports 1 FXS 3 FXS and 8 FXO have calls in progress Port 9 FXO is active but is currently idle Ports 6 and 7 FXO are not connected PRA TECHNOLOGIES INC If the appliance is installed such that the display is upside down the LCD display can be reversed by pressing the button on the LCD face plate three times in succession Toggle Button 11 2 1 BRI Link State Display Due to limitations of the BRI hardware and the link protocol the LCD may not accurately represent the channel state under certain conditions This section attempts to summarize the expected behaviour A span or channel is considered connected when both ends of the link are plugged in and exchanging Page 36 User Guide 7 9 2009 2 0 6 15 11 3 Using an SD Card PIKA WARP the Appliance 2 0 low level signaling information The LCD reflects the state of the channel in Asterisk S
35. to make outgoing calls power failure transfer FXO port Once the power returns if the power failure port is still in use the first port on the module cannot be used until the line returns to the idle state Thermal Management The appliance performs automatic temperature control and monitoring Under normal ambient temperature levels the fan will not run If the temperature reaches a minimum threshold of 50 degrees Celsius 122 degrees Fahrenheit the fan will start automatically at low speed If the temperature continues to increase the speed of the fan will increase accordingly eventually reaching full speed If the Page 40 User Guide 7 9 2009 2 0 6 15 11 7 Wall Mounting PIKA WARP the Appliance 2 0 fan is on and the temperature decreases to 47 degrees Celsius 116 6 degrees Fahrenheit the fan speed will begin to decrease and eventually shut off completely if the temperature remains below 50 degrees Celsius 122 degrees Fahrenheit When the temperature reaches a maximum threshold of 65 degrees Celsius 149 degrees Fahrenheit e the system will halt e the LED will flash red e the analog BRI and Ethernet interfaces will not function e the power failure transfer port s will still function 11 7 Wall Mounting The appliance can be stacked or wall mounted When wall mounted the appliance rests on the rubber feet therefore it is recommended that you do not remove the feet so that the unit remains stable The
36. ult IVR in addition to the demo congratulation recording e returns to the top level of the IVR menu normally changes the language to French French language files are not installed by default on the appliance e plays a recording that describes Asterisk good bye PIKA Extensions To make calls using the appliance hardware the following dial plan contexts and extensions have been included in the default extensions provided in the file etc asterisk extensions conf Existing extensions in the default Asterisk dial plan continue to work The following contexts have been defined Page 16 User Guide 7 9 2009 2 0 6 15 7 PIKA WARP the Appliance 2 0 Usage PIKA context to use with the appliance FXO ports PIKA context to use with the appliance FXS ports PIKA context to use with the appliance BRI ports Default FXO context used by the GUI numberplan custom 1 Default context provisioned for the appliance used by the GUI Extension Purpose Destination Connects to the audio in port to listen to the audio sent from an external device such as an MP3 player Connects the handset microphone to the audio out port on the appliance used for paging Begins playing pre recorded prompts to the audio out port on the appliance After dialing if you hang up the prompts will continue to play Stops the pre recorded prompts started by dialing extension 2244 These extensions call FXS lines 1 to 5 respectively If the FXS module is
37. vice can behave as a Terminal Endpoint TE or a Network Termination NT The appliance is an NT 2 device which means it can take the role of both a TE and or NT device in the network software configurable Examples of NT devices are e public telephone switches PBXs Examples of TE devices are computers e BRI phones PBXs NOTE The appliance does not support BRI phones in the current release BRI modules and FXO modules cannot co exist in the appliance There are several different types of interfaces that can be used to connect BRI devices within a network On the appliance only the S interface type the reference point between user terminals and the NT 2 is supported Two configurations software configurable are supported e point to point e a single span connects a single TE device to an NT device point to multipoint a single span connects multiple TE devices to an NT device Ports on the appliance are software configurable The default settings are endpoint type TE and a point to point configuration Section Advanced Configuration pg 28 describes software configuration settings for BRI The following diagrams illustrate the use of the appliance within a network in a point to point configuration and a point to multipoint configuration Page 10 User Guide 7 9 2009 2 0 6 15 5 PIKA WARP the Appliance 2 0 NOTE A straight through network cable must be used for all BRI port connections Point to
38. when presented with the following prompt Enter two letter country code for example US for United States Enter to display the list of supported country codes or c to customize individual parameters Country code US e You will be asked for information regarding your companding mode and caller id mode Choose the appropriate values for your country Compand mode ulaw or alaw Enter for help ulaw alaw 7 9 2009 2 0 6 15 User Guide Page 31 PIKA WARP the Appliance 2 0 9 Select one of the following caller id modes 1 FSK BELLCORE 2 FSK ETSI 3 FSK BT 4 FSK NTT 5 DTMF ETSI 6 DTMF DK 7 DTMF SE FI 8 None Selection Enter for help 8 NOTE Any country for which there is a predefined configuration will have the correct line impedance value set Configuration for other countries entered by selecting c at the country code prompt will use the North American value There is no configuration file entry to change the line impedance 3 Change the indication tones for Asterisk in the file etc asterisk indications conf e In the general section if your country is in the list of the default countries below modify the line country as appropriate e If your country is not in the list please use the template shown in the file to create a section that defines the tones for your country 4 Restart Asterisk by entering the following at the Linux command prompt svc u service asterisk Call Progr
39. ystem Startup e Ifa span is connected when Asterisk starts the LCD will indicate that the channels are connected and idle e Ifa span is not connected the LCD will show the empty icon box indicated that the channels are not connected When the span is connected it will be detected and the icon will be updated to show that the channels are idle Call Processing When a call is in progress the icon will show that the channel is in use e If the span is disconnected the cable is unplugged either locally or at the far end during a call the LCD will be updated immediately to show the empty box When the channel is reconnected the channel state will be updated immediately to reflect the change to the idle state Ifthe LCD shows that a channel is connected and a call is attempted on that channel if the channel is actually disconnected the LCD will first show the channel in use and then after a few seconds it will update to show that the channel is disconnected Power Saving Power saving mode is initiated by the network side at a pre determined time usually ninety seconds following the completion of the last call on the span Low level signaling information between the NT and TE stops and the channels on the span are deactivated Note that the appliance cannot initiate power saving even in NT mode If a call is attempted on a channel it will automatically exit power saving mode the call will progress normally and the LCD will accura
Download Pdf Manuals
Related Search