Reference16r1:Concept IP270

Applies To

• innovaphone IP270
• Firmware V16r1final 1610869 onwards

Requirements

• innovaphone PBX with at least firmware 16r1final 1610869
• innovaphone App Platform with Devices and Users Application with at least firmware 16r1final 1610869
• IP270 firmware with at least version 16r1final 1610869
• PhonePlatform with at least build 2165
• PBX-Port-license (once per user)
• App(softphone)-License (Order Number: 02-00050-004) and App(phone)-License (Order Number: 02-00050-005) required (once per user)
• optional app licenses (once per user)

Concept

myApps-powered phone for use with the innovaphone PBX

New hardware running a Yocto-based Linux distribution and hosting a native myApps IP270 client

Telephony via the myApps-Softphone-application provided by the innovaphone PBX

Additional services of the myApps application platform

Features

myApps-Features

See respective column for IP270 in myApps-platform services.

Telephony-Features

See columns for IP270 in myApps-SoftphoneApp features.

Headphone support

myApps-IP270 supports use of USB devices known for innovaphone desk phones.

Configuration

Start

The IP270 is factory-configured as a DHCP client and obtains an IP address from a DHCP server—if available—via the LAN connection.

When the device starts up, myApps launches automatically and offers the following configuration options upon first startup after delivery:

• Provisioning Code input field
• Start provisioning
• Skip provisioning

Text input after a factory reset or upon delivery can be performed using the onscreen keyboard or the device’s hardware keypad.

After successful provisioning, this page is no longer displayed.

The device can be reset to factory settings by performing a power cycle while holding down the Home button until the LED stops flashing. This resets the home screen to the provisioning state and disables SSH login and remote browser debugging.

Automatic Provisioning (Recommended)

When the device is started for the first time after delivery or factory reset, it displays the provisioning page, where a provisioning code can be entered.

The required provisioning code can be generated either by the administrator via UsersAdmin or by the user themselves via Profiles. In this process, the device is set up as a standard innovaphone phone. The generated provisioning code can be entered on the device via the provisioning page.

After the provisioning code has been successfully entered, the device is added to Devices and assigned to the user. The myApps login page is displayed and the device may attempt to load latest firmware. The LED flashes during this process.

The device automatically reboots after approx. 5 minutes.

Afterwards, externally connected input devices such as a mouse and keyboard can be used for myApps login and navigation.

In the user object, a device entry in the format “<ip270-mac> | Phone IP270, Softphone IP270 | phone,softphone” is created.

Upon successful connection to the server, the user’s login credentials can be entered.

Manual Configuration

Domain Assignment

After the device starts up, skip the provisioning process and go to “Change Server” on the myApps login screen.

There, select “Platform Setup” and enter your own Sysclient URL under / CONFIG / Sysclient URL.

Adapt the URL to your own domain in the following format

wss://<ap>.<domain>/<domain>/devices/sysclients

After confirming with Set, the device MAC appears in Devices and can be renamed and categorized there by the administrator.

User Assignment

• The administrator creates the device for the respective user via UsersAdmin
• A device entry is made in the User Object in the following format: HW-ID | Name1, Name2 | softphone,phone
• The HW-ID is the device MAC in the format 00903365xxxx, where xxxx are the last 4 digits of the serial number on the back label
• Name1 (e.g. Softphone IP270) identifies the SoftphoneApp. This must be set as the default telephony application on the IP270. It does not need to be visible on the home screen.
• Name2 (e.g. Phone IP270) identifies the PhoneApp, which allows the IP270 to be controlled from a PC. This must be launched on the PC.

myApps

Log in to myApps via the login screen using the on-screen keyboard. If the on-screen keyboard doesn't disappear automatically afterwards, tap an empty field in myApps.

The "Softphone IP270" mandatorily must be set as the default telephony application.
It is recommended to set the SoftphoneApp as focus application or to pin it.

Settings

• Lock: Lock screen manually
• Default Apps: "Softphone IP270" as telephony application
• More:
  • Display: Backlight brightness for active and standby modes, power-saving options with display switch-off for adjustable start and end times
  • Audio: Volume settings for ringtone, handset, speakerphone and headphone. Use with caution.
  • Lockscreen: Pin code and timeout in minutes, three different c-lock screens, emergency number list.
  • Trace: Definition of trace flags for error analysis. The trace file can be downloaded via the administrative UI.

Task bar

• Loudspeaker symbol: indicates set handsfree volume
• Counter [optional]: indicates active firmware upgrade process
• Warning sign [optional]: indicates enabled SSH and/or Remotebrowser debug connection. To be set via Administrative UI in Devices.

On-screen keyboard

Alphabetical keyboard with access to additional symbols via the Cmp key (Compose):

• Cmp + . to access more punctuation
• Cmp + - or , to access 'mathematical' symbols (+,-,=,etc)
• Cmp + ' or 0 or 9 to access more brackets and quotes
• Cmp + a to access variants with diacritics like á,à,â,ä,
• Cmp + q to access emojis

Return to alphabetical keyboard using the ABC key.

Administrative UI

Access via Devices or directly from the device via Platform Setup without myApps login. Following options are available:

• SHOW - display system status
  • ENET : NIC status, IP@ and MAC
  • OS-VERSION : used yocto build & publication date
  • SshD : SSH login status
  • SshD toggle : de/activate SSH login
  • UIDbg : Remotebrowserdebug status
  • UIDbg toggle : de/activate remote browser debugging

• UPDATE - manual update according to provided update server path
  • myApps Update : available myApps version to be installed upon selection
  • rootfs2 Update : available phone platform build to be installed upon selection

• CONFIG
  • Sysclient URL : URL to system device application for device management. Format : wss://<ap>.<domain>/<domain>/devices/sysclients Confirm entry with SET

• DEBUG - to be used when instructed by support
  • various menus to display dedicated function status.
  • TRACES : trace output according to set trace flags. Upon selection download to default download folder and opened in standard editor.
  • COREDUMP : list of present compressed core dump files. Upon selection download to default download folder. Download may take a while - do not select multiple times.

• REBOOT
  • restart system : reboot complete device
  • restart myApps : restart myApps only

Firmware Update

Device is operated with its own device firmware and hosts a native myApps client on top of it.

In the innovaphone Store (https://store.innovaphone.com/), the device firmware can be found under the "Phone Platform" tab.

In Devices, the device can access the device firmware via the domain upgrade using the URL https://store.innovaphone.com/release/download/phoneplatform.json.

The native IP270 myApps client is available in the Store under “Firmware” and is provided via https://store.innovaphone.com/release/download/firmware.json for the Devices upgrade.

During firmware update, the LED flashes. In the myApps taskbar, a yellow indicator displays firmware download progress in percent; a red indicator that the firmware is being installed.

Factory Reset

Reset the device to factory settings is performed by power cycle whilst holding down the Home button until the LED stops flashing.

Best practice use cases

The device can be used locally or controlled remotely. Intended use cases are described below.

Prerequisites

• Audio device used must always be connected locally to the IP270
• Video devices can be connected to the IP270 and/or the PC

Device Security

It is recommended to set a personal PIN and lock timer via myApps/Settings/More. After lock timer expiry and the device is locked automatically. Alternatively, the device can be locked manually via the myApps menu. The lock timer is not interrupted by input from an external device such as mouce or keyboard.

As security measure in case of forgotten PIN, after six incorrect PIN entries the user is logged out and system switches back to login screen.

Unlock using the button on the screen and enter the unlock code with the phone’s hardware keypad or an external hardware keyboard.

Audio Device Handling

General prioritization of audio devices when answering a call

1. Handset when lifted
2. Headphone if available and handset is not used
3. Speakerphone if no headphone is available and handset is not used

Switching audio devices during an active call:

• In the SoftphoneApp using the button
• On the device using the Microphone (= handset), Headphone, or Speaker buttons

Local Telephony

Outgoing calls

• Use the hardware keypad or SoftphoneApp to dial. When entering a number via the hardware keypad, the SoftphoneApp opens.
• When lifting the handset, outgoing call and all signaling tones are played through it.
• To route the call to a connected headphone, initiate the call using the headphone-button either on the headphone or the IP270.
• To play audio in hands-free mode, initiate the call using the speaker button.

Incoming calls

• When answering a call using the headphone-button either on the headphone or the IP270, the call is played through the headphone.
• When answering by lifting the handset, the call is played through the handset
• Answering via the speaker button on the device plays the call through the speaker in hands-free mode
• Alternatively, answer via the SoftphoneApp using the green handset icon. If no headphone is connected and the handset is on the cradle, the call is answered in hands-free mode.

Video

• Video playback takes place in myApps on the IP270 if a video camera is connected to the IP270-PhoneApp.
• No Remote Phone app may be open at the same time.

Remote Control via PC

IP270 can be remote controlled using the PhoneApp. It is recommended to set the IP270-PhoneApp as default telephony application on the PC.

Outgoing calls

• Dial via PhoneApp. A headphone connected to the IP270 is the default audio device; otherwise, the handset is used.
• During an active call, lifting the handset routes the call to the handset.
• Switch to speakerphone using the speakerphone button.

Incoming calls

• When answering a call using the headphone button either on the headphone or the IP270, the call is played through the headphone.
• When answering by lifting the handset, the call is played through the handset.
• Answering via the speaker button on the device plays the call through the speaker in hands-free mode.
• If the call is answered via the PhoneApp on the PC, it will be played through the headphone; otherwise the handset will be used.

Video

If the remote PhoneApp is opened on the PC or defined as default telephony application, the video call will be displayed there.

Troubleshooting

• Set trace options as told by innovaphone support via myApps-Client/More/Trace
• Collect traces at Devices/<IP270>/Debug TRACES and/or COREDUMPS . Tracefiles will be downloaded and opened automatically - stay patient and do not doubleclick!

Known restrictions

• No file downloads from applications
• No LLDP-med support
• USB input devices are detected after the provisioning reboot
• USB ports are not intended for charging devices such as cell phones, power banks, or similar items

Related Articles

Reference16r1:Concept_myApps_platform_services

https://wiki.innovaphone.com/index.php?title=Reference14r1:Concept_App_SoftphoneApp

https://wiki.innovaphone.com/index.php?title=Reference9:Concept_USB_Headset

https://wiki.innovaphone.com/index.php?title=Datasheet_IP270