Reference16r1:Concept IP270: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
← Older editNewer edit →
VisualWikitext
mNo edit summary
mNo edit summary
Line 9: Line 9:
* PhonePlatform with at least build 2165
* PhonePlatform with at least build 2165
* PBX-Port-license (once per user)
* 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)
* 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)
* optional app licenses (once per user)


Line 17: Line 17:
New hardware running a Yocto-based Linux distribution and hosting a native myApps IP270 client
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
Telephony via the myApps-Softphone-application provided by the innovaphone PBX


Additional services of the myApps application platform
Additional services of the myApps application platform
Line 26: Line 26:


=== Telephony-Features ===
=== Telephony-Features ===
See columns for IP270 in [[Reference16r1:Concept_App_SoftphoneApp#Features|myApps-Softphone features]].
See columns for IP270 in [[Reference16r1:Concept_App_SoftphoneApp#Features|myApps-SoftphoneApp features]].


=== Headset support ===
=== Headphone support ===
myApps-IP270 supports use of [[Reference9:Concept_USB_Headset|USB devices known for innovaphone desk phones]].
myApps-IP270 supports use of [[Reference9:Concept_USB_Headset|USB devices known for innovaphone desk phones]].


Line 42: Line 42:
Text input after a factory reset or upon delivery can be performed using the [[#On-screen keyboard|onscreen keyboard]] or the device’s hardware keypad.
Text input after a factory reset or upon delivery can be performed using the [[#On-screen keyboard|onscreen keyboard]] or the device’s hardware keypad.


After successful provisioning, this home screen is no longer displayed.  
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.
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) ===
=== 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.
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 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.
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 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.  


After approx. 5 minutes, the device automatically reboots.
The device automatically reboots after approx. 5 minutes.


Afterwards, externally connected input devices such as a mouse and keyboard can also be used for myApps login and navigation.
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.
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.
Upon successful connection to the server, the user’s login credentials can be entered.


=== Manual Configuration ===
=== Manual Configuration ===
Line 78: Line 78:
* A device entry is made in the User Object in the following format: HW-ID | Name1, Name2 | softphone,phone
* 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
* 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.
* 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. IP270-Remote) identifies the PhoneApp, which allows the IP270 to be controlled from a PC. This must be launched on the PC.
* 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 ===
=== myApps ===
Log in to myApps on the login screen using the on-screen keyboard.
Log in to myApps via the login screen using the on-screen keyboard.
If the on-screen keyboard does not disappear automatically tap an empty field in myApps.
If the on-screen keyboard doesn't disappear automatically afterwards, tap an empty field in myApps.


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


==== Settings ====
==== Settings ====
* Lock: Lock screen manually
* Lock: Lock screen manually
* Default Apps: IP270-Softphone as telephony application
* Default Apps: "Softphone IP270" as telephony application
* More:
* More:
** Display: Backlight brightness for active and standby modes, power-saving options with display switch-off for adjustable start and end times
** 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.
** 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.
** 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 at Devices > Debug/Traces and opened in the default editor.
** Trace: Definition of trace flags for error analysis. The trace file can be downloaded via the administrative UI.


==== Task bar ====
==== Task bar ====
* Loudspeaker symbol: indicates set handsfree volume
* Loudspeaker symbol: indicates set handsfree volume
* Counter [optional]: yellow indicates the firmware download progress in percent; red indicates ongoing installation process
* 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.
* Warning sign [optional]: indicates enabled SSH and/or Remotebrowser debug connection. To be set via Administrative UI in Devices.


Line 130: Line 130:


* DEBUG - to be used when instructed by support
* DEBUG - to be used when instructed by support
** various menues to display dedicated function status.
** 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.
** 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.
** 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.
Line 147: Line 147:
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.
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.
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 ==
== Factory Reset ==
Line 171: Line 171:
General prioritization of audio devices when answering a call
General prioritization of audio devices when answering a call
# Handset when lifted
# Handset when lifted
# Headset if available and handset is not used
# Headphone if available and handset is not used
# Speakerphone if no headset is available and the handset is not used
# Speakerphone if no headphone is available and handset is not used


Switching audio devices during an active call:
Switching audio devices during an active call:
* In the Softphone app using the button
* In the SoftphoneApp using the button
* On the device using the Microphone (= handset), Headset, or Speaker buttons
* On the device using the Microphone (= handset), Headphone, or Speaker buttons


=== Local Telephony ===
=== Local Telephony ===
==== Outgoing calls ====
==== Outgoing calls ====
* Use the hardware keypad or SoftphoneApp to dial. When entering a number via the hardware keypad, the softphone app opens.  
* 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.
* 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 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.
* To play audio in hands-free mode, initiate the call using the speaker button.


==== Incoming calls ====
==== 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 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
* 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
* 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.
* 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====
* Video playback takes place in myApps on the IP270 if a video camera is connected to the IP270-PhoneApp
* 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.
* No Remote Phone app may be open at the same time.


=== Remote Control via PC ===
=== 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.
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 ====
==== Outgoing calls ====
* Dial via PhoneApp. A headset connected to the IP270 is the default audio device; otherwise, the handset is used.
* 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.  
* During an active call, lifting the handset routes the call to the handset.  
* Switch to speakerphone using the speakerphone button.
* Switch to speakerphone using the speakerphone button.


==== Incoming calls ====
==== 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 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
* 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
* 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
* 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====
====Video====
Line 217: Line 217:


== Known restrictions ==
== Known restrictions ==
* No file downloads from certain applications (e.g. Connect or similar)
* No file downloads from applications
* no LLDP-med support
* No LLDP-med support
* USB input devices are detected after the provisioning reboot
* 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
* USB ports are not intended for charging devices such as cell phones, power banks, or similar items

Revision as of 09:43, 29 April 2026

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

Retrieved from "https://wiki.innovaphone.com/index.php?title=Reference16r1:Concept_IP270&oldid=79710"