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)
• Softphone-App-License (Order Number: 02-00050-004) and Phone-App-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-Softphone features.

Headset 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 home screen 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 a 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 on the device and the device may attempt to load latest firmware. The LED flashes during this process.

After approx. 5 minutes, the device automatically reboots.

Afterwards, externally connected input devices such as a mouse and keyboard can also 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.

After successfully connecting 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. IP270-Soft) 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. IP270-Remote) 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 on the login screen using the on-screen keyboard. If the on-screen keyboard does not disappear automatically tap an empty field in myApps.

The IP270 softphone mandatorily must be set as the default telephony application.
It is recommended to set the softphone as the focus application.

Settings

• Lock: Lock screen manually
• Default Apps: IP270-Softphone 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 headset. Use with caution.
  • Lockscreen: Pin code and timeout in minutes, three different c-lock screens, emergency number list. 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.
  • Trace: Definition of trace flags for error analysis. The trace file can be downloaded via the administrative UI at Devices > Debug/Traces and opened in the default editor.

Task bar

• Loudspeaker symbol: indicates set handsfree volume
• Counter [optional]: yellow indicates the firmware download progress in percent; red indicates ongoing installation 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 menues 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.

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.

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. Headset if available and handset is not used
3. Speakerphone if no headset is available and the handset is not used

Switching audio devices during an active call:

• In the Softphone app using the button
• On the device using the Microphone (= handset), Headset, or Speaker buttons

Local Telephony

Outgoing calls

• Use the hardware keypad or SoftphoneApp to dial. When entering a number via the hardware keypad, the softphone app opens.
• When lifting the handset, outgoing call and all signaling tones are played through it.
• To route the call to a connected headset, initiate the call using the headset-button either on the headset 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 headset-button either on the headset or the IP270, the call is played through the headset.
• 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 softphone app using the green handset icon. If no headset 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 toset the IP270-PhoneApp as the default telephony application on the PC.

Outgoing calls

• Dial via PhoneApp. A headset 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 headset-button either on the headset or the IP270, the call is played through the headset.
• 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
• When answering the call via PhoneApp on the PC, the call is routed to the connected headset; otherwise, it to the handset

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 certain applications (e.g. Connect or similar)
• 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