Free Software?

Freedom Fone is Free Software - this means it is developed by a community and licensed in a generous way so you can use it for free for whatever you want.

Free Software (sometimes also referred to as Free and Open Source SoftwareFLOSS, FOSS, Software Libre, or Open Source) is software that anyone can download, share, and -- significantly -- change in any way they want. Practically speaking, you might never want to change the software, or even have a staff person who can read the source code (the instructions written by programmers). But the ability to change the software protects you in many ways:

That may be enough for you, but for the sake of completeness we'll offer some widely used definitions:

"Free software or software libre is software that can be used, studied, and modified without restriction, and which can be copied and redistributed in modified or unmodified form either without restriction, or with minimal restrictions only to ensure that further recipients can also do these things and that manufacturers of consumer-facing hardware allow user modifications to their hardware. Free software is available gratis (free of charge) in most cases."
(from: http://en.wikipedia.org/wiki/Free_software)

"Open source software (OSS) is defined as computer software for which the source code and certain other rights normally reserved for copyright holders are provided under a software license that meets the Open Source Definition or that is in the public domain. This permits users to use, change, and improve the software, and to redistribute it in modified or unmodified forms. It is very often developed in a public, collaborative manner."
(from: http://en.wikipedia.org/wiki/Open_source_software)

Nearly any software that qualifies as free also qualifies as Open Source, and vice versa. The main reason that two different terms exist is that "free software" emphasizes the freedom aspect (that you aren't under the control of the original programmers) whereas "open source software" emphasizes the convenience and potential for innovation provided by having the source code available.

When you install and use Freedom Fone, you'll notice there's no annoying click-through software license imposing a thousand things that you can or cannot do with it. That's because free software doesn't limit your right to do with the software whatever you want. Free and open source software have licenses, but they're simpler than and quite different from proprietary software ('closed software') licenses. Freedom Fone itself is available under the Mozilla Public License Version 1.1, one of the popular free software licenses used by many other projects.

Free Software and non-profits

Explaining all of the possible considerations on using FOSS in non-profit and advocacy work might take a really long time, so let's focus on the most important highlights:

Apart from the quite practical advantages listed above, there is also a more philosophical approach to answering the question of importance of FOSS for non-profits and advocacy organisations. Without getting too deep into philosophical discussions, there is a great overlap between values shared by non-profit organisations and these shared by Free and Open Source Software communities. By working with the community of users, providing your feedback, contributing your changes back into the project, you're actually strengthening the non-profit sector.

Further Reading

Free Software Foundation
http://www.fsf.org/

The Free Software Definition
http://www.gnu.org/philosophy/free-sw.html

Open Source Initiative
http://www.opensource.org/

The Open Source Definition
http://www.opensource.org/docs/osd

Choosing and Using Free and Open Source Software: A primer for nonprofits
http://www.nosi.net/projects/primer

Introduction to Mobile Phone Security

Most people have mobile phones today. In the past these devices were primarily used to call and send text messages. In addition, all mobiles have at least an ability to keep an address book. There is a new generation of mobile devices that come with Internet access, built-in video cameras and the ability to install additional software. These smart phones can be very convenient and provide you with very powerful and useful tools. These phones contain a lot of private data and, unfortunately, a phone can be lost easily. The following chapter deals with some methods to use them more secure.

Security issues with mobile phones

Physical security - A phone can be confiscated or stolen. If you are a journalist, your address book might be of special interest: it can be used just to gain knowledge of your network or for further social engineering. As a minimum safety measure you should always enable some kind of password protection on your phone (not just on your SIM card).

Voice - Although the voice on a GSM (mobile phone) channel is encrypted, this encryption was hacked some time ago and is not considered safe any more. Furthermore, if you do not trust the network(s) you are using it has never been safe. Normal VoIP communications are very insecure as they are not encrypted. Some other VoIP services use some kind of encryption.

SMS - Text messages are sent in plain text over the network, so they are also not considered secure, additionally they are not securely stored at your device, so anyone with access to it will be able to read them. If you are using an Android based phone read the chapter on 'Secure Text Messaging'

Smartphones - Smartphones are quite new, and unfortunately most advanced (and even some basic) ways of securing that are available on normal computers are not available on smartphones. They pose additional risk since you are also using them for things like agendas, and personal note taking. Also not all applications in an appstore or market are safe to use, because there are a considerable number of malware apps on the market which are passing your personal data to other companies. You should always check if the app's you want to use can be trusted. Internet on your mobile device is subject to the same problems as all wireless communications. Read the chapter on VPN for mobile devices to improve this.

Prepaid sim cards - In some countries you are still able to use prepaid locally bought SIMcards without identifying yourself. Beware that your phone also has a unique identifier (known as the IMEI number) so switching SIM cards will will not guarantee to protect your privacy.

The following chapters will deal with different methods that are available today to secure your mobile communications. Note that mobile phone security in particular is developing very fast and users should check out the current status of premier open source efforts like the Guardian Project (guardianproject.info).

About this book

This guide was authored together in November 2011, over a six day period in Nyanga Zimbabwe, by a team of 11 people drawn from 6 countries.

Kubatana brought us together, mined the contents of our heads, the experiences of literally thousands of others who are part of the Freedom Fone story and the support of donors and well wishers who have believed in the Freedom Fone ethos.

For many of us who have been used to the processes of creation taking months and sometimes years the tool and process we used called Booksprint was a revelation. Individual thought and writing, two person teams, pow wows of the whole team fueled by respectful argument, disagreement, eventual compromise and recommitment to the task of finishing the guide to deadline all led to a roller coaster ride that was exhilarating and satisfying.

Seven hundred hours of our collective effort has produced around thirty thousand words of description and many illustrations that we hope is a coherent whole and a useful tool to help you use this fantastic software called Freedom Fone.

The story is never complete and your contribution can help us to improve this manual and 'keep it live'. By using Freedom Fone, testing this guide out and letting us know how relevant it is - you too will become an author of something that really does help many others!

You will join that community of Free and Open Software developers and users that are changing paradigms of ownership and control of information and tools. We welcome you and your contribution and wish you well in your journey with Freedom Fone!

The spirit of Ruparara be with you!

Advertise your service

So, you have created your Freedom Fone service and you are ready to get the word out and advertise. A crucial question to address now is: how are you going to spread the word about your service? This chapter looks at what is involved in advertising your service.

Budget for your advertising

One common oversight when creating a Freedom Fone service is to forget about the costs associated with keeping your service running and advertising is a big part of this - people cannot call the service if they don't know about it or which number to call. Depending on which of the advertising techniques you choose to use below, it is important to set aside some money in your annual budget for this.

Advertising techniques

Because your primary target are people who have limited or no internet access, many of whom may be semi- or illiterate and may speak minority languages, it is important to carefully consider your advertising methods to suit your target market.

We recommend prioritising the following offline advertising techniques:

Note: all your advertising must include a "Call to Action". Example: "Call 077123456 to find out more". In the case of a poll, you have several criteria to communicate to your audience: start and end date/time for the poll, multiple choices answers, poll code and of course the phone number to which participants should send their SMS replies.

Do you have some advertising ideas you can share with us?

Online communication

Does your audience use the internet? Even if they don't - if you have access to the internet, and maybe run a website, you might want to consider the following channels for advertising and spreading general awareness about the service:

Educating your audience

An important step in ensuring that your audience call in and use your Freedom Fone service is to provide training to new callers. Please see the chapter Know Your Audience for some suggestions on how to do this.

At the radio station

Radio stations are in many ways, ideally positioned to benefit from and launch a successful Freedom Fone service:

Imagine you have a radio station that is packed with a schedule of popular radio programmes hosted by presenters who each have a group of loyal listeners. Perhaps your station is looking for new ways to interact and engage with listeners because you lack a comprehensive system for two-way communications with listeners. Here follow some ways that Freedom Fone can be used at the radio station.

Gathering your listeners' voices

Including the voices of listeners in radio broadcasts adds a richness and depth to any radio programme but is especially powerful for community radio stations. Getting into the field to conduct direct interviews can be expensive and logistically difficult. The Leave-a-Message functionality of Freedom Fone enables your radio station to receive a variety of audio messages from your listeners. Here are a few of the possible applications:

How would you use the Leave-a-message service at your radio station?

Gathering your listeners' opinions

Through the SMS poll functionality of Freedom Fone, audience members are able to participate in opinion polls on topics by sending an SMS from their (or someone else's) mobile phone. As a radio station, conducting frequent listener polls can be a powerful way to get your finger on the pulse of your listeners in a quick and measurable way. A listening audience is usually keen to participate when possible and polls can deepen their relationship with your radio station. A few possible applications of SMS polls at the radio station:

What ideas do you have for using SMS polls at your radio station? Lets talk!

You can also receive standard text messages using Freedom Fone's Incoming SMS function. Any message the doesn't qualify as an SMS poll 'vote' will automatically be received as an Incoming SMS. This means that you can receive free format queries, reports, tip-offs, feedback and other requests via ordinary SMS if you wish.

Giving your listeners audio-on-demand

By creating Voice Menus, content from the radio station's different radio programmes can be used to make précised versions of audio information available "off-air" to listeners over the phone. Information-on-demand allows your audience to choose when and from where they want to listen to audio you make available. A few possible ways to use Voice menus at the radio station include:

What information would you make available through Voice Menus? Lets talk!

To announce the service to your listeners, why not prepare several radio spots that explain the new features as well as the phone numbers to call. Stickers and postcards advertising the service and phone numbers can be distributed in communities and handed out at any radio events.

The Freedom Fone Service can be used to generate an extra income stream by having sponsors put their own jingles in the Voice menu and/or Leave-a-Message services. For example, callers could hear a short message "This competition brought to you by..." before they are prompted to record their message for the radio station. This sponsorship could be changed periodically.

 

Resources needed

Equipment

Staff and Competencies

Advertising costs

Role of Freedom Fone

Phone books

Creating Phone books

Phone books can be used to segment your callers, for example for different calling campaigns.

Adding Callers to your Phone book

You can populate your phone book in Edit mode. Select one or more callers from the dropdown list displayed and save. Alternatively you can add callers to the phone book from the User Management > Callers page.

Removing a Caller from a Phone book

Do not select the delete option as this will remove all instances of that caller, including from the caller's list!

You may remove a user in two ways:

Export Phone book

You can export your phone book(s) to a CSV file by selecting the Export icon associated with it.

Callers

Adding a caller

You can manually add a caller by selecting the Add Caller button on the User Management > Callers page.

On the User Management > Callers > Edit page you can edit caller details and view caller's activity and details.

Choose your information sources

Once you feel you know your audience well enough and understand their information needs, the next step is to get to know your information sources. These information sources, as there may be several, are how you create your content and are at the heart of your Freedom Fone Service (unless you are just using the Leave-a-message functionality exclusively and not using the voice menus). The following are some possible examples of where your information sources can come from. This list is by no means exhaustive.

These are a few possibilities - what information sources are you planning to use?

Selecting information sources

Because the information sources are the heart of your Freedom Fone service, it is worth mentioning some other considerations that may help you get your service running smoothly from the get go.

How often to update your information?

Keeping the information and content on your Freedom Fone Service up to date is one of the best ways to ensure that your callers will use your system on a regular basis. It is up to you and your audience to determine what the frequency of these updates will be: eg. daily, weekly, bi-weekly or monthly. Once you have identified the update schedule of your service, it is important to stick to the rhythm so that the audience know how often they can expect to use your service and when.

First time installers of Freedom Fone often underestimate the amount of work and time that goes into maintaining your service. You might like to try creating some audio content before committing to a daily update.

Community Radio Harare

Community Radio Harare (CORAH) is one of the main community radio stations in Zimbabwe. Based out of the capital city, they have been using Freedom Fone since October 2010 as an alternative to broadcast for Free Voices Harare, a community news programme.

Despite a political agreement signed in 2009 promising to liberalise media channels in Zimbabwe, no independent or community radio station currently has a licence to broadcast (May 2012). While CORAH waits for the government to issue operating licences, using Freedom Fone as a means of community outreach makes sense due to the widespread access to mobile phones.

CORAH used Freedom Fone to established Free Voices Harare as a citizen media initiative to encourage self-expression in marginalised communities around Harare. The service receives around 50 calls a day.

"We have trained citizen journalists in 30 wards so in each of those areas there are people who are trained to use Freedom Fone. People know how to phone in and deliver voice or text messages and even to listen to news, radio documentaries and then impart that information to their communities as well."
-- Givemore Chipere, Programming Manager, CORAH

CORAH is often first to break with local news stories thanks to the tips they receive from their network of community reporters.

CORAH realised that the inability to transmit via traditional radio actually presented opportunities for experimenting with new solutions for engaging with their community. Freedom Fone was particularly useful because it gave people a platform to not only listen to news but also to share news tips and eye witness reports from their areas via text or voice message.

"We saw it as an opportunity to offer people a platform for self-expression and it is working quite well because we are not using the regulated radio frequencies that the government does not want people to use. We found it as a very innovative way to offer people a means of self-expression," explains Chipere.

Despite major challenges and lack of resources, Community Radio Harare continues to use Freedom Fone in conjunction with other media platforms like bulk-SMS, audio documentaries, website (www.corah.org.zw) and e-newsletters to build community listenership and participation. As Chipere notes, all of the information they receive through their Freedom Fone service serves both as content for their news service and helps to inform future programmes.

"Platforms like Freedom Fone allow people to communicate, allow people to broadcast in one way or another without using the regulated frequencies that the broadcasting authorities are holding on to. The growth in IT will present us with many opportunities for self-expression and communication."

Role of Freedom Fone:

Connecting a MobiGater


  1. Ensure that the MobiGater is not connected to a power supply and is also not connected via USB to the computer. The computer that Freedom Fone has been installed on must also be switched off.
  2. Insert the SIM card into the bay inside the MobiGater.

  3. Make a note of the MobiGater IMEI and the telephone number of the SIM that has been inserted into it.
  4. Connect the MobiGater to the power supply
  5. Attach the MobiGater to the computer via the USB cable.


  6. If all is correct, the LEDs on the MobiGater will light up as follows: the LEDs under the power and USB icons will both light up red. The LED under the mobile phone icon will flicker red roughly every four seconds, as the SIM card polls the nearest mobile network tower.

  7. Turn on the computer
  8. If the Freedom Fone user interface is not already open, double click the Freedom Fone shortcut on the Desktop. Select Dashboard > GSM channels from the main Freedom Fone menu. The MobiGater you’ve just connected should be displayed. You may need to click the Refresh button a number of times to see this.

We have a known problem with some computer motherboards with regards to connecting multiple MobiGaters. Connecting multiple MobiGaters on some motherboards may result in concurrent voice calls interfering with each other.

See the Troubleshooting section if you are having difficulty connecting MobiGaters.

Modifying default settings

By default the MobiGater is configured to connect calls to the Voice menu with service number 4100. To direct your calls to another Voice menu, or to a Leave-a-Message IVR (LAM IVR) you will need to edit the /usr/local/freedomfone/xml_curl/dialplan.xml file.

For 2.0 users

gedit /usr/local/freedomfone/xml_curl/dialplan.xml

For 2.S users

gedit /opt/freedomfone/xml_curl/dialplan.xml

Look for this code snippet:

      <extension name="inbound_Mobigater1">
          <condition field="destination_number" expression="^5000$">
            <action application="transfer" data="4100 XML default"/>
          </condition>
      </extension>
      <extension name="inbound_Mobigater2">
          <condition field="destination_number" expression="^5001$">
            <action application="transfer" data="4100 XML default"/>
          </condition>
      </extension>
      <extension name="inbound_Mobigater3">
          <condition field="destination_number" expression="^5002$">
            <action application="transfer" data="2100 XML default"/>
          </condition>
      </extension>

You can see that the default values are 5000->4100, 5001->4100, 5002->2100. In version 2.0, this file will be created via the GUI once we implement ACL with the system.

Connecting a 2N OfficeRoute

Setup via web browser

The 2N® OfficeRoute is a GSM gateway that can be connected to Freedom Fone to enable you to receive calls and SMSs. After installing Freedom Fone on your computer you can proceed to configure the OfficeRoute. We recommend using a crossover cable and configuring the OfficeRoute using the Firefox browser installed on your Freedom Fone server.

The OfficeRoute can also be configured using a computer running Windows, a USB cable and the Windows utility provided on the CD with your equipment. 

Before you begin:

Setting Up

Be careful to not let the SIM card fall into the OfficeRoute - this can happen when you insert the card between the chassis and the gap (these can be removed by carefully balancing the OfficeRoute or opening with a screwdriver).

1. Configuration Wizard

If you are connecting to the 2N® OfficeRoute gateway for the first time or after a factory reset, the configuration wizard should appear.



Finish

That’s all we need to do for now, so select Finish from the menu on the left hand side and exit the configuration wizard. In order for Freedom Fone to accept calls from the OfficeRoute and direct them to the Voice menus you have created, you will need to modify the default configuration settings on the OfficeRoute.


2. Modifying settings via web browser


2a. Login

Now that the initial wizard configuration is completed, you can configure all the OfficeRoute parameters using the web browser interface. To establish connection with the OfficeRoute, enter the default IP address 192.168.1.1 of the OfficeRoute into the browser bar (if it does not work, try 192.168.1.46). After entering the IP address you should see a screen prompting you for a “Username” and “Password”. Username and Password are case sensitive.

Username: Admin
Password: 2n

Press the login icon.


2b. Clearing the browser’s cache

Sometimes your browser will not allow you to enter the Username and Password, instead it will keep redisplaying the Username it has cached in memory.

For Firefox users:
From the Firefox main menu select Edit > Preferences

Under Security ensure that the option to remember passwords for sites is off.

Under Privacy clear all history, including the cache.
Refresh the login page and the Username should now be blank.

2c. License

After a successful login, the network information page of OfficeRoute configuration application is displayed. You can return to this page at any time by selecting the Network tab at the top of the page.

On this page (see screenshot below) take note of the lines with the following settings:

“SIP” - adjacent to this the value should be Enabled
“Expires (hours)” - adjacent to this the value should be Unlimited or Never
“SNMP” - adjacent to this the value should be Enabled

If for any reason the three parameters have different values assigned to them please contact the dealer who supplied you with the equipment and request an unlimited licence with SNMP and POP enabled.

Uploading a licence to your OfficeRoute

If you have to request a licence from your supplier, it will be supplied in the form of a .key file. To upload the licence to your OfficeRoute, select the Administration tab at the top of the page. Select Upload licence from the menu on the left hand side. Use the browse button to locate and upload the key file provided by your supplier.


Also on the network information page, check to see that the firmware version running on your OfficeRoute is the latest available from 2N.

At the time of writing this guide the current firmware version is 2.3.13. You can view the firmware version under the System information section - check for the line which displays Version. If the version of firmware you are running is old you should download the latest from the 2n website: http://www.2n.cz/en/products/umts/officeroute/downloads/


2d. Upgrading Firmware

You can skip this section if you are running the current firmware version. Once you are done downloading the firmware, select the Administration tab at the top of the page. The page shown below should be displayed.


Select Update firmware from the menu on the left hand side and using the browse function navigate to your newly downloaded file, select it and click save from the options in the bottom right hand corner of the screen.

The loading process will start and should take about 5 minutes...be patient! Thereafter the OfficeRoute will reboot and you will be required to log in again. Once you are logged in, check to see that the version number has changed on the screen displayed. If not, repeat the upgrading firmware instructions.

2e. Synchronizing Time

In order for your call data records to be accurate you will need to synchronize the time of the OfficeRoute to that of the Freedom Fone server.

Select the Administration tab at the top of the page. Then select Synchronize time from the menu on the LHS of screen. A screen showing the time on the OfficeRoute and the time on the Freedom Fone server will be displayed. Click on the synchronize button to set the OfficeRoute time to the time of the Freedom Fone server.

2f. Uploading the backup file

Select the Administration tab at the top of the page. Then select Configuration backup from the menu on the LHS of screen. A submenu will be displayed beneath Configuration backup. Select Upload config. Browse for the backup file you found on the Freedom Fone desktop (look for a filename similar to backup_officeroute_2.3.11.tgz) and upload the file by clicking on the Upload icon. The process will take about 5 minutes after which the system will reboot.


After rebooting, the OfficeRoute will have the new default settings required for operation with Freedom Fone. The default IP address that Freedom Fone assigns to the OfficeRoute is 192.168.1.46. Hence, after uploading the backup file the IP address of the OfficeRoute will no longer be 192.168.1.1. To login again, you will need to enter 192.168.1.46 in your browser bar to access the OfficeRoute.

2g. Normalisation

The OfficeRoute can apply rules to the prefix of the incoming caller ID string (phone number) – allowing you to modify the OfficeRoute to work with phone number formats used in your country. The reason for this is to maintain consistency in the format of your call data records. Operators insert different prefixes at the start of the caller IDs (phone numbers) e.g. + or 00.

In order for your call records to be uniform regardless of the operator from which the call originates, it may be necessary to change the normalization settings. To do this select the Telephony Services tab at the top of the page. Next select GSM routing from the menu displayed on the LHS and Normalisation from the submenu that is subsequently displayed beneath GSM routing.

The screenshot below shows an example of normalization settings. In this example, any incoming caller ID number which begins with the pattern +420 will have +420 removed and a zero inserted at the beginning of the number.

The Remove count specifies from which point of the prefix the OfficeRoute should start removing digits. A remove count of zero means characters will be stripped from the start of the prefix value. In the example above, all digits in the specified prefix, starting from +, will be removed and a zero (0) be prefixed to the remaining number. In this case, the country code (+420) is removed and a zero (0) inserted to make up the local area code.

2h. Routing calls to Voice Menus

If you have followed all the steps above, you should be able to make a phone call to a SIM card previously inserted into the OfficeRoute, and have it answered by Freedom Fone’s default IVR menu. Note that the default IVR menu is assigned a service number of 4100.

By default the SIM card in slot #4 (GSM module - 4 in screenshot below) is configured to direct all incoming calls on this number directly to the Leave-a-message with service 2100. If you wish to change this setting so that SIM #4 points to your Voice menu [4100], you can change this by following the instructions below

After you’ve created your own Freedom Fone voice menus, you will want to redirect incoming calls via the OfficeRoute to service numbers associated with these menus (Freedom Fone voice menu service numbers are displayed on the IVR centre > Voice menu page). To do this select the Telephony services tab at the top of the page. Next select GSM routing from the menu displayed on the LHS and GSM from the submenu that is subsequently displayed beneath GSM routing. You should see a page similar to the one in the screenshot displayed below.


Use the pencil to the right of each row to change the service name of the IVR menu to that associated with your new Freedom Fone voice menu(s). When done, click the save button in the bottom right hand corner of the screen. As you will probably have figured out, it is possible to have each GSM module (SIM card) pointing to the same or a different IVR menu by changing the service name associated with the module. The Description field is for documentation purposes.

Having followed the steps to this point, you are ready to use your OfficeRoute with Freedom Fone.

3. Advanced Setup

The following is advanced set up and not necessary for basic use.

3a. Changing Admin user password

There are two ways of changing the default password of the OfficeRoute:

If you are connecting to the OfficeRoute for the first time, or connecting after a factory reset, you can use the OfficeRoute wizard.

The second way is to log into the OfficeRoute using the default username (Admin) and password (2n), then select the User Management tab at the top of the page to change these details.

The two methods are outlined below.

Important: Since Freedom Fone uses the password to authenticate with the OfficeRoute, you must modify a Freedom Fone configuration file to use the new password. Communication between Freedom Fone and the OfficeRoute will fail until you do so. Instructions are provided in the sub section entitled Modify Freedom Fone configuration file.

i. Using the Wizard

From the wizard’s LHS menu, select option 2, Administrator's password. You will be prompted to enter the new password twice and when done click on the save button at the bottom of the page.

ii. Changing Password using User Management tab

Select the User Management tab at the top of the page. Next select Users from the menu on the LHS. Use the edit function (pencil) on the row with user Admin. Enter the new password twice in the fields provided on the form and save.

3A1. Modify Freedom Fone configuration file

Use the command line terminal icon in Freedom Fone to go into terminal mode. (Click on the terminal icon in the centre of the title bar at the top of your screen). At the command line prompt type the following command:

For version 2.0 users

gedit /usr/local/freedomfone/office_route/config.php

For version 2.S users

gedit /opt/freedomfone/office_route/config.php

The config.php file should open in the gedit editor. Look for the code snippet shown below and change the 'pass' setting to the new password you have set for the OfficeRoute. Save and close the file.

If you are connecting more than one OfficeRoute you should change the other instances of 'pass' following the code snippet shown below.

$_OfficerouteParamSingle = array(
 array(
  'host'=>'192.168.1.46',
  'user'=>'Admin',
  'pass' =>'2n',
  'port' =>'110'
 )
);

3b. Changing the default IP address of the OfficeRoute

The default IP address assigned to a new OfficeRoute by the supplier is 192.168.1.1. If the Freedom Fone OfficeRoute backup config file has been uploaded to the OfficeRoute, the IP address of the device will be set to 192.168.1.46.

You can modify the OfficeRoute's IP address by selecting the Network tab at the top of the page. Next select Main configuration from the menu displayed on the LHS. Select the modify icon in the bottom right hand corner of the screen to edit details on this screen.

Important: Since Freedom Fone uses the OfficeRoute IP address to authenticate with the OfficeRoute, you must modify 2 Freedom Fone configuration files to reference the new IP address. Communication between Freedom Fone and the OfficeRoute will fail until you do so. Instructions are provided in the sub section entitled Modify Freedom Fone configuration files.

Remember to save your changes.

3B1. Modify Freedom Fone configuration files

Use the command line terminal icon in Freedom Fone to go into terminal mode.

i. At the command line prompt type the following command:

For version 2.0 users

gedit /usr/local/freedomfone/office_route/config.php

For version 2.S users

gedit /opt/freedomfone/office_route/config.php

The config.php file should open in the gedit editor. Look for the code snippet shown below and change the 'host' setting to the new IP address you have allocated to the OfficeRoute.

Save and close the file.

If you are connecting more than one OfficeRoute you should change the other instances of 'host' following the code snippet shown below.

$_OfficerouteParamSingle = array(
 array(
  'host'=>'192.168.1.46',
  'user'=>'Admin',
  'pass'=>'2n',
  'port'=>'110'
 )
);

ii. At the command line prompt type the following command:

For version 2.0 users

gedit /usr/local/freedomfone/config/officeroute_snmp_cake.php 

For version 2.S users

gedit /opt/freedomfone/config/officeroute_snmp_cake.php 

Look for the code snippet shown below and change the 'ip address' setting to the new IP address you have allocated to the OfficeRoute.

$config['OR_SNMP']= array(
  array('ip_addr'   => '192.168.1.46' ,
  'community' => 'public' ,
  'object_id' => '1.3.6.1.4.1.6530.4.2.2.1'
 )
);

Save and close the file.

3c. Changing the virtual IP address of the Freedom Fone server

By default the Freedom Fone server is allocated a secondary fixed IP address of 192.168.1.250 which is assigned as a virtual IP address to eth0:0

To view the server’s network settings, use the command line terminal icon in Freedom Fone to go into terminal mode. Type the following command:

ifconfig

Details will be displayed as shown in the screenshot below.

If you need to change the secondary fixed IP address allocated by default to the Freedom Fone server you must follow the steps below.

Note though, that you can modify the OfficeRoute SIP server setting to refer directly to the primary IP address of the Freedom Fone server instead of the secondary fixed IP address. If you are having problems with your setup, try taking this step (3d) before modifying the secondary fixed IP address.

Use the command line terminal icon in Freedom Fone to go into terminal mode.

i. At the command line prompt type the following command:

gedit /etc/rc.local

Look for the code snippet shown below and change 192.168.1.250 as required for the interface aliasing for the OfficeRoute.

/sbin/ifconfig eth0:0 192.168.1.250 netmask 255.255.255.0 up

Save and close the file.

ii. At the command line prompt type the following command:

For version 2.0 users

gedit /usr/local/freeswitch/conf/sip_profiles/officeroute.xml 

For version 2.S users

gedit /opt/freeswitch/conf/sip_profiles/officeroute.xml 

Look for the code snippet shown below and change 192.168.1.250 as required

<!-- ip address to use for rtp, DO NOT USE HOSTNAMES ONLY IP ADDRESSES -->
<param name="rtp-ip" value="192.168.1.250"/>
<!-- ip address to bind to, DO NOT USE HOSTNAMES ONLY IP ADDRESSES -->
<param name="sip-ip" value="192.168.1.250"/>

Save and close the file.

Don’t forget to update the corresponding setting on the OfficeRoute by following the next step, "Change the SIP server setting on the OfficeRoute."

3d. Changing the SIP server setting on the OfficeRoute

If you do not want to use the default IP settings for the Freedom Fone server (a secondary fixed IP address of 192.168.1.250 which is assigned as a virtual IP address to eth0:0), you can modify the default SIP server setting used by the OfficeRoute to communicate with the Freedom Fone server.

Select the Telephony Services tab at the top of the page. Next select Devices from the menu on the LHS and SIP lines from the submenu that is subsequently displayed beneath Devices.

Use the edit icon (pencil) to change the IP address of the SIP server from 192.168.1.250 to the primary IP address of your Freedom Fone server.

Save your changes.

Create voice menus

Now that you have designed an architecture for how you will use the various components of Freedom Fone to design an information service, you will need to think about creating voice menus.

The last thing that you want when building a voice menu is to bore your audience or even worse let them get lost in the menu.

To build a successful menu:

Here is an example of an efficient voice menu:

"Welcome to the Cholera epidemics emergency information service ; this information is updated twice a day. Please listen carefully to the following five options"

For more information about how to create voice menus in the Freedom Fone software, see the Chapter Voice menus in the Setting up section.

Female voices

When considering the voice that will be used on the audio menus (the host), consider choosing someone who the audience likes and can connect with - in our experience callers prefer to hear a female voice as a host.

Language Selector

The Language Selector helps you manage multilingual voice menus.

If, for example, you want to deliver your voice menus in English and Swahili, you would first need to create separate content files and voice menus for each language. Thereafter, you can link the voice menus using the Language Selector.

To create a language selector, navigate to IVR Centre > Language Selector. On the page shown below, click on the Create New button.

On the next page, shown below, you enter the name of the Language Selector and upload the audio files for the instructions and the invalid message.

At the bottom of the page, under Menu Options, select the type of service (Voice menus, Leave-a-message menu, Content) you wish to link to the top menu of your language selector. If you have created the same voice menu in different languages, you would select Voice Menus from the pull down menu.

Once you have made a selection, further options will become available to you, enabling you to set up navigation for your voice menus. Save the page after making your selections.

Once you have created a Language Selector you can return to edit it using the edit icon on the Language Selectors page. You will note that the Edit Language Selector page looks just like the Edit Voice Menus page.

Design your service

Now that you know your audience's needs and you have an idea of where your information sources are coming from, it's time to design the architecture of your service. Freedom Fone software makes available a variety of components to help you interact with your audience. You can build your Freedom Fone Service out of a combination of any number of these components (see sections Real life examples and Other possible scenarios for examples of how others have used these components to create their Freedom Fone Services):

Sketching it out on paper

One of the best ways to get an idea of how these components fit together as building blocks in your Freedom Fone Service is to draw it out on paper. (For an example of how Voice Menus can be organized into a service see chapter Voice Menus in the Setting up section).

Putting your ideas on paper is helpful because several people can work together, it's easy to illustrate your ideas and can help simplify and clarify the creation of your service.

In our experience, you need an operational staff member or volunteer to maintain the system. Ideally, their roles should be thought of as an outreach officer to your audience.

Resources they will need:

For more information see chapter Staffing your Service.

How often to update your information?

See the chapter: Organise your staff.

Plan to refine your service

Your Freedom Fone Service is a continually evolving creation - as your audience grows and changes, so should your service. Conducting surveys with some of the "top callers" who use your service frequently can be an excellent way to get insight into what people like about your service - consider consulting your top callers when you are ready to make some changes to your service. Call data records (CDR) and Freedom Fone's inbuilt System data can provide you with comprehensive statistics that will give you an idea of how people are using your system. See the chapter on Monitoring and Evaluation for further information on this topic.

Election monitoring

As of June 2012, SODNET in Kenya are working to integrate Freedom Fone into the Uchaguzi platform that is now being used in 4 different African countries to monitor elections. Uchaguzi is a civic platform that uses multiple channels to crowd source information, document violations and mobilise resources to address problems raised by accredited monitors or the general public.

National elections are highly fraught events in many countries. Electoral fraud, vote buying, intimidation, violence, media censorship and abuse of government resources are some of the issues that plague these events.

Freedom Fone can be an important addition to the platform as it allows an organisation's staff, trained monitors or the general public to get involved if there is a critical event or situation thanks to the Leave-a-Message function. Reporting via voice messages can be easier to do while remaining vigilant and staying out of harm's way and the organisation can always follow up on a caller's message to verify and clarify information.

Voice Menu functions can also provide a useful service to rural and/or disconnected audiences by providing information on demand news updates as an election unfolds. This would be particularly valuable to callers as an alternative to highly politicised broadcast channels. Election monitors and staff can also benefit from this service once they are in the field and disconnected from their usual sources of information.

Freedom Fone's Security functions allow an organisation to limit access to callers' personal details to trusted staff while allowing other staff and volunteers to read the content of SMSs and listen to voice messages. This prevents the abuse of information that could jeopardise the identity and whereabouts of monitors or callers.

Resources needed

Equipment

Staff and Competencies

Role of Freedom Fone

Enhancing business opportunities

Tina has just started ZimOut: an entertainment magazine that covers events, an eat-out, cinema and festival guide in her hometown Harare. For a while she has been struggling to cover print costs and distribution in a city where there are already two established magazines that deal with events and entertainment.

Both of her competitors already reach a young middle-class audience who are internet savvy and only attend established and pricy venues. After hearing about the successes of Freedom Fone at her local community radio where her friend Joe works, Tina decides to try a little experiment. She sees a chance to use Freedom Fone to target a wider audience to complement her magazine. Besides the usual "hype" places, she plans to promote interesting, less frequented venues and events, while attracting more advertising. Can it work?

After downloading the latest version of Freedom Fone from the website (what has she to lose, after all it's free!) and investing in a one sim-card MobiGater – the cheapest option that will suit her trial version - she begins to plan her rocking new service.

The idea is for a ZimOut hotline that anyone can call at any time, night or day, and receive instant, up-to-date information on events, eating-out, films, gigs and upcoming events. The service uses the Voice Menu functions:

"To find out what is going on tonight in your area, press 1; to listen to the latest review of best restaurants, press 2." etc.

A final option encourages callers to Leave-a-Message and share their feedback and experience, with the added incentive of winning a free year subscription to ZimOut for the most interesting story.

On each monthly edition of her magazine Tina dedicates a margin on the back cover to advertise the ZimOut hotline. To create more publicity, she also asks Joe at radio to publicise the ZimOut hotline in their daily broadcasts. Within no time at all the service is receiving up to 300 callers a day and has a number of entertaining text messages and soundbites for Tina to include on both her print and website edition.

Wilfred and Sheila, an elderly couple who have become avid subscribers to ZimOut for its entertaining stories and regular callers to the hotline had this to say:

"ZimOut is just for us. Before we hardly ever went out because we never knew what was on and when and what sort of service to expect. Now, we can easily find out what's happening when we want."

Soon advertisers are interested in this new, interactive space and are asking to be featured on the ZimOut hotline. With the added revenue, Tina decides to upgrade to a 4-sim card OfficeRoute; she keeps two lines open for the ZimOut hotline, keeping advertising to a minimum so as not to turn-off callers with longer and more expensive menus. She then offers the two other lines to post classifieds and to promote events for a fee.

ZimOut has now become the most popular entertainment magazine in Harare, using its print and online editions to run interesting features and reviews while running their Freedom Fone hotline as both an advertising and informative entertainment space.



Resources needed

Equipment

Staff and Competencies

Advertising costs

Role of Freedom Fone

Equal Access

Equal Access (www.equalaccess.org) works with marginalised populations through the use of innovative technology to create positive social change. They are using diverse communications strategies to inspire communities to promote economic development, human rights, womens' empowerment, youth engagement and encourage positive action.

Equal Access has been using Freedom Fone in Cambodia and Niger since 2010. Both countries share extremely low levels of Internet penetration. Although Equal Access uses a combination of traditional broadcast and new media technologies for their programmes, mobile phones have proven to be the best way to engage marginalised audiences.

The programme "Our Community Voice: Many Voices, One Community" in Cambodia covers topics relevant to the youth; in Niger, Freedom Fone is used to support a religious programme covering the issues of extremism and religious conflicts, promoting peaceful dialogue and tolerance.

Graham Gardner, programme manager for Equal Access, was particularly interested to apply the voice functions in Freedom Fone as a way to interact with audiences who may struggle with text-based mobile technology such as SMS.

"Mobile phones are increasingly used throughout all of these countries but literacy is a problem in places like Niger and Chad. Even in Cambodia, about 20 to 30% of people cannot read. But a bigger problem here is the fact that Cambodia uses a non-latin script which is not so widely used in technological formats," explains Gardner.

Although there are mobile phones available that allow audiences to produce text messages in Khymer script, they are not widely used. Even for literate Cambodians, many don't know how to read an English or phonetic Khymer message using latin script.

The Voice Menu functions in Freedom Fone allow Equal Access to be a lot more inclusive with their mobile programmes. "Our Nigerien staff described it as somewhat discriminatory that we only had SMS available to users. So once we brought our Freedom Fone system online, we were being more inclusive in terms of allowing those audiences that wanted to share their comments to call our line and leave a voice message rather than having to write in text."

The Cambodian programme received over 4,000 calls in 6 months out of which 50% left a message. Same success in Niger, where 60% of the 2,000 calls ended with a message left. The agreement Equal Access concluded with the mobile operator Orange in Niger for a toll free number, hence tackling the issue of call cost, had an immediate impact on the frequency of calls.

Equal Access makes the most of the 2-way communication with their audiences made possible by Freedom Fone: they use it to gather feedback and build a community commentary: "People thoroughly enjoyed it when we updated the system with other callers' comments. These community comments would start conversation. "

Freedom Fone is also used to help test the impact of a message and the effectiveness of a campaign. The way audiences react helps them inform their content. "This is a way of educating the audiences about the topics we are covering but also to creating an interactive feedback whereby we are providing an audience with information and they in return are providing us with new ideas, commentary and general questions about our programmes. This is then fed into the production of future content so it creates a cycle or loop."

Freedom Fone offers easily accessible call data records, monitoring and reporting functions that provide a treasure trove of information to help gauge the relevance and actual value of any programme and how communities are receiving and interacting with a particular service.

"For us it's really all about creating a connection with the audience, creating interaction between our work, the work of our partners and the people we are trying to serve. It is also about shared learning for us and any tool that allows us to do that is a good one so we will absolutely continue to use Freedom Fone."

Role of Freedom Fone:

Equipment

Freedom Fone is free, simple to install and easy to use. The basic setup is portable (you do need a power supply though) and requires very little to get up and running.

If you'd like to see how Freedom Fone works without installing it, you can try our online demo: http://demo.freedomfone.org

Equipment setup and costs

If you decide to install the software and set up your own Freedom Fone installation, here's what you will need and some approximate costs:


Notes:
1. Freedom Fone does not run on Mac hardware and we recommend installing on non-Macintosh computers.
2. Backup inverters must be of the pure sine wave type.

For procedures to install the Freedom Fone software, hardware requirements, connecting your hardware and testing your SIM cards - see the section Technical stuff.

What does my audience need?

Updates and maintenance

From time to time you may encounter technical challenges and it is therefore a good idea to have someone technical help purchase, install and set up your Freedom Fone service. The software is periodically updated as new features are released or bugs fixed. For these reasons, it is recommended to have access to a technical person when deploying Freedom Fone (for more information on staffing issues see the Organize your staff chapter).

FAQs

This chapter aims to address frequently asked questions relating to Freedom Fone.

Can I use the Freedom Fone computer for other things?

It is recommended that the Freedom Fone computer is only used for Freedom Fone. This is because Freedom Fone is resource intensive, and so if other applications are sharing the system resources, this may interfere with the calls.

Where can I get technical support?

Please see our "Support" chapter for information on how to get answers to your questions.

Why does the menu option selection not appear to work? 

Some mobile carriers do not send the DTMF (the tone when a key is pressed) correctly, and Freedom Fone is unable to determine what selection the caller has made.

Farm Radio International

Farm Radio International (www.farmradio.org) is a Canadian-based, non-profit organisation, that assists small scale farmers in Africa with food security. Farm Radio works with over 290 partner radio stations across Africa to train broadcasters, create radio scripts and conduct educational radio campaigns on agricultural topics that can improve the livelihoods of farmers.

"...there are a few shortcomings of radio: if you miss the show, you miss the info; with radio it is not possible to make information available on demand. Radio also lacks a reliable channel for interacting with listeners. This is a pitfall for Farm Radio because although radio is the primary 'media' source of information for farmers, we know that their favourite source is their peers - other farmers!"
-- Bart Sullivan, ICT and Radio Specialist at Farm Radio International

Since January 2010, Farm Radio has been using Freedom Fone to increase the impact of their educational radio programmes and involve more farmers' voices.

The Kuku Hotline, Tanzania

Early in 2010, Radio Maria in Tanzania conducted a campaign on best practices for small scale poultry farming. One specific objective was to help decrease chicken death rates from 60% to 20% with simple, low-cost, very practical advice.

In partnership with Radio Maria, Farm Radio decided to hold a competition to assess how the poultry farmers of the area had been impacted by the campaign. The competition was set up using Freedom Fone's Leave-a-Message (LAM) function and was advertised on-air through a series of radio jingles.

Farmers were invited to call in and comment on the impact of the campaign and asked what they intended to do to improve their farming practices. Awards to winners were 20 colourful Kuku Hotline T-shirts.

"First, I plan to build a proper house for my chickens to keep them safe and care for them - the money I get from their eggs, I will use to improve my business. Secondly, I will open a bank account to save money for my children's school fees. Thanks to the Kuku Hotline, thank you"
--
Neema Mbise, One of the winners, Chicken Farmer in Morogoro, Tanzania

The service received over 1,400 calls in one month. On the final two broadcasts of the campaign, the 20 winning messages were broadcasted on Radio Maria.

The Kuku Hotline became popular because it included the actual voices of farmers on the radio. This encouraged Radio Maria and Farm Radio International to use Freedom Fone to make radio more interactive and create more participatory radio campaigns.

Farmers Phone, Ghana

In Ghana, the Voice Menu function of Freedom Fone was used to share a variety of agricultural information with farmers in two local languages: Akan and Ewe. The farmer could select from a variety of menu choices:

"By providing farmers with up to date market prices they can make informed decisions. For example, once I know that my sweet potatoes would sell for 1.2 dollars/kg in the Abotoasi market and 1.4 dollars/kg at Akatsi market, which is 20 km further from my home, I can decide whether it is worth arranging transport to go the extra mile to Akatsi or not - it might still be too far away!" says Sullivan.

Between January and April 2010, the service received over 4,500 calls. There was a group of about 50 farmers who used the service consistently from week to week and it would take them about two minutes to get the market price information they wanted before ending the call.

Most calls were received before 6 am in the morning, when calls are cheaper. Although call costs remain a challenge, farmers still used the service because they were getting actual value from the information provided.

"We provided farmers with information that was really making a difference to them. And the radio stations we partnered with naturally had the skills and equipment for audio scripting, recording and editing. For them, using Freedom Fone proved very easy," explains Sullivan.

Today, Farm Radio International continues to use Freedom Fone for agriculture related information and have extended their reach to Mali. Opportunities in Uganda and Malawi are also under consideration.

Role of Freedom Fone

Glossary

A

Allison Voice - A female voice used by Cepstral Voice for voice synthesis.

API - Application Programming Interface - An interface employed by a software application to enable interaction between itself and other software.

Archive - A file, usually compressed, containing multiple files.

B

Backend Sweeper - A service that runs behind the scenes to remove caller records and logs from the system at regular intervals.

BIOS - Basic Input Output System, provides low-level computer configuration.

Bug - Program behaviour other than expected or desired.

Bug Report - Usually an e-mail or an entry in a bug database asking for help with a specific bug. Good bug reports state what software was used (Linux distribution and version, application name and version), what the user tried to do and what was the expected result, what happened instead, and what the user tried in order to fix it. It is particularly helpful to explain how to reproduce the problem, if it is repeatable. Log files of the incident should be attached.

C

Cache - A cache is a part of an information-processing system used to store recently used or frequently used data to speed up repeated access to it. A Web cache holds copies of Web page files.

CDR - Call Data Records

Cepstral Voice - A voice synthesis service to convert text into audio.

Command - Executable file or shell builtin.

Cron or cronjob - A command to be executed automatically on a schedule set with the cron command or one of its variants, such as anacron.

Crossover Cable - A computer network cable that is used to connect two network devices directly to each other without the need for a network router.

CSV - Coma Separated Value - A simple format for a spreadsheet. CSV files are text files where each cell is separated by a comma, and each row is separated with a return. This very simple format is understandable by many different programmes.

D

Default - A value that is used when an input has not been provided.

Demo site - A website that allows you to test and explore the functionality of a piece of software.

DTMF - Dial Tone Modulation Frequency. The tone that is made when a key is pressed on a telephone during a call.

F

Firefox - Firefox is the most popular free and open source Web browser, developed by the Mozilla Foundation. 

FLOSS - Free/Libre Open Source Software, licensed so as to guarantee the essential freedoms of software users to source code and reuse. A combination of Free Software and Open Source Software, with Libre added in to emphasize that software freedom is essentially a matter of rights, not price.

Forum - A web-based online discussion tool.

Freedom Fone Service - Describes the information service an organisation is providing for a target audience using Freedom Fone.

FreeSWITCH - The technology used to handle incoming calls and direct them to the appropriate destination.

Frontend Sweeper - A panic button that is used to replace all caller identity information with arbitrary values.

Functionality - The set of tasks that a piece of software can perform.

G

GBV - Gender Based Violence

Gedit - A simple and easy text editor for GNOME. It is UTF-8 compatible, provides tools for editing source code and can be extended using plugins.

GSM - A technology used behind mobile communication

GUI - Graphical User Interface - User interface offering windows, icons, mouse control, multiple fonts, and so on.

I

ICT - Information Communication Technology

IMEI - An unique identification number used in all GSM devices, similar to a serial number.

IP Address - Internet Protocol Address - An IP address is a number identifying a particular computer on the Internet. In the previous version 4 of the Internet Protocol an IP address consisted of four bytes (32 bits), often represented as four integers in the range 0-255 separated by dots, such as 74.54.30.85. In IPv6, which the Net is currently switching to, an IP address is four times longer, and consists of 16 bytes (128 bits). It can be written as 8 groups of 4 hex digits separated by colons, such as 2001:0db8:85a3:0000:0000:8a2e:0370:7334.

ISO - A copy of the contents of a media (typically a CD or DVD) for downloadable purposes, and is then used to create copies.

ISP - (Internet service provider) is a business or organization that provides access to the Internet for its customers. 

IVR - "press 1 to access your account, press 2 to speak to a representative ..." The term IVR refers to phone systems we all have to deal with when we dial in to for example top up our mobile account, or talk to tech support. The letters in the acronym stand for Interactive Voice Response. An Interactive Voice Response System is therefore a voice menu structure using dial tones to make selections.

K

Kernel - The Linux kernel, core of the GNU/Linux operating system. kernel.org

L

LED - Light Emitting Diode is a small indicator light.

LHS - left-hand side

Linux - A type of operating system (other common operating systems are Windows and Mac OS). Linux has been popular as a web server for a long time and is now gaining popularity on personal laptops and desktop computers. Linux is free software and open source.

Localisation - The process of translating a product into different languages or adapting a language for a specific country or region. This is done by translators with no need for technical wizardry.

M

MAC - A unique code that is assigned to a network device.

MobiGater - A USB GSM device that accepts a SIM card and allows Freedom Fone to communicate over the mobile channel

MSDSIN - Mobile Number

N

Newfies - A dialler platform that is used to trigger outbound calls.

NGO - A legally constituted non-business organisation with no participation or representation from government. In the United States, this type of organisation is more often referred to as a Non-profit. They may be also called civil society organisations or not-for-profits.

NIC - Network Interface Card allows a device to be connected to a computer network.

O

OfficeRoute - A SIP GSM device that accepts 4 SIM cards and allows Freedom Fone to communicate over the mobile channel

P

PO - Portable Object file extension

POedit - software recommended for the translation/localisation of the Freedom Fone GUI (produces the PO file extension)

POP3 - Post Office Protocol 3, sometimes referred to as just "POP", is a simple, standardized method of delivering e-mail messages. A POP3 mail server receives e-mails and filters them into the appropriate user folders. When a user connects to the mail server to retrieve his mail, the messages are downloaded from mail server to the user's hard disk.

Prompt - a prompt is short sentence you use in your voice menu "to get information on HIV/AIDS, press 1" is a prompt.

S

Screenshot - An image of the current display on a computer screen highlighting a specific scenario.

Script - A script is a program, usually written in an interpreted, non-compiled language such as JavaScript, Java, or a command interpreter language such as bash. Many Web pages include scripts to manage user interaction with a Web page, so that the server does not have to send a new page for each change.

SIM Card - A small chip that sits inside the mobile phone that holds your mobile subscriber identity.

SIP - Session Initiation Protocol

SMS - Short text messages limited to 160 characters sent by mobile phone to mobile phone

SNMP - Simple Network Monitoring Protocol

T

Toggle - In computing, a key or command that is operated the same way but with opposite effect on successive occasions.

U

Ubuntu - A variant of Linux

UI - User Interface

URL - The URL (Uniform Resource Locator) is the address of a Web site. For example, the URL for the World News section of the NY Times is http://www.nytimes.com/pages/world/index.html. Many censoring systems can block a single URL. Sometimes an easy way to bypass the block is to obscure the URL. It is for example possible to add a dot after the site name, so the URL http://en.cship.org/wiki/URL becomes http://en.cship.org./wiki/URL. If you are lucky with this little trick you can access blocked Web sites.

USB - universal serial bus, a standardized technology for attaching peripheral devices to a computer.

V

Version - Updates to software are released periodically, and these releases are referred to as a version of the software. There are different types of version, for example the most recent release of a software which has been tested and is intended for general use is referred to as the stable version, while a very new untested version is the alpha version. 

W

Wiki - A web-based software that enables anyone to edit content via a web browser. Wikipedia is the best known example of a wiki.

GSM device

Phone number not available

Go to the Dashboard > GSM channels screen in the Freedom Fone user interface to check the signal level associated with the SIM card you are calling.

On the tables that appear, look for the Signal level column.

For the OfficeRoute

Signal level values for the OfficeRoute can be poor, good or excellent. If the signal is poor please find a better location for the OfficeRoute or extend your aerial to a place where you can get better reception.

Also check that the IMSI number is present for each SIM card in the OfficeRoute. If not, shut down both the computer and the OfficeRoute, ensure that the SIM cards are properly seated and power up your devices again.

For the MobiGater

Signal level values for the MobiGater should read 2 or higher for satisfactory performance. If the signal level value is lower than 2 please find a better location for the MobigGater device.

Also check to see if both the IMSI and IMEI values are populated on the MobiGater tables. If not please shutdown your computer and power down the MobiGater device. Ensure that the SIM card is properly seated and then reconnect the device and power up again.

Calls continuously ring

There are many causes for this problem and we have outlined them in the logical order in which you should troubleshoot.

  1. An expired License or a not fully licensed OfficeRoute causes calls not to be transferred to the Freedom Fone. To check that you have a full License enter the IP address of the OfficeRoute in a browser and log in. Under the network tab check to see that SNMP is enabled as well as that the License has not expired. If you find that your license has expired or that you don't have all features enabled please contact your supplier of the OfficeRoute.
  2. eth0:0 which is the network alias has to be set on the computer running Freedom Fone in order for Freedom Fone to communicate with the OfficeRoute. If you issue an ifconfig command (click on the Terminal icon in the centre of the title bar at the top of the Freedom Fone desktop screen) and you do not see a reference to eth0:0 with an IP address of 192.168.1.250 on the output, follow the instructions on setting the network alias given in this document.
  3. If FreeSWITCH has stopped running Freedom Fone will not communicate with the OfficeRoute. From Freedom Fone navigate to: Dashboard → Health, on the interface that appears, check to see if both the Freeswitch and the dispatcher are running. If both are running a green tick will show against each, if not a red circle will show.

If the FreeSWITCH has stopped for some reason, open the command terminal and issue the following command:

service freeswitch restart

The following message should appear after running that command:

Freedom Fone: Starting Freeswitch freeswitch

If the dispatcher has stopped, run the following command from the command terminal:

/etc/init.d/dispatcher_in reload

This command should be followed by an output shown below:

Freedom Fone: Stopping dispatcher [OK]
Freedom Fone: Starting dispatcher [OK]

After issuing the above commands navigate to Dashboard > GSM channels, refresh the page and check if the MobiGaters / OfficeRoute have registered to your local current time. NB: It may take several refreshes before the GSM devices register.

When done, try calling the numbers inside your GSM devices.

If the SIP server IP address is not set to the IP address of the computer running Freedom Fone, calls to the OfficeRoute will ring continuously. To rectify this open the OfficeRoute interface by typing the IP address of the OfficeRoute into the browser URL window.

An OfficeRoute interface should appear, login with the correct username and password. The default username: Admin and the password; 2n.

From the office route interface click on the “Telephony services” tab at the top of the page.

On the interface which appears , look to your left and navigate to Devices > SIP lines

Use the edit function to edit the IP address of the SIP server. This address should be the same as for the computer running Freedom Fone.

Calls immediately cut off after one ring

This can be caused by a call that is routed to an IVR menu that does not exist. It may be due to an IVR being accidentally deleted during operations.
From Freedom Fone navigate to ; IVR Centre > Voice Menu. On the interface that appears ensure that there is at least one IVR menu set. If none is set, create one using the create button.

For the MobiGaters

If there is at least one IVR menu set on the interface and yet calls keep cutting off, please follow the instructions below:

Open the command terminal and enter the following command:

For version 2.0 users

gedit /usr/local/freedomfone/xml_curl/dialplan.xml

For version 2.S users

gedit /opt/freedomfone/xml_curl/dialplan.xml

This should launch the gedit editor with the contents of the dialplan.xml file displayed. Scroll down the file to a section with a subtitle “Inbound MobiGaters”. The section should look like the code snippet shown below

<!-- INBOUND MOBIGATERS -->
<extension name="inbound_Mobigater1">
 <condition field="destination_number" expression="^5000$">
  <action application="transfer" data="4100 XML default"/>
 </condition>
</extension>
<extension name="inbound_Mobigater2">
 <condition field="destination_number" expression="^5001$">
  <action application="transfer" data="4100 XML default"/>
 </condition>
</extension>
<extension name="inbound_Mobigater3">
 <condition field="destination_number" expression="^5002$">
  <action application="transfer" data="2100 XML default"/>
 </condition>
</extension>

The IVR service numbers that are highlighted above should correspond with the IVR service numbers that exist on your Freedom Fone server. Make sure that the service numbers shown in your dialplan.xml file exist on your Freedom Fone. If the dialplan is directing calls to a voice menu that does not exist simply edit the service number to a valid IVR service number. If you want to direct a specific MobiGater to a Voice Menu other than the default 4100/ 2100 you can simply change the service number to the desired service number of the voice menu you have created.

For the OfficeRoute

If you check the Voice Menus page of the Freedom Fone and see that there is at least one IVR Menu set please follow the instructions below:

Open the OfficeRoute web interface by typing the IP address of the OfficeRoute into the browser URL window. Login by entering the username and password. The default settings are:

username : Admin
Password : 2n

After successfully logging in, click on the “Telephony services” tab at the top of the page . On the page that appears look to your right and click on the GSM routing link, under the link click on GSM.

On the interface which appears ensure that each GSM module is directed to an IVR service number that exists on the Freedom Fone. You can use the edit function to the right of each row to specify the service number of the IVR.

Calls going through but audio being played by laptop speakers

Some laptops may experience a problem in routing the audio back to the caller after answering a call. The audio is then routed to the speakers of the laptop instead of back to the caller via the phone. The caller will experience silence on her phone although the phone will show that a call is in progress. This is an issue to do with the USB of the laptop and is usually experienced when running two MobiGaters on adjacent USB ports. To rectify this follow the instructions below:

  1. Shutdown laptop and power off MobiGater
  2. Remove one of the adjacent MobiGaters and plug it in another USB which does not have anything connected adjacent to it.
  3. Reboot your Laptop and start MobiGater.

OfficeRoute does not display on GSM channel page although inbound calls being answered

This is usually the case when you change the default IP address of the OfficeRoute 192.168.1.46 to something else. Freedom Fone uses the IP address of the OfficeRoute to capture setting information such as IMSI number, Network registration,Operator and Signal level.

To rectify this open and edit the config.php file using the following command:

For version 2.0 users

gedit /usr/local/freedomfone/gui/app/config/config.php

For version 2.S users

gedit /opt/freedomfone/gui/app/config/config.php

Change the IP address of the OfficeRoute in the config.php file to the new IP address that you have assigned the OfficeRoute. The section you edit should look like the code snippet shown below;

config['OR_SNMP']= array(
  array('ip_addr' => '192.168.1.46' ,
      'community' => 'public' ,
      'object_id' => '1.3.6.1.4.1.6530.4.2.2.1'
      ));

When done save the file and refresh your GSM channels page on Freedom Fone, you should see the registered OfficeRoute.

Installation

Installation does not start

If you notice when installing that your computer loads straight back into your previous operating system, there may be an issue with your BIOS boot order settings. 

The instructions on how to get into the BIOS settings varies for different computer models. Please consult your computer's manual for more instructions.

You may also fail to see the first screen in the Installation sequence if your Freedom Fone install DVD has defaulted to LiveCD mode. This happens by default if you wait too long before selecting the Install Custom Live CD option.

Installing the software

As a start, whether you just want to try and evaluate Freedom Fone or install it for good, the first step for you is to get a proper Freedom Fone installation DVD. For that, you can either download the software as an ISO file from the Freedom Fone website www.freedomfone.org/downloads or, if you have bandwidth constraints, you can request the DVD to be sent to you directly by Freedom Fone. Just send an email to info@freedomfone.org!

If you choose to download the software, you need to burn your Freedom Fone installation DVD. To do so, remember that ISO files are disk image files: do NOT try and 'file copy' the image directly to a DVD - it must be written as an image file to the DVD. Use the Record a disc from disc image feature from your disc burning software.

... Got it?

Getting Started...

Note: before you start using the DVD, we recommend you back up your computer as a common security procedure.

Once you have your Freedom Fone installation DVD, just insert it into the DVD drive of your computer and reboot your machine. The system will boot from DVD and the screen below will appear, displaying different options you have to get started with Freedom Fone:

Evaluating Freedom Fone

If you only wish to play around with Freedom Fone, without installing the software, just do not do anything when the above screen pops up. The LiveCD option is the default option and it will automatically go into live mode - you might have heard someone mention "running a system live": this simply means running the software from the installation media - such as a CD/DVD - without installing it on your hard drive.

You can then play with the Freedom Fone interface in the live mode, and when you are done shutdown and eject the DVD.

Please always remember that the LiveCD option does not install Freedom Fone permanently to the hard drive.

Installing Freedom Fone

To install Freedom Fone, select the option which lets you install on your hard drive: install - start the installer directly and press the Enter key. Then follow the steps below.

This procedure will install both the Ubuntu Operating system and Freedom Fone on your computer.

Important warning: remember that Freedom Fone is a system replacer which requires a dedicated computer; the installation will erase from your hard disk your existing operating system, together with all your data. Make sure you have backed up your important data before you start the installation procedure.

Install Procedure

Please note that during the installation process, the system might take some time to move on between each screen; this depends on the hardware specifications of your computer.

SCREEN 1

The first screen that comes up prompts you to select the language to use during installation.

English is the language selected by default, but you might want to choose another one. Do so, and press Enter or Forward.

SCREEN 2

The next screen you'll get to see is the location map.

Select your location, either from the map or using the pull down menu. Press Forward.

SCREEN 3

This screen is for your keyboard layout.

Select the option that suits you best, and Press Forward.

SCREEN 4

The next screen allows you to choose whether you want to install Freedom Fone on the entire hard drive or side by side with another operating system that may be on your PC already. We strongly discourage that you install Freedom Fone side by side with another operating system for a live deployment. For demonstration purposes you may do so but this is a complex process which requires specific knowledge about computer partitioning. Only for advanced users!

For now, select the Erase and use the entire disk option.

Remember that this will erase all that is on your hard disk, including the operating system. If you have not saved your data at this stage, select the "Quit" button to quit the installation process and restart from the beginning of the procedure after you have cleared up your computer.

Otherwise, press Forward.

SCREEN 5

After selecting to use the entire disk, you are taken to the next screen which prompts you to set up your user name and password, and name your computer:

  1. Type in your name and the username you want to use each time you log onto Freedom Fone.
  2. Take time to select a solid password as your system may carry information that could be a security concern if accessed by unauthorised users.

Here are a few tips for a safe password:

  1. Set the name of your PC making sure that the name you choose does not include any spaces.
  2. For log-in options, we recommend that you choose the option require a password to log in for security reasons.

Press Forward.

SCREEN 6

This will only be seen in the case of side-by-side installations.

SCREEN 7

The last screen will complete the installation.

Make sure you are happy with all the choices you made on the previous screens (language, login name...). If you are not, press Back and repeat the steps 1 to 6 above. Otherwise, press Install.

The actual installation process begins. The installation may take a while depending on the hardware specifications of your machine.  

Once installation is completed, the system will automatically eject your DVD and you will be prompted to restart your system.

Logging in

After restarting, here is what you will see:

Occasionally Ubuntu might fail to restart the first time after installation. If this is the case, just manually reset your machine, and it should reboot successfully. At the log in prompt, enter the user name and password you have set in the installation process.

After logging into Ubuntu, click on the Freedom Fone icon on the desktop to launch the Freedom Fone administration page. Freedom Fone version 2.S comes with a login screen to restrict access to unauthorised users.

The default username and password are as follows and can be changed later through the User management interface

User name: Admin
Password: thefone

Once you have successfully logged in you can move on to the next chapter Preparing SIM cards before you set up your GSM device(s).

Introduction

Freedom Fone is designed to get an information service up and running rapidly, within a matter of hours of installing the software. You can just go ahead and do this and it can prove to be very effective with very little planning or set up. This makes Freedom Fone ideal for contexts where rapid deployment is necessary. However if you have the time and resources you may wish to consider spending more time on planning and producing your Freedom Fone information.

If security of information from and about your audience is a big issue then look at the chapter on security.

If you decide to dedicate the resources to planning then this section outlines the steps you can take to create your information service:

Know your audience

The most important part of your Freedom Fone Service is knowing your audience. As you build the service, it is your audience who will be calling in to use it, so it is worth spending some extra time to get to know more about them. The better you know your audience and their information needs, the more effectively you can design the service so that it works for them!

The following are some thoughts for you to consider as you get to know your audience better.

What languages do your audience speak?

It is possible to make your Freedom Fone Service available in multiple languages to reach a wider audience; this also increases the amount of work required in preparing audio content. Decisions about what languages you will provide your service in will impact who uses the service and the value they attach to it.

What is the age of your audience?

Young people tend to be more technology savvy when it comes to using mobile phones and will likely find it easier to learn to use the Freedom Fone Service than an older generation. As you design the service, keep in mind how to best communicate with your target age group.

Where do they currently get information?

It is quite possible that your audience are getting the information you are proposing to offer through other means at the moment. It is useful to find out as much as you can about these sources and assess their strengths and weaknesses. This will guide the design of your Freedom Fone Service to improve upon existing sources and offer new value.

What do they consider valuable?

If a caller finds the information you make available valuable enough, they will bear the cost of making the call to your Freedom Fone Service. Find out what makes your information unique and consider how to prepare it in a concise way so that it is smoothly accessible over the phone.

What does your audience find funny?

Humour is an excellent way to keep people coming back to your Freedom Fone Service again and again. Find out if there are comedians, jokes or types of entertainment that you could integrate into your service to keep it entertaining and informative at the same time.

Income levels of your audience?

Typically those with a higher income level will spend more time on your Freedom Fone Service compared to those with a lower income. Many people are conservative with their mobile phone airtime so it is important to consider who you want to reach and what they will consider valuable enough to make that call to your service.

What mobile networks do people use?

Certain mobile networks may be more popular with your target audience than others, this can help guide you in many ways including approaching a mobile network to partner with, for example to get a toll-free number. It is also possible to take advantage of certain tariffs and promotions offered by a network to lower the cost of calls.

Conduct a Focus Group Discussion

One excellent way to further conceptualize and design your Freedom Fone Service is to invite the very people who will be using it to talk as a group! If you can arrange to travel to where the audience is based and make it easy for them to participate you will increase your chances of getting a higher number of participants.

Consider dividing the participants into three groups: Adult men, Adult women and youth - this can help you get different perspectives and allows participants to share more freely.

Usually, the outcomes from these discussions will be very helpful in refining your initial ideas about the Freedom Fone Service into something even more attractive and useful to your audience.

Setup a stakeholder meeting

The outcomes of the focus group discussion with your audience can be used to gather all the stakeholders involved including the ones who will be the information sources that will create the content for your service. A participatory process of engaging this group with a facilitator to lead the process can help ensure that your service is relevant, realistic and most importantly - of value to your callers.

Educating your audience

For many callers this will be the first time they have used an Interactive Voice Response (IVR) system - they may need some extra help in understanding how to use the service/technology. Here are some possible ways to introduce them to your service:

Use the radio to demonstrate

A familiar and likeable radio presenter could be a perfect candidate for demonstrating and introducing your audience to how to use your Freedom Fone Service. By making an example phone call to your service live on-air through the radio, your audience can hear an actual example of your Freedom Fone Service and how to interact with it. The radio presenter will gently guide them through the steps. This broadcast can be recorded and replayed as a radio spot throughout the day on the radio.

Follow up with one-time callers

If IVR is a new experience to many of your audience they may hang up in the first five or ten seconds of their first call because they are uncertain of what to do. Consider having a real person follow up with these one-time callers with a phone call to ask the caller if they need any help with using the service or have any questions. This also builds a nice connection between you and your audience.

Downstream training in public places

Public places where many of your audience might be gathered on a daily basis such as markets, clinics, churches, mosques, bus stops etc can be an excellent place to demonstrate the usage of your service. Consider having a battery powered PA address system or loudspeaker connected to a mobile phone and demonstrate how to use the Freedom Fone Service. This can also be an excellent place to hand out stickers, postcards or other marketing materials advertising your Freedom Fone service phone numbers.

Checking in with your audience

Are you on track? See the chapter Monitoring and evaluation.

Kubatana Audio Drama

The experience of Freedom Fone in Zimbabwe has shown that high call costs can be a challenge to getting callers to access information through Voice Menus. In 2009, the civic activist platform Kubatana (www.kubatana.net) used Freedom Fone to launched Inzwa, a call-in news headline service. They followed on with a constitutional reform information service, but came to realise that due to the high cost of phone calls, callers were more willing to pay for news and entertainment than civic information.

To test their entertainment theory, Kubatana experimented with micro audio dramas and Freedom Fone's Voice Menus. The dramas comprised 4 to 5 short audio episodes of roughly 2 minutes each, with the episodes each finishing with a compelling hook to the next in sequence. The idea was to use edutainment as a means of sharing information that audiences would otherwise find tiresome or difficult to consume. The episodes were kept short to minimise call costs.

Launched in June of 2010, Tariro on Top was an audio drama that raised awareness about sexual harassment in the workplace in Zimbabwe. The drama is about a chauvinist boss, Mr Kunaka, who is used to expecting sexual favours from his secretaries. Matters take an unexpected turn after he meets Tariro, a woman who is prepared to risk her job by rejecting his advances.

Below follows a transcript of the audio drama where Tariro, still a new employee, meets Mr. Kunaka:

FELICITY: Uh-uh, jairai asikana. Hmmm your hair is so nice! What have you done? Wakaitirwa kupi?!

TARIRO: Oh, thanks Felicity. Yah, you know, I thought now I have been transferred to this office to work for Mr-Most-High-and-Mighty-Kunaka, I should be looking really professional. That's why I thought short was maybe better. I don't want to be a secretary forever handitika, and if I can impress Mr Kunaka with my work . . .

FELICITY: Ahhh, my dear, Tariro, listen. About impressing Mr Kunaka -

MR KUNAKA: Hello ladies! Uribho Felicity, Uribho Tariro. Did you have a good weekend?

TARIRO: Yes, thank you Mr Kunaka. And I want you to know that I'm very pleased to be finally working in this office.

MR KUNAKA: Excellent, excellent, well, we are pleased to have you here I'm sure. I've always thought you had a lot of . . . potential.

Following on from the success of Tariro on Top, the Kubatana team created two other micro audio dramas - Beckham in DZ and Big Dhara - to highlight issues troubling young sexually active adults. Focus discussion groups were organised to identify and discuss common issues and thereby inform the script writing process.

To minimise the loss of audio quality across mobile phone networks, Kubatana used a professional studio to record high quality audio files. They also engaged local drama students to add life to the characters' voices. Aware that their audio files eventually had to be downsampled for Freedom Fone, Kubatana made sure to start the process with quality recordings.

To promote the micro audio dramas, Kubatana make use of their extensive mailing list of over 10,000 addresses and SMS list of over 22,000 numbers. To engage new listeners they flight adverts in local newpapers and print colourful flyers that are handed out for free at traffic intersections. Call data Records show that advertising a service this way often increases the number of callers.

"Freedom Fone opens doors. It's a new way of sharing information with an offline target audience. The popularity of Tariro on Top revealed that a service which deals with a social issue in an entertaining manner with strong characterisation and dramatisation was most popular. Call lengths were up to 10 minutes at a time which shows that people will pay for a service they are interested in."
-- Amanda Atwood, Content Manager, Kubatana Trust of Zimbabwe

Kubatana encourages feedback on the audio dramas and makes use of the Leave-a-Message (LAM) and Incoming SMS functions to receive critique and suggestions.

Role of Freedom Fone

Leave a message (LAM)

The Leave-a-message or LAM function is an effective way of establishing two-way communication with your callers. With the Leave-a-message function the caller can leave a question or comment in audio form on your Freedom Fone system. Audio messages enable your callers to express themselves more freely and Freedom Fone captures those messages without loss of meaning or character. The content left by your callers can be played and listened to from the Freedom Fone interface. In addition to being a platform for leaving questions, the Leave-a-message function can be useful as an alert platform for callers to alert you on issues that need your attention. Content left by callers can also be re-used, for example you could select 5 stories submitted for a competition using LAM, re-broadcast these and allow the public to vote for their favourites.

Functionality

A Leave-a-message function can be either a part of a Voice Menu or it can be a stand alone service. As part of a voice menu the Leave-a-message function will be allocated a digit by the Freedom Fone administrator, which a caller can dial to access it. When the Leave-a-message is set up as a stand alone service, the caller will be directly connected to the service without dialing any key and they can record a message after hearing a beep and then hang up.

The advanced Leave-a-message service allows the caller to:

  1. Record a message
  2. Listen to their recorded message
  3. Delete and record a new message OR
  4. Save their message and exit


By using the buttons # (hash), * (star), 0 (zero) and 1 (one), the user is able to navigate through the menu according to the illustration above.

The caller's selection after leaving a audio message determines whether the simple or advanced functionality is used by the system. If they hang up directly after leaving a audio message, the message is saved; if they press the # key after leaving their audio message, the system will await further key selections to determine what should be done with the audio message. If they fail to select 1 to save their message before hanging up (having pressed #), their audio message will be deleted.

Callers’ audio messages are displayed in the Leave-a-message Inbox.

The Leave-a-message Inbox

Visiting Message Centre > Inboxes > Audio Messages will provide you with access to all of the Audio Messages left in the Leave-a-message inbox. Callers’ audio messages can be titled, tagged, categorised and rated. They can also be archived if required – in message edit view the status field can be used for this purpose. Each audio message can be exported as an .mp3 file using the download icon .

Creating a Leave-a-message Menu

Message Centre > Manage LAM and click on the Create New button.

If you wish to make use of the Advanced Leave-a-message prompts, click advanced options at the bottom of the screen, above the Save button. You will need to provide the following audio files:

Saving this will create your Leave-a-message which can now be linked to from your Voice Menus.

LIRNEasia Crisis Response

LIRNEasia (www.lirneasia.net) are a regional information and communication technology (ICT) think tank active across the Asia Pacific. They began working together with one of Sri Lanka's biggest NGO's, Sarvodaya (www.sarvodaya.org) in June 2011 to use Freedom Fone in emergency response operations.

Whether during a flood, earthquake or tsunami, governments or emergency services usually have a very short time to send out a warning alert to a large and diverse population around the affected area. In such situations, the rapidity of response and accuracy of the information provided by any disaster management system is of the essence. This creates a great need for voice based communications to complement an initial SMS text alert.

"The character limitation of SMS limits the amount of information we can send when alerting the first responders in an emergency. If we could deliver a short wake-up text message and a localised descriptive voice message, that would be much more effective. That's where we found Freedom Fone very useful."
-- Nuwan Waidanyatha, research fellow at LIRNEasia

Sarvodaya plans to combine SMS alerts (sent using Sahana or other bulk SMS applications) with Freedom Fone's Voice Menus function to share important updates with villagers. SMS alerts will be sent to a network of trained individuals in each village - known as first responders - with an additional request to phone Sarvodaya's Freedom Fone lines for more detailed information about the evolving crisis.

Feedback, situation reports and requests for information and help from the field will be facilitated through the Leave-a-Message function, as Nuwan Waidanyatha describes further:

"When Sarvodaya first-responders assess the damage and report the incidents for rescue and relief actions they call Freedom Fone to leave a message. For example, several students evading the flood waters are stranded on a building and need immediate assistance. This message is received at the Sarvodaya incident command center and is processed to deploy the required resources."

When Freedom Fone's Campaign Dialer function is released in late 2011, it will be possible to automate call-outs to the list of numbers in a Freedom Fone Phone Book. When recipients answer their phone, they will be connected to a Voice Menu with updated information about the crisis. This feature can make sure people are alerted and informed of a crisis in the event that first responders fail to receive the initial SMS alerts.


Sarvodaya's Emergency Response Team field tested Freedom Fone in a number of different districts in Sri Lanka. They found that Freedom Fone provided a much needed structure for complementing early warning alerts and for receiving situational reports from the field once a disaster has struck.

This experiment points to the importance of integrating voice based communications as a complementary feature in any emergency relief operation. Voice based solutions not only provide more information than SMS, they also provide an immediate solution to language challenges faced by text communication. In many contexts languages are not supported by SMS, some audiences may be illiterate or simply a culture may be more predisposed to oral communication.

"From a global perspective, in our parts of the world people are vocal. We do business with voice. We don't write big memos, we don't write big e-mails, you just pick up the phone and you make a call, you talk to the person and you do your business. From that perspective Freedom Fone positions itself naturally in a very good way," says Nuwan Waidanyatha.

Based on these trials Sarvodaya is now implementing Freedom Fone as part of their emergency response procedures.

LIRNEasia is further investigating how Freedom Fone integrates with the SAHANA disaster management system and other open-source platforms active in crisis communications. Details of this report are available at http://lirneasia.net/projects/2010-12-research-program/ff4edxl/

Role of Freedom Fone:

Localise user interface

Freedom Fone facilitates PO based localisation. For more technical information on how to extract all strings into a PO file, read the Localisation section of our Developers' Guide.

Freedom Fone have already localised the user interface into various languages that you can take advantage of. If you would like to change your version of Freedom Fone into a language more suitable for you, follow these steps. 

The example provided is for adding a French localisation.

Download a copy of the latest French language file from the Freedom Fone website.

Copy your localised po file to the Desktop on your Freedom Fone server. If it has a different file name, rename your localised po ­file to default.po

Open a terminal window (by clicking on the Terminal icon in the centre of the Title bar at the top of the Freedom Fone desktop screen) and create a new folder with the three letter ISO code (ISO_639­3) for the new language. Make sure to use international conventions to name your folder. For more information visit http://www.sil.org/iso639­-3/codes.asp

For 2.0 users

cd /usr/local/freedomfone/gui/app/locale
sudo mkdir fre
cd fre

For 2.S users

cd /opt/freedomfone/gui/app/locale
sudo mkdir fre
cd fre

Create a folder called LC_MESSAGES under your new language folder

sudo mkdir LC_MESSAGES
cd LC_MESSAGES

Copy your localised default.po file to the LC_MESSAGES folder

 cp /home/manguensis/Desktop/default.po default.po

Important: Please note that the folder name 'manguensis' may change if you are using a different version:
v2.0.x = sekowei
v2.D.x = suyo

Change permissions to make default.po executable by all users

chmod a-x default.po

Next, we need to add the new language as an option to the dropdown language selector on the Freedom Fone Dashboard > Settings page.

Open the CakePHP configuration file

For 2.0 users

gedit /usr/local/freedomfone/gui/app/config/config.php 

For 2.S users

gedit /opt/freedomfone/gui/app/config/config.php 

and add your language to the bottom of the $config['LANGUAGES'] variable. Make sure to add a comma to the end of the line above your entry.

config['LANGUAGES']=   array(
'eng'   =>   __('English',true),
'fre'   =>   __('French',true),
'por'   =>   __('Portuguese',true),
'esp'   =>   __('Spanish',true),
'swa'   =>   __('Swahili',true)
);

In the background, CakePHP applies the selected locale in the AppController (before Filter).

To test your localisation, go to the Freedom Fone Dashboard > Settings page and select your new language option.

Logging in

Note: This section assumes that you have already installed the Freedom Fone software, connected your hardware and tested your SIM cards. All these procedures can be found in the section Technical Stuff.

When you open the Freedom Fone interface, you will be presented with a login screen which you must be authenticated before you can continue. 

The default login details are:

User = Admin
Password = thefone

To ensure a higher level of security, please change the default login details when first logging into Freedom Fone.

If you cannot login with these details, contact your Freedom Fone administrator for up-to-date login information.

Monitor and evaluate

Once your Freedom Fone service is up and running, it is important to keep a finger on the pulse of your service and to periodically monitor its success and impact. Freedom Fone has some inbuilt tools that can be used to track caller usage of your service. In the chapter Organise your staff, we make some recommendations about assigning the task of monitoring and analysing your system data.

Ways to monitor and evaluate your service:

What are some of your strategies for Monitoring and Evaluating your service?

Networking

Network card is not recognised after hibernation

This is a bug in Ubuntu. Your interface names such as eth0 are assigned to a physical interface, specifically the MAC address of that interface. When you hibernate and then try to restart, the system tries to assign a new MAC address to your NIC. So when your MAC address changes the system thinks it’s a new network card and assigns the next free name, lets say eth1.

However your network configuration file is still referring to the old name eth0. So basically you end up trying to apply configuration to a NIC that doesn’t exist, while there is a new NIC with no configuration. Basically no more network…

So how do you fix it?

Make a backup of the 70-persistent-net.rules file:

sudo cp /etc/udev/rules.d/70-persistent-net.rules /etc/udev/rules.d/70-persistent-backup 

Now when you have done a backup remove the file

sudo rm /etc/udev/rules.d/70-persistent-net.rules 
Reboot the machine
reboot 

So basically that just deleted all of the old MAC address to name (eth0) mappings, so when the system boots these should be correctly created again.

Network card is not recognised on new installation

Not all Network cards have drivers which are supported by Ubuntu. It may happen that after installing your Freedom Fone on a computer, you find that the Ethernet card does not appear when you issue the ifconfig command. The solution to this can be to change the Ethernet card. When choosing a network card to replace, try and get something that is not the latest, as usually Ubuntu takes time to update its driver database.

If you don't have another network card, you can connect a USB GSM modem to the computer or laptop and connect to the Internet and then follow the instructions below. If you don't have the USB modem, you will have to do this on another computer with Internet connectivity and then transfer the files you would have downloaded.

Instructions

To download, compile and install the driver, first go to http://linuxwireless.org/download/compat-wireless-2.6 and download the file named compat-wireless-2.6.tar.bz2 (you can't download it in the terminal because of anti-hotlinking). Save it to your desktop. Then run these commands in a command terminal:

sudo apt-get update
sudo apt-get install build-essential
cd ~/Desktop
tar -xjvf compat-wireless-2.6.tar.bz2
cd compat-wireless-2.6.39-1/drivers/net/atl1c
make
sudo make install 

Then reboot. Hopefully your Ethernet will work automatically after reboot; if not, run:

sudo modprobe atl1c

to insert the driver.

NB: Although the drivers are included in the compat-wireless stack they are actually drivers for an ethernet card not the wireless card. In the example I chose the compat-wireless-2.6.39-1.tar.bz2 because it is the latest stable release for the kernel I am using. Whenever you look for drivers in future, choose the latest stable release for the kernel you are running on. To check the kernel version issue the command uname -r on the command terminal.

Setting network alias permanently

Freedom Fone sets the network alias on eth0:0 at boot time via the /etc/rc.local script. This setting is not permanent and is set each time you boot up. If for some reason the networking is not enabled when you boot up the alias cannot be set. This presents a challenge since Freedom Fone uses this alias to communicate with the OfficeRoute. In such a scenario, in order to get Freedom Fone working you will have to enable networking and reboot the machine.

To avert having to reboot the machine every time you forget to enable networking before rebooting, make the following additions to the /etc/network/interfaces file (click on the Terminal icon in the centre of the Title bar on your Freedom Fone desktop).

Instructions

sudo gedit /etc/network/interfaces

Append the following configuration:

auto eth0:0
iface eth0:0 inet static
name Ethernet alias LAN card
address 192.168.1.250
netmask 255.255.255.0
broadcast 192.168.1.255
network 192.168.1.0

Save the file and restart the network with the following command:

sudo /etc/init.d/networking restart 

From now on, if the eth0:0 does not appear after boot because networking has been disabled, you will simply enable networking by right clicking on the wireless network icon at the top task bar, and then issue the command above for restarting the network.

Organise your staff

Keeping your Freedom Fone service running requires staff or volunteers. It is common that people underestimate the work that is needed to manage the content, communicate with callers and monitor the usage of their Freedom Fone service. It is therefore best to plan from the start to have staff in at least two capacities: technical and operational.

Note: we know that budgets are often limited in organizations planning to provide a Freedom Fone service and the workloads for current staff is typically already high - adding the following tasks and resources may be too much. It should be pointed out that Freedom Fone can certainly be a part-time task for existing staff members if you are not able to dedicate full time staff to the service, however we recommend planning for success by freeing up staff and financial resources.

Duties

The following are some typical tasks that could be assigned to two different staff members involved in your Freedom Fone service:

Technical staff

Operational staff

Resources needed for your staff

In our experience, the operational staff in particular need the following resources to help them in managing the Freedom Fone service:

Try-and-see is probably the best approach to finding an efficient workflow with your staff and resources - with time you will know what you need to adjust to keep the service running. This will likely change over time as your service changes.

Other problems

Problems with times

If you find that the log files are reporting the times incorrect or that the start time of Polls is not adhering, then there may be an issue with your system time.

Check to see if the time in the top right corner of your Freedom Fone installation computer is set correctly. If it is not, you may click on it and set it.   

Freedom Fone interface freezes

This is usually caused by pulling out the GSM devices whilst Freedom Fone is running. Please check that the power to the GSM devices is stable and all connections to the computer are firm.

Calls going through but audio being played by laptop speakers

See Troubleshooting - GSM devices

Polls

A simple and fast way to measure opinion on an issue is to conduct SMS-based polls. SMS polls enable your callers to respond to a structured question via an SMS response. As the SMSs arrive on the Freedom Fone system the individual SMSs are tallied and a summarized tabular output is generated. In scenarios which need urgent action but yet rely heavily on evidence-based information to take the first step, SMS polls can be a powerful and effective tool.

Functionality

The Poll function allows end users to participate in polls by sending a SMS to Freedom Fone. The Poll functionality allows for time sensitivity, providing a start and end date/time, and multiple choices for a user to select from. The polls are available at Poll > Manage Polls.

Poll details can be communicated with the public via any means, including website, email, radio and printed materials. Remember to share the above details and include the poll code and the phone number to which participants should send their SMS replies. You can refer to the chapter about advertising your service to get some ideas on how to spread the word out about your poll. 

For each poll, once it has started, the administrator can at anytime, view the interim or final result in terms of number of votes per answer, and percentage of total votes per answer. 

The system classifies all incoming votes as valid, invalid, or incorrect:

Valid vote

A vote is said to be valid if received with the correct poll code (the poll code is the unique identifier of the poll - see further) and a valid answer (the participant's answer matches one of the options given). A valid vote can be in time, but also early or late:

Early votes will be registered as “Valid, early”. The number of early votes per poll option is presented in a separate column under the View poll page. Early votes will not be added to the Total votes accepted for the poll.

Late votes will be registered as “Valid, late”. The number of late votes per poll option is presented in a separate column under the View poll page. Late votes will not be added to the Total votes accepted for the poll. 

The Early and Late vote classifications are summarised separately to provide a complete view of votes submitted to the poll concerned.

Invalid vote

A vote will be classied as "invalid" if it displays the correct poll code, but a non-matching poll option (the participant used the correct poll code, but his answer was not one of the options given.)

Invalid votes are registered as votes, but classified as “invalid”. “Early”, “late” and “on-time” invalid votes are also registered. 

Only “on-time” invalid votes are incorporated into the Total number of votes summary.

Invalid vote totals are provided to give you an idea of how SMS errors might impact on poll results.

Incorrect vote

Incorrect votes have a non-matching poll code.

Incorrect votes that cannot be matched to any existing poll, will be classified as an incoming SMS and will be stored under “Other SMS”. The SMS will be classified as “Unclassified”.

Other criteria used for vote validation

The poll is not sensitive to casing, so 'yes' ,'Yes', 'YES', 'yEs' will all be interpreted as a YES. The same logic applies to the poll code. More than one poll can be active at the same time. Incoming SMS are identified by the code used and matched with existing polls.

The timestamp used to determine whether or not a vote is in time for a poll, is the time of arrival to the Freedom Fone platform. Hence, if an SMS gets delayed in the GSM network, it will be classified as late even if it was sent before the poll deadline.

Create a Poll

The Freedom Fone administrator has the ability to create, edit and delete Polls. A poll is composed using the following parameters; to create a poll navigate to Polls > Create Poll and you should see the screen shown below:

A Poll consists of the following:

Example: The administrator creates a poll with the following parameters:

Question: Would you like to deploy Freedom Fone in your organization?
Code: freedomfone
Answer: Yes/No/Maybe
Start time: 08:00 AM, January 1, 2010
End time: 08:00 AM, Jan 31, 2010

To participate in the poll, the end user needs to send an SMS that arrives after 08:00 AM the 1st of January, and before 08:00 AM the 31st of January 2010 with one of the following messages:

freedomfone yes
freedomfone no
freedomfone maybe

The administrator can at any time edit the above listed fields. Of course, it is not recommended to change the question, code or answers to a poll once it has been opened to the public. Before a poll is opened, and after it has been closed, no poll votes are registered for the poll. 

Preparing SIM cards

SIM cards provide Freedom Fone with access to the mobile network, allowing callers to reach your platform in the same way that they are used to reaching each other.

This chapter will explain how to choose your carrier(s) (Mobile Network Operator), how to prepare your SIMs for use within the GSM device, and how to install the SIMs.

Choosing a Carrier & Procurement

Choosing a carrier is a very important step in providing callers with access to your Freedom Fone service. There are a number of obvious items you may consider as well as some that are not immediately apparent.

Confirm that DTMF works on your Carrier

The most important first step is to confirm that Freedom Fone works with your carrier.

DTMF is a high pitched sound that a phone makes when a key is pressed.  The Voice menu function of Freedom Fone depends on these DTMF tones for a caller to make a selection inside a Voice menu e.g. To hear market prices, press two.

Unfortunately some mobile phone operators do not support the use of DTMF and the Freedom Fone hardware cannot hear when a user presses a button to make a selection. To quickly check if a carrier support DTMF, try making a call between two phones on this network and in the middle of the call try pressing some buttons 1 2 3 etc. If you can hear the beeps and tones of the keypresses, the network supports DTMF. If you dont hear any tones - there are several things you can do.

We have had cases where it is simply a matter of trying a different SIM card from the same mobile carrier - try a few different SIMs. If that still does not work, you can test further by calling the default Cholera menu after you have installed the Freedom Fone software.

If you are still unable to get the Freedom Fone service to respond to keypresses you could try speaking to the technical support people at the carrier - otherwise you may need to consider using a different carrier.  Note: All is not lost - you may still use functions that do not require caller key press selections such as the Leave-a-message function or create a single informational Voice menu that a caller can listen to.

Cost from your perspective

Which carriers are the cheapest to receive calls? In some countries, inbound calls are billable.

Which carriers offer the best SMS rates? This may include bundles that can be bolted on to your service plan to offer discounted volume rates.

Cost from the caller's perspective

Which carriers are your callers on? Cross network calls are often more expensive than same network communication.

Discounted call times or promotions? Are there any discounts or promotions that you can take advantage of from a mobile carrier?

Sometimes, offering a choice for callers to access your service through multiple carriers will increase the likelihood that they will call. Remember to advertise all your numbers and carriers to help callers make the appropriate choice.

Network Reception at Freedom Fone Service Location

Check to see which carriers offer the best reception at the physical location of your Freedom Fone service. The better the signal, the higher the quality of call.

Network Reception at Caller's Location

If targeting a specific audience based on geography, ensure that the carrier of choice also has reception in that location.

Selecting MSISDN (Mobile Number)

If purchasing multiple SIM cards, try to get telephone numbers that are consecutive or highly memorable.Many mobile phone operators will let you choose these numbers.

Security

Never forget that carriers maintain call data records. In some sensitive environments, security issues and the trust you have in the carrier might guide your choice.

SIM Card Preparation

Before installing a SIM card into the GSM device you plan to use, ensure that you follow these simple steps:

  1. Insert SIM into a mobile phone
  2. Verify the following:

All PIN requests on the SIM have been removed: this is usually found in a "Security" option within "Settings" on most handsets

SIM Card Installation

It's now time to place the SIM(s) into the GSM device that you have chosen to use. Please follow the instructions of that specific device; to understand how to do this, see chapters the Connecting OfficeRoute or Connecting MobiGater depending on your hardware.

Problems with Voice menus

I can’t hear the voice menu prompts because a voice keeps nagging me about Cepstral.

Cepstral is the text to speech (TTS) software used in Freedom Fone.  Our software will work without a licence but before it reads each line of text, Cepstral will play a reminder that you need to buy a licence. We are using the Allison 8 Khz voice for Linux.

You will be hearing this voice because you have entered text in the large text box labeled Description in your Voice menu. If this is not what you want, you can remove this text and it will stop this problem.

Fix 1:Buy and register a licence for Allison 8 Khz from the Cepstral website

A licence for the Allison 8 Khz voice for Linux can be bought from https://www.cepstral.com/. Once you get the licence you can register the voice by running the swift executable from the command prompt as follows:

/opt/swift/bin/swift --reg-voice

Follow the instructions to enter the details associated with your licence. You will be asked for Name, Organisation and Licence key

Fix 2: Create your own audio files and avoid text to speech completely

If you use your own audio files you do not need to use text to speech at all!

I have tried to upload Menu options but none of my files are reflected on the Menu options screen. What’s going wrong?

The chances are that the file you tried to upload was larger than the maximum file size of 10MB allowed. Downsize the audio file by shortening its duration and/or ensuring it has been created as a WAV or MP3 file that is mono with a sampling rate of 8Khz.

Characters other than a-z, 0-9 or - and _ can create problems in filenames when you upload the files. If you see the File not found message when you try to play uploaded audio content, try re-uploading the content with a filename that follows the about rules.

Recording oral histories

Imagine a walk through the city of Berlin. As you pass a now nearly invisible checkpoint where the former Berlin Wall once stood, you can dial a Freedom Fone Service and listen to sound recordings that bring to life the history of that particular spot.

Suddenly you can hear the shootings of fugitives from a once divided city followed by the celebratory shouts on the day the Wall went down. Continue past the Dom (cathedral) and you can choose to hear a historical account of the architecture but also the story about the original building plan which was secretly hidden by one of the carpenters in the steeple.


An ordinary house may grab your attention because of the grafitti on the wall. As you listen to information left on the Voice Menu function you find out that during World War Two a Jewish family was hiding in the attic to escape the holocaust. Later you pass a house where the poet and playwright Bertold Brecht once lived. You can listen to one of his most famous poems while you rest a little.

Now imagine the city you live in. You'll find that nearly everything has a hidden story to tell: a house, a tree, a street, a river, an abandoned train track... Even an empty space might have a story to tell – missing houses that were once a distinctive feature of the landscape or environment and are now reduced to dust. But somewhere a living memory survives.  

Imagine your community Council, a cultural organisation or even a group of students using Freedom Fone to build a virtual history of your city or community. Audio content is created by a small team of editors and uploaded onto alternate Voice Menus that can be listened to on an on-demand basis including a mix of speech, music and poetry. The service is widely advertised using flyers or posters to allow the general public to Leave-a-Message in places where they recall important events that happened at a certain time or place. Callers' stories can be stored on a public archive linked to an interactive online map while being integrated back into the service.

As long as you are carrying your mobile phone you can call on the spot, listen to recordings that trigger memories and participate in creating a collective history. Reminding people of their cultural and collective heritage can create a sense of shared memory, common belonging and civic solidarity in any city or community.

Resources needed

Equipment

Staff and Competencies Advertising costs

Role of Freedom Fone

Security

Telephony is inherently insecure - carriers (Mobile Network Operators) maintain call data records of phone call and SMS traffic on their networks. This enables authorities to monitor the phone numbers accessing a Freedom Fone Service and to scrutinise the contents of SMS messages.

Greater risk to caller privacy is more likely to be found inside your own organisation since sensitive information about your callers is recorded by Freedom Fone, for example:

To help you limit which of your staff can view and export sensitive data, there is a basic Role Based Access Control in the Freedom Fone's user interface. All users of the system must enter a username and password in a login screen.

For some organisations, there are very real concerns that their Freedom Fone server might be seized by hostile agents with the skills to bypass basic security, potentially compromising their callers. In recognition of this possibility, Freedom Fone's logging architecture has been reorganised to allow sensitive data to be stored in an encrypted drive and/or on removable media. For more information about using this service contact us - refer to the chapter Support

For environments where security is a concern the sweeper is a useful feature which allows you to replace sensitive data that is visible with dummy data. Such information includes caller phone numbers, names, email addresses, Skype id's and organisational names. The security feature will remove these from all user interfaces and log files.

The sweeper functions should be used with care as it is irreversible and will render many of the usage reports meaningless. For advanced users, the Backend Sweeper can be configured to periodically purge sensitive information from Freedom Fone.

Frontend Sweeper

The Frontend GUI Sweeper is a panic button that is used to replace all caller identity information with arbitrary values. It is only accessible for Admin system users through the main menu (User Management > Frontend Sweeper). It is important to note that once you have run the Frontend sweeper it is not possible for you to view or reverse the process. It is advised that you have a system in place to regularly backup your data.

Running the Frontend sweeper

Navigate to User Management > Frontend Sweeper

When you select the Frontend Sweeper button you are brought to the screen shown below.

Click on the Start Sweeper button and all personally identifiable information associated with the records in the Call Detail Records, Monitoring, Reporting, Statistics and Phone book details will be replaced. The screen shot below shows how the callers' numbers associated with the call data records are replaced with 555666.

The screen shot below shows how the contact details in your Phone books are anonymized by the sweeper, replacing name, surname and email with John Doe as the caller.

Backend Sweeper

The Backend GUI Sweeper is a service that runs behind the scenes to remove caller records and logs from the system at regular intervals. It is accessible to anyone with root access to the machine, and is automatically run by means of a cronjob. The Backend GUI Sweeper is not enabled by default (cron/crontab). The Backend Sweeper will periodically, depending on settings, purge sensitive information from Freedom Fone.

Configuration

The Backend sweeper is configured in the file config/gui_config_sweeper.php 

The following parameters can be configured:

  1. Enable/disable Frontend sweepers
    Values: 0 or 1
    Comment: Enable GUI sweepers by setting value to 1.
    Disable GUI sweepers by setting value to 0.
  2. Sweeper mode
    Values: low or high
    Comment: "low" mode will only sweep phone numbers, while "high" mode will also sweep callers names, surnames, email, Skype and organisational names.
  3. Fallback data
    The fallback values (after sweeping) of callers numbers, names etc. can be configured under SWEEP_SETTINGS. The default value for caller's name is for example "John Doe".

Core Sweeper

The Core Sweeper handles the following operations (none of them is enabled by default as a cronjob):

  1. Sweeps audio meta data of MP3 and WAV files
    Documentation: sweeper/INSTALL.sweeper.metadata
  2. Extra log information
    The script sweeper/sweeper.sh allows a user to re-configure the system to disable syslog, mail, webserver and telephony logs. The script replaces the configuration file of iwatch, apache2, freeswitch to disable logging.
    Documentation/Script: sweeper/sweeper.sh
  3. Delete all logs
    All logs are stored under /opt/freedomfone/log. The script sweeper/sweeper.sh will prompt to delete all logs. Alternatively a cron job can be created to delete the logs periodically.
    The function delete_logs() in the script shows how to stop and start the services.

Incoming SMS

The SMS service allows you to receive ordinary SMS messages and view them in a reader friendly interface. Through the Freedom Fone interface you can then export the SMSs into any content management service of choice. Freedom Fone does not have the functionality for you to send SMSs. There are already several tools available to send SMSs effectively and integration with one of these tools, FrontlineSMS, is on the Freedom Fone agenda for 2012.

A caller may send an SMS to one of the SIM cards that you have installed for your Freedom Fone service. Freedom Fone first checks to see if the SMS received begins with a keyword that has been reserved for a poll. If this is not the case, the SMS will appear in your Message Centre under Incoming SMS.

In Message Centre > Incoming SMS, all SMSs are sorted by date/time that they were received, and also display the message content, time, type, and sender's number. From here, you are also able to delete single or multiple messages.

Statistics

The power of Freedom Fone statistics is that they will capture every detail from the time a caller dials your number to the point at which they end the call. They offer more insight into the information needs of your callers and can be useful in coming up with a content strategy.

It is highly recommended that you do not work directly on the Freedom Fone server to view Call Data Record reports and graphs. These activities require intensive database activity that will slow down performance on the server. Whenever possible, rather access the Freedom Fone server from another computer using your local area network.

Statistics can be exported as a CSV file for a refined analysis or for building graphs, for example using our Graphic Reporting Tool (described later in this chapter) or a spreadsheet tool like Excel.

The statistics come under the System Data menu and consists of 4 sections.

Call Data Records

Call data records, commonly abbreviated as CDR, detail when a call starts and when it ends. The CDR also records when a SMS and a Poll lands. The IVR menu or LAM that a caller accesses is also reflected in the CDR. The administrator can choose to export All entries, or a range of entries using a start and end time. The screen shot below shows an example of a CDR page. To see the CDR page navigate to System Data > Call Data Records:

The CS_ROUTING label under the "Type" column indicates the start of a call and the CS_DESTROY indicates the end of a call. each call has a unique Call ID which is generated by the system. For every call there are two entries,one indicates the start and the other the end.

Statistics

The statistics page gives a summarised view of all the activities that are happening within your system. The view of the statistics page is similar to the overview section of the home page, the difference being that on the statistics page you can select a date and time range to view statistics. To view the statistics page navigate to System Data > Statistics. The screen below shows the statistics page.It is not possible to export this page.

Monitoring

Freedom Fone offers the administrator a means to monitor the features accessed by callers via a voice menu. For each incoming call to a Voice Menu, the caller's options are recorded (time, ivr, digit pressed, menu option chosen, caller number). These call records can be exported to a CSV file. The administrator can choose to export All entries, or a range of entries using a start and end time. To view the monitoring page, select System Data > Monitoring. The screen shot below shows the monitoring page:

Entries that relate to a Leave-a-message will only reflect in the monitoring section if the leave-a-message is an option of a voice menu. 

Reporting

The reporting page shows the call duration for the calls made to either your voice menu or your leave a message service. You are able to select a date range for which you want to view either your voice menus or leave a message service. The administrator can choose to export all entries, or a range of entries using a start and end time. To access the reporting page, select System Data > Reporting. The screen shot below shows the reporting interface:

Graphic Reporting Tool

The Graphic Reporting Tool enables you to output graphical representations of the data from your call detail records. This tool can be of great value for presentations, and for simplifying and making sense of, the call statistics you get on your machine.

First, you need to export the data you wish to show in your graph. To do this, go to System Data > Reporting, select the search parameters according to the information you wish to present - choose the relevant dates and service. Click on the export button and ensure that only the comma check box is selected in the export attributes of the CSV file. Choose the location for the export file and save.

To access the graphic reporting tool, open a new tab and into the address bar of the browser, type in the following URL:

a) If you are working on the Freedom Fone server:
http://localhost/reporting

b) If you are accessing the Freedom Fone server across the LAN:
http://your FF server IP address/reporting

e.g. http://192.168.1.250/reporting

After entering the URL above, you should get the following screen:



Using the Browse button, navigate to the CSV file you have exported from Freedom Fone. Click the Upload button to view the page below:


Select the menu(s) and date ranges you want included in the graphs and give the report a title. Click on the Generate Report button and a new report should be generated with various graphical output, as illustrated by the screens below:


Use the buttons on the left hand side of this page to view different graphical representations of your data.


This data can be exported and printed.

Support

If you need help, check out our fantastic resources designed to help you make the most of Freedom Fone.

Websites

http://www.freedomfone.org - main project website
https://dev.freedomfone.org - development website
http://demo.freedomfone.org - online demo

Community Forum

http://freedomfone.org/forum

Facebook

http://www.facebook.com/freedomfone

Twitter

@freedomfone
http://www.twitter.com/freedomfone

Supporting Women's Rights

Kalila is a Human Rights activist. She lives in a medium-size city in an Arab country. One year ago she set up a small organization focusing on Women's Rights. As part of a programme which also includes conferences in schools and capacity-building of social workers, she is now running a Freedom Fone Service aiming to denounce sexist comments or insults that women in her area often have to endure in their daily life, in particular on the street.

Thanks to Freedom Fone, in the event of any incident involving abuse towards women in Kalila's neighbourhood, victims can now use SMS to text in the insult addressed to them and the location where it happened. They can also call into the service to Leave-a-Message and report their story. Kalila and her colleagues maintain a database of all the incidents, which they have integrated with a map of the area that is available on their organization's website. The map, which is updated every week, provides a humorous but accurate snapshot of "the most sexist areas in our community!"

Women can also call in to hear a selection of other women's testimonies, as well as listen to a weekly 3-minute Audio Drama providing tips and tricks on how to respond in case of harassment and suggest appropriate answers to insults.

Kalila and her colleagues used small posters to advertise the service and call for action. They placed them in strategic meeting places such as schools, clinics, bus stops and also hairdressers and beauty centres. Kalila's younger cousin, who is studying graphic design, helped design the poster using cartoon-type characters so that it looks attractive. Word of mouth did the rest and the service now starts to be quite popular in the city!

Mayssa is a 20-year old student living in the same city as Kalila. She hates receiving degrading comments from men in the street and having them wolf whistle at her. She enjoys calling the service to listen to the Audio Drama. Sometimes she calls several times a week to listen to the same episode with her cousins or friends. She comments:

"You know, in our society many men do not think that women have the same rights. And even if this is a serious topic, I like this audio drama because it is really humorous. Some of the testimonies are also amusing although the problem is very real! Myself I really got fed up with this type of behaviour and it was a relief for me to hear that I was not alone and that I have the choice to answer back. This programme really creates a spirit of solidarity among women, and it reinforces our awareness about our Rights!"

Since Kalila's organisation uses the security version of Freedom Fone, the database of callers' numbers can only be accessed by the administrator - you know, just in case. Kalila is now thinking about extending the service to other countries. She is also in discussion with her friends Whalid and Susan on how they could turn the service into a Radio Programme.

Resources needed

Equipment

Staff and Competencies Advertising costs

Role of Freedom Fone

Technical requirements

Freedom Fone was built as a DIY (do it yourself) tool which you should have up and running before you finish saying "Freedom Fone". There are a few technical requirements you have to satisfy before you start using Freedom Fone. The requirements stated below are only given as a guideline. You may see the need to increase your equipment specifications depending on the amount of calls you expect to average.

Evaluation equipment required

If you wish to evaluate Freedom Fone beyond experimenting with our online demo (http://demo.freedomfone.org), we have successfully installed on low end/low cost computers for non-critical demonstration and evaluation purposes.

An example minimum specification of a computer that is able to run this version of Freedom Fone:

Computer Model: Asus Eeepc 900HD
Processor:
Intel Celeron M 900MHz
RAM:
1GB
Hard Drive:
10GB
Optical Drive:
DVD Reader

Please note: if you wish to install Freedom Fone to test you should do so on a machine which contains no important data as the installer will wipe your hard disk and install both the Ubuntu Operating system and Freedom Fone. As an alternative, you can choose to install Freedom Fone into another partition on your computer's hard drive. Freedom Fone's installer DVD will give you an opportunity to choose between overwriting the entire hard drive and installing alongside your current system.

Recommended equipment required

When it comes to implementing your Freedom Fone service in a live environment, it is highly recommended that you use a more powerful system. The following is a recommended standard set up:

Processor: Dual Core Processor (Intel or AMD) 2.0GHz+
Sound: Onboard soundcard
RAM: 2GB
Hard Drive: 80GB
Optical Drive: DVD Reader
GSM device: 2N OfficeRoute (takes 4 SIM cards) or Eurodesign MobiGater (takes 1 SIM card)
Signal: Good GSM signal coverage
Power: Reliable backup power

See the Equipment chapter for details of suppliers of OfficeRoute and MobiGater devices.

Note: Freedom Fone does not run on Macintosh hardware.

The schematic diagrams below shows the different configurations you can have with equipment listed above.


The diagram above shows how you would connect a computer running Freedom Fone to an OfficeRoute. Note that you can also connect the OfficeRoute directly to your Freedom Fone computer using a crossover cable.


The diagram above shows how to connect to the MobiGater.

Testing your set up

After installation has been completed, and all the GSM devices have been connected, why not test Freedom Fone with the audio samples supplied? Freedom Fone comes bundled with a entire sample Voice Menu which allows you to test the functionality and configuration of your Freedom Fone installation.

Voice Menus

A sample menu called Cholera will be available immediately after installation. This menu has been designed to test the selection of items within the menu, and to demonstrate Freedom Fones' ability.

To test, simply place a call to the SIM card that has been installed in your GSM device during installation from a telephone, and listen out for the Cholera menu welcome tune. 

Listen carefully to the prompts and select one of the Menu options offered. Once the Menu option completes, you will hear the Voice menu’s Instructions prompt repeat.

If you CANNOT get Freedom Fone to respond to the selections you are making using your phone’s key pad, see the Troubleshooting Guide in the Documentation folder on the Freedom Fone Desktop.

To monitor your call, select System Data > Call data records from the main Freedom Fone menu. You can click on the Refresh button at any time to view information associated with completed calls or calls in progress.

You can see details of key selections made by a caller in response to a Voice menu by selecting Voice menus > Monitoring from the main Freedom Fone menu.

Leave a Message

In the sample menu Cholera, you are able to test the Leave a Message functionality.

To test, place a call to the SIM card that has been installed in your GSM device during installation from a telephone, and listen out for the Cholera menu welcome tune.

Listen out for, and follow the menu option to Leave a Message (option #5). Follow the audio prompts, leave your audio recording, then hang up. 

You will hear the default Freedom Fone Leave-a-Message IVR Menu and experience the basic Leave-a-Message functionality.

After you hear a beep, you should leave your voice message and then hang up. This action will automatically cause your voice message to be saved.

When you then access the Message Center Inbox, you should see your newly created audio file. Try playing it, and see how the quality is.

If you hear this, Success! Your GSM devices and Freedom Fone are now configured correctly for Leave a Message.

SMS

To test the SMS receiving functionality, sending a simple SMS to the number in your GSM device from another telephone will suffice. After you have sent this, visit the Message Centre - Incoming SMS to see if your SMS has arrived.

If you see this, Success! Your GSM devices and Freedom Fone are now configured correctly for SMS.

Troubleshooting

If you do not get an expected result, check out our troubleshooting guide in this book for hints on how to fix common issues surrounding configuration and installation.

User management

System users

Freedom Fone version 2S adds the functionality of multi users with different access levels.

The system administrator has unrestricted access to all the system modules. You can have many users with administrative rights, the same applies to the non-admin users.

To add a user simply navigate to User management > System Users and click on the Add user button shown in the screen below.

When you click the Add user button you are prompted to create a new user: assign a username and password of your choice to the new user and lastly assign the new user with either Admin or non-Admin rights using the group option. The image below shows the interface for adding a new user. 

Click on the Save button. You can see that the new user had been created.

Vaccination campaign

Achieving full coverage in vaccination campaigns can be difficult. It depends a lot on community trust and ensuring consistent information to target populations.

Shamiso's dilemma

Shamiso and her husband Musa have three children. They are devoutly religious and members of an evangelical church that generally disapproves of vaccinations and other health interventions.

Now there is an outbreak of measles in their district. Health and child protection agencies have visited their village pleading with them to take their children for vaccination.

Shamiso feels she should take their children but doesn't want to disobey her husband or their church leaders and cause conflict. She feels torn between protecting her children and going against her culture and religion. What can she do?

Raphael's story

Raphael is the local district vaccination campaign co-ordinator and is looking closely at the coverage in the District. He sees that the campaign is faltering in the villages where the church has strong leadership. He decides to act: he calls a meeting with the church leaders, and they agree to endorse the campaign.

Leaflets are drawn up with the church leaders endorsement and distributed; meetings are held. The villagers receive the information but they mistrust what is written. Nothing validates the statements made that the church leaders now endorse the campaign. Numbers of vaccinations continue to fall in some areas.

How to move forward?

Raphael has heard about Freedom Fone and sees a solution. He sets up a team. The finance officer orders the equipment. The IT officer sets it up and the community mobilisers help to record simple Voice Menus in their local language.

Raphael gets the church leader, Prophet Johannes, to record a Voice Message endorsing the vaccination programme and asking members of his church to bring their children forward to the vaccination centres. This is the flagship message of their service. Raphael sets up a voice menu and sends an SMS to his community mobilizers asking them to encourage villagers to call the number.

A little later ...

Shamiso calls the number from her village and she hears this voice menu ...

"To hear Prophet Johannes message on vaccination, Press 1"
Shamiso and her husband Musa play the message together. The voice of their church leader reassures them.

"To learn where and when to bring your child for vaccination, Press 2"
Her and her husband agree to take their children to the vaccination centre immediately.

"To learn more about the symptoms of measles, Press 3"
A few of the village children are sick and she is not sure if it may be measles or something else. They decide to check up on them.

"If you see measles in your village and think a health worker should visit, Press 4 to leave us a message"
Shamiso leaves a message with her village and her name on the Freedom Fone Service. A health worker soon visits them and reassures them that it is not measles.

Impact

Raphael starts to see the numbers rise of parents coming forward. He uses the Statistics and Reporting function of Freedom Fone to continuously monitor the levels of calls and direct his health workers to areas that are still low in coming forward.

Raphael keeps Prophet Johannes in the loop and agrees to publicize a prayer service to be held in the coming weeks so as to further endorse the campaign and give guidance to the villagers in the District.

Shamiso is proud and relieved that she and Musa found a solution to her dilemma and that her children are protected.

The district is evaluated and found to have the best universal coverage statistics in the campaign.

Resources

Equipment

Staff and Competencies Advertising costs

Role of Freedom Fone

Voice menus

Voice menus enable you to create an information tree which your callers can navigate through with the aid of dialing keys on a telephone keypad. You can imagine a voice menu as a grouping of similar content which you would like your callers to access. Each content item in your menu will be linked to a unique digit on your telephone keypad.

The process of embedding voice menus within existing voice menus, which we call nesting, allows you to extend your information tree and hence provide more content to your callers.;

Functionality

The administrator is able to build a variety of Voice Menus based on customised audio files and synthesized text messages called content.

A voice menu consists of:


The design of a Voice Menu is illustrated above.

Designing a Menu

When creating a voice menu, the best practice is to sketch out the intended structure for how you wish users to navigate your content.

MENU 1.

WELCOME AUDIO "Welcome to Local News FM"
INSTRUCTIONS "To listen to info from your area, press one To listen to global news headlines, press two To leave us a message, press three"
CALLER PRESSES 1.
MENU 2. INSTRUCTIONS "To get traffic info, press one To get local weather, press two To return to the previous menu, press zero"
CALLER PRESSES 1. CONTENT AUDIO "Todays traffic...."
CALLER PRESSES 2. CONTENT AUDIO "Todays weather is...."
CALLER PRESSES 0. USER RETURNS TO PREVIOUS MENU
CALLER PRESSES 2. CONTENT AUDIO "Todays global headlines are...."
CALLER PRESSES 3. CONTENT AUDIO "Please leave us a message after the tone"
INVALID AUDIO "Oops, please enter a valid option"
GOODBYE AUDIO "Goodbye"

Creating Content

Once you have designed the structure of your menu, it is time to create the audio files.

The audio files must be uploaded in either .mp3 or .wav format through the user interface. They should be recorded as mono, 8Khz files, and must be less than 10MB in size. Once uploaded, they can be listened to from the administration GUI via the built-in Flashplayer. Audio files can at any time be overwritten with a new audio file.

Once you have created the menu instructions, record the menu options and upload them in the content section, IVR Centre > Content > Upload.

Give your audio file a title and save.

When all audio content has been uploaded, you are now able to find it in IVR Centre -> Content.

Creating the Voice Menu

When creating an voice menu with sub menus, you must create all sub menus before creating their parent. This will become apparent when putting them together as you need to link to an existing menu.

To create a Voice Menu, follow these simple steps:

  1. You will need to create the menu structure at IVR Center -> Voice menus -> Create New

  2. Name the menu, and then assign the audio files you have just created to the four respective sections.
  3. Within the Menu Options select the type you wish to appear for the assigned digits.
  4. In the example above, we have to create MENU 2 before we create MENU 1. When creating MENU 1, we can select MENU 2 in the Voice Menu dropdown selection for digit #1. And then select the appropriate audio Content for digit #2. Finally selecting your Leave a Message for digit #3 (Please see the Leave a Message chapter on how to create your Leave a Message menu).
  5. Save, and you're finished!

All existing Voice Menus will now appear in IVR Center > Voice menus

Audio Files In Depth

This section helps to provide you with a bit more about the audio files within Freedom Fone, and other approaches to creating menus.

A Menu Instruction can be generated in three ways:

  1. Customised audio files
  2. Customised text to speech
  3. Default text to speech

Customised audio files: If the administrator associates an audio file with a message, that file will be played to the caller when she enters the voice menu.

If an audio file has been uploaded to the voice menu, it can be exported as an .mp3 file by clicking the download icon .

Customised text to speech: If no audio file is provided for a message, but a customised text message exists, the text message will be synthesized and played to the caller.

If the voice menu includes one or more text prompts in the place of audio files AND you are NOT using a licensed copy of the default Cepstral voice, you will hear an automated voice play before each text prompt is synthesized, reminding you to buy a license. If you use your own audio files you do not need to use text to speech at all.

A license for the Allison 8 Khz voice for Linux can be bought from https://www.cepstral.com/. Once you get the license you can register the voice by running the swift executable from the command prompt as follows:

/opt/swift/bin/swift --reg-voice

Default text to speech: If neither an audio file, nor a customised text is provided, the default text will be synthesized and played to the caller.

A Menu option file can be used in one or more different Voice Menus. These files cannot be deleted if they are currently associated with a Voice Menu. The administrator can at any time add, edit or delete a Voice Menu. The administrator can create multiple Voice Menus and all can be active at the same time. Freedom Fone v.2.S offers the possibility to assign eight Menu Options to a Voice Menu. It is possible to link voice menus such that a menu option can lead to another voice menu which in turn gives more options to a caller.

Note that digits 0 and 9 are reserved for navigation.

What does Freedom Fone do?

Freedom Fone allows anyone with a phone to access or contribute information on a specific issue 24 hours a day and seven days a week. It takes advantage of audio and text to address language and literacy barriers when reaching out to marginalised audiences that don't have access to other media. No internet access is required by either you or your audience for this.

Freedom Fone uses interactive voice menus to deliver information to and record information from a caller. You will be familiar with this kind of menu already: "press 1 to access your account, press 2 to speak to a representative, press 3 to record a message...". We all sometimes have to deal with this kind of system when we dial a number to top up the credit on our mobile phone account, or to talk to a support person, etc.

Freedom Fone enables you to design your own interactive menus to:

There are no geographical limitations to Freedom Fone. In fact it can be used and deployed in all countries where there is mobile network coverage, and content can be recorded in any language - even multiple languages, simultaneously.

In addition to ordinary mobile phones, your callers can use landlines and internet-based phones to access the service. This means that Freedom Fone can receive and deliver crucial information via mobile phones or landlines in situations facing power constraints or where the Internet access is limited or interrupted.

Freedom Fone provides an installer that automates much of the setup, empowering a non-technical user to independently set up a sophisticated telephony server in under 30mins.

Once you're set up, an easy graphical user interface lets you control everything you want to do through a simple 'dashboard'.

Please note: Freedom Fone also has some security features but please be aware that all phones and telephony services have security issues. We have provided chapters in this book that cover this issue from different perspectives. If security is an issue for you or your callers please read this material.