Mobile Phone Tests¶

Sipfront provides the ability to integrate real mobile devices into your test scenarios. This is achieved by running a Raspberry Pi with a specific Sipfront image in your premises, and connect your phones to that device via Bluetooth.

With this approach, you can test calls from SIP or WebRTC via your peerings to the mobile network and vice versa, utilizing the radio technology your phones are attached to, such as 4G or 5G.

Requirements¶

• Raspberry Pi 4 or 5 with 8GB of RAM
• An 8GB (or larger) microSD card
• Any phone (Android, Apple, ...) with Hands-Free support via Bluetooth (any reasonably newish phone with Bluetooth should work)

Installation¶

1. Download the latest Sipfront image for Raspberry Pi from the Sipfront CDN.
2. Flash the image onto the microSD card using a tool like Balena Etcher. Check our Generic Raspberry Pi Installation Guide for more details.
3. Reinsert the microSD card using your SD card reader on your machine where you flashed the image (it will show as bootfs in your drives list) and open sipfront.txt with a text editor.
4. Set the following configuration. If you did not yet create a custom agent pool, do so first in the Account > Agent Pools menu.

# the device will be accessible in your LAN via $AGENT_HOSTNAME.local
AGENT_HOSTNAME="sipfront-agent"

# fill in your Sipfront agent credentials
AGENT_POOL_ID="your-pool-id"
AGENT_POOL_SECRET="your-pool-secret"
AGENT_POOL_GROUP="raspi"
AGENT_POOL_IMAGE="sipfront/agent:mobile-driver"

# fill in your WiFi credentials to enable wifi
AGENT_WIFI_SSID="your-wifi-ssid"
AGENT_WIFI_PASSWORD="your-wifi-pass"

# set to yes to enable mobile phone testing via bluetooth
AGENT_PHONE_DRIVER="yes"

If everything went fine, you should see your agent (listed as raspi if you used the configuration above) online in the Account > Agent Pools menu.

Connecting your phone¶

iPhones¶

1. On your phone, navigate to Settings > Bluetooth and enable Bluetooth.
2. In the list of available devices, you should see sipfront-agent (or the AGENT_HOSTNAME you set in the sipfront.txt config file) listed. Tap on it to connect.
3. If it asks you to allow syncing contacts etc., allow it.

Android Phones¶

1. On your phone, navigate to Settings > Connections > Bluetooth and enable Bluetooth.
2. In the list of available devices, you should see sipfront-agent (or the AGENT_HOSTNAME you set in the sipfront.txt config file) listed. Tap on it to connect.
3. If it asks you to allow syncing contacts etc., allow it.

Create your first test¶

1. In the Sipfront app, navigate to an existing test project or create a dedicated project for your mobile phone tests.
2. Click the Create new test button at the top.
3. Give it a descriptive name and description.
4. Select the Mobile call - Calling Party Only test scenario, which is the most simple mobile test to start with.
5. Under Choose agent pool, select the agent pool you configured in your sipfront.txt Raspberry Pi configuration file.
6. Under Agent Group in the Configure your caller select raspi (or the group you defined in AGENT_POOL_GROUP in your sipfront.txt). Note that the group only becomes available once the Sipfront agent on your Raspberry Pi is online. If it's missing, it's a good indicator that there is a general configuration problem with the Raspberry Pi.
7. Enter the phone number you'd like to call in the Dial Destionation field of the section below, and optionally adapt the Stop after time limit (e.g. setting it to 30 for a first quick test).
8. At the bottom, click Save & Run.

This should trigger the test to run, and you should see the phone coming to life automatically after a few seconds, displaying the native dialer screen and showing the call being placed to the destination number you specified.