Digium IAXy Configuration Manual

Hello! and thank you for purchasing the Digium IAXy ATA Device! The IAXy is a single-port Ethernet-to-telephone adapter,
speaking the Asterisk-native IAX protocol, and designed for use with Asterisk, The Open Source PBX. This document covers
layout, power requirements, booting and provisioning of the IAXy. If you have any questions, please feel free to send an
e-mail to <[e-mail]>.

Physical Layout

The back side of the IAXy features four components.
From left-to-right they are: RJ11 telephone interface, a small
recessed Reset button, 10baseT Ethernet interface, and Power
interface.

The IAXy measures 65mm x 65mm x 28mm (w x d x h).

Power Requirements

(If you purchased your IAXy with a Digium power supply, you may
skip this section.)

The IAXy has specic power requirements. You will need a 9-volt

switched or regulated Power Supply outputting at a minimum

of 800mA with tip positive, and a plug measuring 5.0mm outer
diameter and 2.5mm inner diameter to power the IAXy. A regulated
power supply is preferred, as a switched power supply may cause an
audible hum to be present on the line on lower quality analog handsets.

CAUTION: Do not use an unregulated or unswitched power supply with
the IAXy. Doing so will cause the unit to function unreliably and may
cause it to fail.

IAXy Conguration Guide

Provisioning the IAXy

Once the IAXy has booted, it needs to be provisioned in
order that it might register as an IAX friend with your Asterisk

server. The provisioning process species the IAX username,

password, and host. To provision the IAXy, you will need the
provisioning utility that can be downloaded by following these
instructions:

$ cd /usr/src
$ export CVSROOT=:pserver:anoncvs@cvs.

digium.com:/usr/cvsroot
$ cvs login (the password is anoncvs)
$ cvs co iaxyprov
$ cd iaxyprov

The iaxyprov package will contain the following les:

Makefile
frame.h
iaxydebug.c
iax2.h
iaxy.conf.sample
provision.c
provision.h

Build the provision utility by executing the make command.

Once this is done, modify the iaxy.conf.sample le to t
our needs:

;
; IAXY Provisioning description
;
dhcp ; (DHCP enabled)
;ip: 192.168.0.100 ; (Set a static IP for
the IAXy)
;netmask: 255.255.255.0 ; (Set a static netmask)
;gateway: 192.168.0.1 ; (Set a static gateway)

Booting the Unit

The IAXy requires that you plug in the interfaces in specic

order. The easiest suggestion is to follow a left-to-right
methodology.

Plug in the telephone cord

Insert the Ethernet cable

Power up the unit

The key point here is that the telephone cord and Ethernet
cable must be inserted before power is applied. Failing
this, the unit will not boot completely and will not properly
initialize the telephone device.

Upon booting, the unit will seek out an IP address from a
DHCP server. The easiest way to determine the IP of the
IAXy is to monitor either your syslog, messages, or your

daemon.log le in /var/log. You can watch real-time

changes to these les by using the tail command such as:

$ tail -f /var/log/syslog

or

$ tail -f /var/log/messages

or

$ tail -f /var/log/daemon.log

1
2
3