Callisto Knowledge Base

This page is optimized for desktop computers and tablets. To access it, try one of the following points:

  • Access this page from a different device.
  • If you’re on a tablet, rotate it.
  • Check the “Desktop site” option in your browser settings.
Return to CTModule homepage
Knowledge Base
BabyPhone › BabyPhone Mobile manual

Setup

Table of Contents

BabyPhone Mobile needs to be installed by an administrator on all mobile devices that are intended to be used with BaybPhone. The application can be installed using any MDMMobile Device Management platform or manually by installing the generated .apk file from the phone’s file system. After the application is installed, the several parameters must be set by an administrator. There are multiple methods to set the parameters (see section Setting parameters).

Required settings

The following parameters are mandatory.

Callisto IP address

The IP address of the Callisto installation.

Paramerer name: callisto_address

MDM console intent: SET_CALLISTO_ADDRESS
Baby phone

The line number associated with the BabyPhone instance in Callisto.

Paramerer name: baby_phone

MDM console intent: SET_BABY_PHONE
Application name

The name of the BabyPhone instance set up in Callisto.

Paramerer name: app_name

MDM console intent: SET_APP_NAME
UCM IP address

The IP address of the UCM associated with Callisto.

Paramerer name: ucm_address

MDM console intent: SET_UCM_ADDRESS
SIP Username

The SIP username as defined on UCM.

Info: If auth_type is set to digest, set this parameter to the Directory Number as defined on the UCM.

Paramerer name: sip_username

MDM console intent: SET_SIP_USERNAME
Authentication Type

The authentication type to use. Supported options are:

  • Plain text (value: plain)
  • Digest (value: digest)

Paramerer name: auth_type

MDM console intent: SET_AUTH_TYPE
Authorization Username

Only used if auth_type is set to digest. The digest authorization username defined on the UCM.

Paramerer name: auth_username

MDM console intent: SET_AUTH_USERNAME
Password

The SIP password as defined on the UCM.

Paramerer name: sip_password

MDM console intent: SET_SIP_PASSWORD

Optional settings

The following parameters may be omitted when configuring the application.

Start monitoring by entering Cabin number*

Boolean. If set to true, the staff can manually enter a cabin number to assign a cabin phone to the mobile device.

Paramerer name: start_monitoring_with_cabin_number

MDM console intent: SET_START_MONITORING_WITH_CABIN_NUMBER
Start monitoring by scanning the QR code *

Boolean. If set to true, the staff can use the QR code feature of Callisto BabyPhone to assign a cabin phone to the mobile device.

Paramerer name: start_monitoring_with_qr_code

MDM console intent: SET_START_MONITORING_WITH_QR_CODE
Incoming calls

Boolean. If set to false, any incoming call with a number number different to the number set in the baby_phone parameter will be rejected automatically by the mobile device. Default value is false.

Warning: During active calls, no alarm notifications by the BabyPhone service can be received.

Paramerer name: incoming_calls

MDM console intent: SET_INCOMING_CALLS
Save logs

Boolean. If set to true, logs for BabyPhone Mobile are written. They are saved to a text file on the mobile device in the directory located at InternalStorage/Android/data/com.callistocruise.babyphone/files/BabyPhone/log. Depending on the system of the mobile device, this path may vary.

A new log file is created for every day, and files older than three days are deleted automatically.

Info: Logs are only written when the application is running in the foreground.

Paramerer name: save_logs

MDM console intent: SET_SAVE_LOGS
Hide Settings Menu

Boolean. If set to true, the settings menu cannot be accessed form the application menu as a security measure. Default value is false.

Paramerer name: hide_settings_menu

MDM console intent: SET_HIDE_SETTINGS_MENU
Show Welcome Screen

Boolean. If set to true, an instruction screen is shown to the user when BabyPhone Mobile launches. Default value is false.

Paramerer name: show_welcome_screen

MDM console intent: SET_SHOW_WELCOME_SCREEN
* Either of these options must be set to true for guests to be able to start monitoring with the mobile device. Otherwise, guests can activate monitoring only over the cabin phone.

Setting parameters

Three methods are available to configure the application with the settings mentioned above:

  1. Use an MDM tool and provide the parameters in a configuration scheme.
  2. Use an MDM console to set the parameters by firing their corresponding intents.
  3. In the BabyPhone mobile application, tap the menu button and navigate to the Settings menu.

The BabyPhone application implements managed configuration settings, so parameters can be configured by setting attributes over the MDM IT admin console.

Important: Using the Settings menu has lower priority than parameters set through MDM: Any settings made in the menu will be overwritten when reconfigured using MDM, and if a configuration scheme exists, the settings in the menu become read-only. Therefore, using the Settings menu is only recommended for testing purposes.

Example: Set the parameters with a configuration schema using Custom Settings within VMWare Workspace ONE MDM:

<characteristic type="com.airwatch.androidwork.app:com.callistocruise.babyphone" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
    <parm name="callisto_address" vaule="192.168.100.109" type="string">
    <parm name="baby_phone" vaule="9297" type="string">
    <parm name="app_name" vaule="BabyPhone" type="string">
    <parm name="ucm_address" vaule="192.168.100.198" type="string">
    <parm name="sip_username" vaule="1107" type="string">
    <parm name="auth_type" vaule="plain" type="string">
    <parm name="auth_username" vaule="" type="string">
    <parm name="sip_password" vaule="1107" type="string">
    <parm name="start_monitoring_with_cabin_number" vaule="True" type="boolean">
    <parm name="start_monitoring_with_qr_code" vaule="False" type="boolean">
    <parm name="save_logs" vaule="False" type="boolean">
    <parm name="incoming_calls" vaule="False" type="boolean">
    <parm name="hide_settings" vaule="True" type="boolean">
    <parm name="show_welcome_screen" vaule="True" type="boolean">
</characteristic>

If the configuration schema is not readable by the MDM console, the parameters can also be set using console intents. Each parameter’s console intent is listed above.

Info: If the phone is part of an MDM system, configuration using MDM has higher priority than manually set parameters. Manually set parameters will be overwritten if they are are present in a configuration scheme.

Example 1: Set the parameters using SOTI MDM.

sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_CALLISTO_ADDRESS;S.callisto_address=192.168.100.109;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_BABY_PHONE;S.baby_phone=9297;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_APP_NAME;S.app_name=BabyPhone;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_UCM_ADDRESS;S.ucm_address=192.168.100.198;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_SIP_USERNAME;S.sip_username=1107;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_AUTH_TYPE;S.auth_type=digest;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_AUTH_USERNAME;S.auth_username=babyphone1107;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_SIP_PASSWORD;S.sip_password=1107;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_START_MONITORING_WITH_PIN;B.start_monitoring_with_cabin_number=true;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_START_MONITORING_WITH_QR_CODE;B.start_monitoring_with_qr_code=true;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_SAVE_LOGS;B.save_logs=true;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_INCOMING_CALLS;B.incoming_calls=false;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_HIDE_SETTINGS_MENU;B.hide_settings_menu=true;end;"
sendintent -b "intent:#Intent;action=com.callistocruise.babyphone.intent.action.SET_SHOW_WELCOME_SCREEN;B.show_welcome_screen=true;end;"

Example 2: Set the parameters using VMWare Workspace ONE MDM.

mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_CALLISTO_ADDRESS,extraString=callisto_address=192.168.100.109
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_BABY_PHONE,extraString=baby_phone=9297
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_APP_NAME,extraString=app_name=BabyPhone
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_UCM_ADDRESS,extraString=ucm_address=192.168.100.198
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_SIP_USERNAME,extraString=sip_username=1107
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_AUTH_TYPE,extraString=auth_type=plain
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_AUTH_USERNAME,extraString=auth_username=babyphone1107
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_SIP_PASSWORD,extraString=sip_password=1107
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_START_MONITORING_WITH_PIN,extraBoolean=start_monitoring_with_cabin_number=true
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_START_MONITORING_WITH_QR_CODE,extraBoolean=start_monitoring_with_qr_code=true
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_SAVE_LOGS,extraBoolean=save_logs=true
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_INCOMING_CALLS,extraBoolean=incoming_calls=false
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_HIDE_SETTINGS_MENU,extraBoolean=hide_settings_menu=true
mode=implicit,broadcast=true,action=com.callistocruise.babyphone.intent.action.SET_SHOW_WELCOME_SCREEN,extraBoolean=show_welcome_screen=true

Once all required application parameters are set up, the BabyPhone service becomes active and is ready to enter monitoring mode. The service can be terminated by navigating to the Phone Settings > Apps, locating the BabyPhone application and choosing Force Stop.

Additional settings

Since the Android operating system is open-source software, it might be necessary to configure additional settings or permissions depending on the version and distribution.

To work properly, BabyPhone Mobile needs permission to show notifications in any phone state (including lock screen etc.), and it needs to be able to run services without any interruption. This is especially important when power saving tools are active on the phone; since such tools might suspend or stop application services, make sure that BabyPhone Mobile is not affected.