MP01 Administrator Manual Version: V1.
Table of Contens Contact ATCOM ........................................................................................................................ 2 MP01 Administrator Manual ............................................................................................ 3 1. Introduction ................................................................................................................... 3 1.1 Mesh networking ...................................................................................
Contact ATCOM The Introduction of ATCOM Founded in 1998, ATCOM technology has been always endeavoring in the R&D and manufacturing of the internet communication terminals. The product line of ATCOM includes IP Phone, USB Phone, IP PBX, VoIP gateway, Asterisk Card and WiFi Mesh ATA. Contact Sales: Address A2F , Block 3 ,Huangguan Technology Park , #21 Tairan 9th Rd, Chegongmiao , Futian District , Shenzhen China Tel +(86)755-83018618 Fax +(86)755-83018319 E-mail sales@atcomemail.
MP01 Administrator Manual This document describes detailed information for the MP01, and it will guide you through the installation for setting up telephony system and providing Internet access with MP01. 1. Introduction The MP01 is a WiFi mesh VoIP ATA (analog terminal adapter) operating in the license-exempt 2.4GHz ISM band.
1.3 Server Only one computer is required to provide the services for the Telco system. This computer, called the VT Server, could be anything from a standard laptop to a high-end server for better redundancy. The services on this computer are made up of several elements including Afrimesh, A2Billing and A3Glue. The server part consists of several software elements.
Accounting. A3Glue This is the glue, making Afrimesh, A2billing and the Mesh network work together. It gathers data from the network, provisioning the MP01 and make sure everything runs smoothly. 2. Scenarios and Installation Guide 2.1 Scenarios Stand-alone installation MP01s can be deployed from two units and you can make calls between them. You can then add more units to the network one at a time. You will be able to make calls and can have a closed network between the units.
In this network topology, all the MP01 is an extension and act as mesh node also. And VT Server is installed Afrimesh and act as a visualization server. We use IP08 as Asterisk server, and all the MP01 are registered to IP08. The feature of this system is: Every MP01 has a WiFi IP and a phone number, the phone number is the same as the last digit of the WiFi IP, for example, the Mesh node A has a WiFi IP 10.130.1.50 and a phone number 50. Every MP01 can be a reply for other MP01.
sudo apt-add-repository ppa:afrimesh/ppa sudo apt-get update 2) Install supporting packages sudo apt-get install batmand polipo villagetelco-dashboard 3) Install the batman visualisation server wget http://download.villagetelco.org/vte/afrimesh/954/vis-i386-lucid sudo mv vis-i386-lucid /usr/local/sbin/ 4) Configure pmacct Edit /etc/pmacctd/pmacctd.conf to reflect the following: !aggregate: src_host,dst_host aggregate: dst_host,dst_mac !pcap_filter: net 127.0.0.0/8 pcap_filter: net 10.130.1.
If you haven't already set the password on the MP01, do that now by telneting to 192.168.1.20 and issuing the „passwd‟ command. This will enable ssh and you will be able to continue with the following. 2) Copy the packages to the MP01. scp *ipk root@192.168.1.20:/root 3) Login into the MP01 ssh root@192.168.1.20 4) Install and configure the packages on MP01 (Answer „Y‟ when asked to replace /etc/config/afrimesh) opkg install netcat_0.7.1-1_mips.ipk opkg install villagetelco-device_1.0pre-r954-1_mips.
iptables --table nat --append POSTROUTING --out-interface eth0 -j MASQUERADE iptables --append FORWARD --in-interface wlan0 -j ACCEPT echo 1 > /proc/sys/net/ipv4/ip_forward Now start the visualisation server. Initially, it is worth doing this in a separate terminal window so that you can monitor the server. Substitute your wireless device if not wlan0. /usr/local/sbin/vis-i386-lucid -d1 -j wlan0 Finally start the batman server. Once again, substitute your wireless device if not wlan0. batmand -d1 -s 10.130.
[general] register=6015:6015@192.168.1.100 [6015] host=192.168.1.100 secret=6015 username=6015 insecure=very type=friend disallow=all allow=gsm,ulaw,alaw dtmfmode=rfc2833 qualify=yes canreinvite=no nat=yes context=default 2) On MP01, edit /etc/asterisk/extension.conf and add some lines as below: [default] exten => _9.,1,Dial(SIP/6015/${EXTEN:1}) 3) Assume that the outgoing calling rules on IP08 is „88+phone number‟, then you can use MP01 to make international calls by dialing „988+phone number‟. 2.2.
OCTET_B=`uci show network.wifi0.ipaddr | cut -d = -f2 | cut -d . -f2` OCTET_C=`uci show network.wifi0.ipaddr | cut -d = -f2 | cut -d . -f3` OCTET_D=`uci show network.wifi0.ipaddr | cut -d = -f2 | cut -d . -f4` cp /etc/config-mesh/* /etc/config/ uci set network.wifi0.ipaddr=$OCTET_A.$OCTET_B.$OCTET_C.$OCTET_D uci set network.lan.ipaddr=172.30.$OCTET_D.1 uci set network.lan.netmask=255.255.255.0 uci set network.lan.dns=172.30.$OCTET_D.1 uci set network.lan.gateway=172.30.$OCTET_D.1 uci set batmand.general.
ln -s /etc/init.d/udhcpd /etc/rc.d/S99udhcpd ln -s /etc/init.d/batmand /etc/rc.d/S90batmand ln -s /etc/init.d/create-batman-status-page.sh /etc/rc.d/S99create-batman-status-page.sh echo "meshclientgw" > /etc/app-profile echo "Done. Rebooting now." reboot 2) Make this script executable. chmod +x meshclientgw.sh 3) Run the script. /bin/meshclientgw.sh 4) The MP01 will reboot after running the script. Connect your computer to MP01 through Ethernet port and set computer to DHCP.
The first screen that appears is the Mesh Potato GUI (shown as below). You can preview the MP01 settings and set up the WiFi network, wireless, B.A.T.M.A.N, and telephony settings here. You should notice that version r238 doesn‟t have Mesh Potato GUI, so it will appear LUCI interface directly. Mesh Potato GUI NOTE: If you forget the MP01 IP address you have set up, you can use fallback IP: 172.31.255.254/30. You should set up the IP Address of your PC as: 172.31.255.253 and Subnet Mask: 255.255.255.252.
OpenWrt GUI Overview => User Interface You can customize the settings and the functionality of LuCI on User Interface.
User Interface Overview => LuCI Components The LuCI Components screen shows the package list. Here you can download and install package, and find packages using the filter as well.
LuCI Components Overview => Logout Logout OpenWrt GUI. Status => Interfaces The Interfaces screen displays the interface status, such as Device, Type, Transfer, IP Connection etc.
Interfaces Status => Firewall The Firewall screen shows the firewall configurations. Every rules you have set up for firewall will be shown here. You could set up firewall by command line after accessing MP01 using SSH or Telnet. This feature is only available with version r238, and it is for advanced users.
Firewall Status => Active Connections The Active Connections page gives an overview over currently active network connections.
Active Connectios Status => Routes This page shows the active routes. Routes Status => System Log This page shows the system logs.
System Log Status => Kernel Log This page shows the kernel logs. Kernel Log System => System Here you can configure the basic aspects of MP01 like its hostname, timezone, system log buffer size, external system log server, log output level and cronloglevel.
System System => Software This page will show you the softwares you have installed or not installed. You can download and install the package here.
System => Admin Password You can change the password of the system administrator here. Admin Password System => SSH-Keys You can paste public SSH-Keys for SSH public-key authentication. Then you don't need to enter a password anymore, you will be automatically authenticated. SSH-Keys System => Processes This page gives an overview over currently running system processes and their status. You can hang up, terminate or kill the process here.
Processes System => Mount Points This page displays the mounted file systems, mount points and swap device. Mount points define at which point a memory device will be attached to the filesystem. If your physical memory is insufficient unused data can be temporarily swapped to a swap-device resulting in a higher amount of usable RAM. Be aware that swapping data is a very slow process as the swap-device cannot be accessed with the high datarates of the RAM.
Mount Points System => LED Configuration You can customizes the behavior of the device LEDs if possible. Just add an entry, choose the LED device and its trigger, then the LED will twinkle according to the trigger.
LED Configuration LED Name: Enter the LED name you like LED Device: Choose which LED you want to twinkle Default state: The default state of the specified LED, ticked=on Trigger: On what conditions the specified LED will twinkle. It has 5 options: None, Timer(The LED will twinkle according to the timer you set), Heartbeat(LEDs will twinkle according to load average), Default On, Network Device(LEDs will twinkle according to the network status).
Backup / Restore System => Flash Firmware This feature allows you to upload an OpenWrt image file to reflash the device. Flash Firmware System => Reboot Reboot the operating system here.
Reboot Services => Busybox HTTPd It is a small web server which can be used to serve LuCI. You can configure the server port and document root. Busybox HTTPd Services => Dropbear SSHd Dropbear offers SSH network shell access and an integrated SCP server.
Dropbear SSHd Services => Dnsmasq Dnsmasq is a lightweight, easy to configure DNS forwarder and DHCP server. It is designed to provide DNS and, optionally, DHCP, to a small network. It can serve the names of local machines which are not in the global DNS. The DHCP server integrates with the DNS server and allows machines with DHCP-allocated addresses to appear in the DNS with names configured either in each host or in a central configuration file. In order to use Dnsmasq, you need to install the package.
Dnsmasq Services => Scheduled Tasks This is the system crontab in which scheduled tasks can be defined. You can edit the configuration file of the cron daemon via Luci. It is for advanced users.
Scheduled Tasks Network => Interfaces => WIFI0 / LAN On this page you can configure the network interfaces. You can bridge several interfaces by ticking the “bridge interfaces” field and enter the names of several network interfaces separated by spaces. You need to install “ppp-mod-pppoe” for PPPoE, or “pptp” for PPTP support.
Interfaces => WIFI0 31
Interfaces => LAN Network => Wifi Here you can scan the WiFi networks in your local environment. The following screen shows the WiFi networks in my local environment.
Wifi Network => Wifi => WIFI0 You can run several wifi networks with one device. Be aware that there are certain hardware and driverspecific restrictions. Normally you can operate 1 Ad-Hoc or up to 3 Master-Mode and 1 Client-Mode network simultaneously.
Wifi => WIFI0 Enable: To make WiFi available or not. Channel: It has 11 WiFi channels to choose. Mode: MP01 supports 802.11b/g ESSID/BSSID: WLAN ID for wireless network Mode: It can work as Access Point, Ad-Hoc, Client, Pseudo Ad-Hoc(ahdemo) and Monitor Encryption: It supports only WEP in version r233. Network => Switch You can set up VLAN settings in this menu. This is yet another option for advanced users. Since the MP01 doesn't have multiple Ethernet ports, this menu is of very limited use.
Switch Network => DHCP You need to install the dnsmasq package before using it. You can configure the DHCP options such as assigned range, lease time and so on.
Start: The first IP address it will assign Limit: The last IP address it will assign Leasetime: The amount of time a network user will be allowed to connect to the MP01 with their current dynamic IP address. Network => Hostnames You can add hostname entrys here. Hostnames Network => Static Routes A static route is a pre-determined pathway that network information must travel to reach a specific host or network. Static Routes Interface: Select the appropriate interface.
4. Troubleshooting 4.1 What to do if you can’t connect to the MP anymore - using the Fallback-IP This can easily happen if you are messing around with the IP settings of the MP. Luckily the MP has a additional IP subnet at the Ethernet port that can not be changed or disabled from a web interface. On your PC configure the Ethernet port to use 172.31.255.253/30 (netmask 255.255.255.252).
-- Called 4000@10.130.1.142 -- event_onhook -- default: hangup sound_on = 1 == Spawn extension (default, 142, 1) exited non-zero on 'MP/1' -- start mp_hangup 4.3 Choppy sound This is most likely caused by a poor wireless link. Check that you have line of sight to other MP01. It is also possible to install another MP01 on a nearby building or tower to relay the signals. 4.4 The MP01 is flashed with AP51 The AP51 flash tool re-arranges the disk lay-out.
RedBoot 0xA8000000 0xA8000000 0x00030000 0x00000000 rootfs 0xA8030000 0xA8030000 0x006F0000 0x00000000 vmlinux.bin.l7 0xA8720000 0x80041000 0x000B0000 0x80041000 FIS directory 0xA87D0000 0xA87D0000 0x0000F000 0x00000000 RedBoot config 0xA87DF000 0xA87DF000 0x00001000 0x00000000 The fix is to flash the system via Redboot with the correct layout and follow the instructions here: http://wiki.villagetelco.org/index.php?title=Mesh_Potato_HOWTOs#Reflash_t he_firmware_from_RedBoot. 5. Appendix 5.
Telephone Line (PoTL) Open Hardware Design No vendor lock-in. Open to improvement by anyone. Open Source firmware Linux, OpenWRT, B.A.T.M.A.N., and Asterisk. Stable, reliable community developed software. Open to improvement, adaptation, and innovation. Asterisk Extremely configurable, add IVR menus, connect IP Phones and billing systems 5.
Physical Casing: UV-protected, weatherproof outdoor enclosure Mounting: Pole Mount/Wall Mount Enclosure Size: 228 X 106 X 55 mm Weight : 0.3 Kg Regulatory/Compliance Information RoHS Compliance 6. Acronyms B.A.T.M.A.