Yamaha ProVisionaire Touch V1 2 Setup Guide
ProVisionaire Touch V1.2
EN
Setup Guide
Thank you for downloading Yamaha ProVisionaire Touch.
ProVisionaire Touch is an application for remotely controlling a
system (a system consisting of devices that can be controlled by
this application, such as MusicCast devices or Disklavier units
and an MTX/MRX system) from a tablet (iPad) via a Wi-Fi network.
You can design a control panel by freely arranging widgets, allowing you to create custom panels that suit the needs of your system.
Who should read this document
This is a guidebook intended for those who design, produce,
and set up custom control panels using this application.
It is not a guidebook for general users.
Note
• All copyrights for this software and setup guide are the property of Yamaha
Corporation.
• Unauthorized copying or modification of this software or setup guide in part
or in whole is prohibited.
• Please be aware that Yamaha Corporation accepts no responsibility for any
results or consequences that may follow from the use of this software and
setup guide.
• All of the illustrations and screen shots in this setup guide are provided for
the purpose of explaining operations.
For this reason, they may differ from the actual specifications.
• Apple, the Apple logo, and iPad are registered trademarks of Apple Inc. in
the United States and in other countries.
• IOS is a trademark or registered trademark of Cisco in the U.S. and other
countries and is used under license.
• Windows is a registered trademark of Microsoft(R) Corporation in the United
States and other countries.
• Please be aware of copyright when using audio sources for a commercial purpose. Infringement of copyright is prohibited by law.
• Company names and product names appearing in this document are the
trademarks or registered trademarks of their respective owners.
• The application software may be updated without notice for improvement.
The latest application software can be downloaded from the App Store.
Manual Development Group
© 2015 Yamaha Corporation
Published 10/2016 PO-D0
1
Contents
What you can do using ProVisionaire Touch ...........................................................3
Operating requirements of the software ..................................................................4
Terms and concepts to understand ......................................................................... 5
Installation procedure ..............................................................................................7
Startup.....................................................................................................................7
Basic process........................................................................................................ 10
Operations for common settings............................................................................20
About the menu bar...............................................................................................23
Settings file management — the File Management button.................................... 25
Selecting multiple widgets — Multi Select button ..................................................27
Creating a custom panel — the Page Edit button..................................................28
Widget design........................................................................................................33
Assigning parameters............................................................................................41
Switching pages — the Page Selection button (Control mode)............................. 50
Managing pages — the Page Management button (Design mode).......................51
Registering devices to control — the Device Management button ........................ 55
Control panel settings — the Setup button............................................................58
Control panel information — the Information button..............................................60
Preparations before you make connections...........................................................61
Troubleshooting ..................................................................................................... 65
About the software license ....................................................................................67
2
What you can do using ProVisionaire Touch
• Using ProVisionaire Touch, you can use your tablet device to intuitively place widgets such as sliders, buttons,
and photos on the page (screen) to create an original touch control panel that fits the requirements of your
installation and your needs, all without requiring any special programming.
• Since you can create multiple design pages, a separate control panel could be created for each area and user,
or you can create design pages for specific presets or parameter states.
You can restrict access to control panels and design pages, ensuring secure and convenient operation of the
controller.
• Data for a completed control panel can be exported as a file, allowing you to use the same controller for multiple
units, or you can save the data as a template and use or share it with other systems. This lets you create controllers efficiently and conveniently.
• Since connection with the target system occurs via Wi-Fi, the tablet device does not have to be mounted on the
wall; it can be operated while held in the hand, and used as a convenient remote controller.
• You can create a settings file for ProVisionaire Touch Kiosk, which is optimized for remote control (subsequently
referred to as Kiosk).
When reading this document
The term “preset” appearing in explanations of the screens and functions of this
application is used in two different senses: “images and materials provided for you to
use in a color palette” and “preset data managed by the processors of the MTX/MRX
system.” For clarity, the word “preset” is used to denote the first sense (provided
materials), and [Preset] denotes the second (preset data of the MTX/MRX system).
Keep this in mind as you read.
3
Operating requirements of the software
Tablet device (iPad) with ProVisionaire Touch
or ProVisionaire Touch Kiosk installed
Wireless LAN
connection
Wi-Fi access
point
CAT5e cable
Target system
• Tablet device
• Hardware: Apple iPad (except for first-generation)
• OS: iOS 8.3 or later
* For the latest information about devices and OS versions that are
known to work, refer to the following website.
http://www.yamahaproaudio.com
* This software does not work on iOS devices other than the iPad.
• Yamaha MTX/MRX system
• Yamaha ENSPIRE series (Disklavier Pianos)
• Products compatible with Yamaha MusicCast (this appli-
cation does not support music distribution between
devices)*
* Refer to the following site for details on products that are compatible
with ProVisionaire Touch and ProVisionaire Touch Kiosk.
http://www.yamahaproaudio.com
• Wi-Fi access point (802.11n/5 GHz is recommended)
• Cat5e cable (for connection between the target system
and the Wi-Fi access point)
Systems that can be controlled
• For one MTX/MRX system device, up to eight controllers can be
connected, including Wireless DCP or AMX/Crestron units.
Settings
• Three access control levels can be specified:
Power User, Administrator, and Screen Lock.
• The Monitor Device function can be used to monitor the target
system.
• An iPad can be set up as a dedicated terminal for this application (controller).
4
Terms and concepts to understand
Roles
ProVisionaire Touch uses the following roles.
• Administrator
The person who designs and edits the control panel (mainly the installation contractor.)
This is the person reading this setup guide.
A four-digit Administrator Code is used to lift restrictions on functions.
•Power User
Someone such as a manager of the facility.
This person uses a four-digit Power User Code to access a restricted
page or to edit a settings file.
•Staff
A person who operates the parameters.
This person uses a four-digit Unlock Code to unlock the screen lock.
• Guest
A person who has no operating privileges.
Pages
In ProVisionaire Touch, a screen consisting of multiple widgets (such as
buttons and sliders) is called a “page.”
Using this application, you can design up to 50 pages of different screens
that are suitable for the installed location or the users who use the system.
There are also the following pages for special purposes.
•Home Page
This page is shown when a monitor device has not been specified, or
when offline.
If the [Auto-load this file on next launch] switch is turned on when you
load the file, this page appears when you start ProVisionaire Touch.
• Fallback Page
This page is shown when a [Preset] recall automatically switches the
page (when an Auto Page Change occurs).
Although it is not a page, you can also specify the screen that is shown in
the screen-locked state.
Each role can perform the following actions.
Adminis-
trator
Unlock the screen lock — — —
Operate parameters —
Edit settings files ——
Edit design pages ———
Power
User
Staff Guest
5
Files
ProVisionaire Touch uses the following files.
• Settings file (extension .ypvt)
• Initial Mode
This is the mode in which no settings file has been loaded. From this
mode, loading a settings file takes you to Design Mode or Control Mode.
This file contains all the settings of ProVisionaire Touch. It contains data
and images for multiple pages, and information on the devices being
controlled (including the contents of the Remote Control Setup List).
Settings files can be sent to another iPad via AirDrop or email, or shared
via iTunes on a computer.
• Settings files for ProVisionaire Touch Kiosk (extension .ypvk)
This is a settings file only for loading into ProVisionaire Touch Kiosk.
Settings files can be sent to another iPad via AirDrop or email, or shared
via iTunes on a computer.
• Remote Control Setup List (extension .rcsl)
This file can be exported from MRX Designer’s “Remote Control Setup
List” dialog.
It allows ProVisionaire Touch to load MRX parameter assignments.
When this file is placed in the Documents folder of P.V. Touch, it can be
read by ProVisionaire Touch.
Modes
ProVisionaire Touch has the following modes.
Other
This setup guide also uses the following terms.
•Widget
Parts such as sliders, buttons, images, and rectangles used in the graphical user interface (GUI). You can assign parameters of the devices to
these parts, and synchronize them to the faders or on/off parameters.
•AirDrop
Wireless file transfer technology provided on iOS7 or later devices.
Devices that support AirDrop can share data directly between iPad units
without going through an access point (P2P).
•Kiosk
This is used as an abbreviation for ProVisionaire Touch Kiosk.
•Design Mode
In this mode you can create and edit pages. You must have Administrator privileges to use this mode. In this mode, ProVisionaire Touch is not
online with the target system.
• Control Mode
In this mode you can load settings files, and go online with the target
system. You must have Administrator or Power User privileges to use
this mode. This mode is also used to verify operation while designing a
page.
6
Installation procedure
File Management
button
Initial Mode
Startup
Download “ProVisionaire Touch” from the App Store.
You will find a link on the MTX/MRX product page of the Yamaha
Pro Audio website.
http://www.yamahaproaudio.com/
1. Tap the “ProVisionaire Touch” icon.
2. The app starts in [Initial Mode].
3. On the menu bar, tap the File Management button
.
7
If there is no settings file, the following screen
File name
Te m p l a t e
appears.
If there are already some settings files, a list of
those files appears.
* If you want to edit an existing settings file, select the file and then
[Load] it.
4. To create a new file, tap the [+] button in the upper left
corner of the screen.
The following dialog appears.
5. Enter the file name, select the “Blank” template, and
tap [Done].
* You can enter a file name of up to 32 characters, excluding the extension
name.
* Several <Sample> files are provided as templates. You can edit and save
these, so use them to get ideas for your own setup.
* If you tap the [+] button while in Control mode, the confirmation message
“Creating a new file will replace the current file. Are you sure?” appears.
8
6. In [Design Mode], which is the mode where you
File name
Design Mode
Page name
What if the screen goes blank?
In some cases, the page you’ve prepared in step 6 will disappear
from view if no further steps are performed for several seconds, and
will become inoperable. This is a function called Screen Lock,
which prevents an unauthorized person from performing operations.
Tap the screen to make the screen unlock code input screen appear.
By default, the code is “0000.” When you input the code, the previous page reappears. To disable this function, refer to Screen Lock.
How do I stop or resume file editing?
If you stopped editing a file and then want to resume editing it, but
you don’t want to repeat the process of selecting a file, loading it,
and entering the access code, you can use the “Auto Load” setting.
When the app is started, the specified file will open in the state in
which it was last closed.
design a custom control panel, the page (named Page
1) is shown.
This completes preparations for creating a control panel.
You can create a custom control panel for the target system by placing widgets such as sliders and buttons in this screen and assigning
parameters to them.
In the next step we use a simple example to explain the process of
creating a control panel, making settings, connecting to the network,
and delivering the completed system.
* If you don’t want the Function Guide (yellow popup hint) to appear on the
screen, tap the Function Guide button .
9
Basic process
Ta p
Pl
a
c
e
d
Using the creation of a simple control panel as an example, this section explains the process of creating a panel and using it to control
the system.
Saving data
In this app, the changes you make to the page are automatically saved in the settings file.
1. Place buttons
First place the buttons that you want to use as on/off switches.
1. In the menu bar, tap the Page Edit button .
2. In the widget menu, tap the button icon.
The button is placed on the panel.
* To close the widget menu, tap the panel background.
3. Move the button where you want it.
A dotted line and white circles appear around the button that you
placed. You can move the button by dragging a portion of it that’s not
a white circle. You can change the size by dragging a white circle.
* If the dotted line and white circles are not shown, long-press the button to
10
make them appear.
* You can specify “Grid” for convenience when changing the size or loca-
tion.
* If you specify “Fixed Size,” the size will be fixed and cannot be changed.
2. Specify devices and parameters
Now let’s specify a device and a parameter that will be controlled by
this button.
1. In the [Devices] screen that appears when you tap the
Device Management button in the menu bar,
specify the device that will be controlled. Register-
ing a device
For this example, set [Model] to “MTX3,” and [Unit ID] to “01.”
Assign a [Name] as you please. If there is a specific device that you
want to specify, read “Registering a device” and also specify the
appropriate monitor device.
2. Tap the button to access the following context menu.
5. In the [Devices] list, tap “the device that you specified
in step 1.”
A list of the assignable parameters appears.
Select the parameter that you want this button to turn on/off. For
example if you want the button to turn the channel 1 input on/off,
make the setting shown in the screen below.
3. Tap [Parameter].
The [Button Parameter Assign] screen appears.
4. To assign one parameter to the button, tap the func-
tion name of the button at the right edge of the [Mode]
field, and choose [Single Latch] from the menu that
appears.
The function name for an on/off switch will be [Single Latch].
* The setting screen differs depending on the selected button Mode.
* For details, refer to “Assigning parameters.”
6. Tap [Done] to complete the assignment.
* The icon which indicates that parameter assignment is incomplete
disappears when the parameter has been assigned.
11
3. Specify the button on/off indication
Let’s make the button change color to indicate its on/off state.
3. Tap the [Color] field to access the color setting
screen. Switch the [Color] tab and [Preset] tab, and
specify the color of the button in the On state.
For details on color settings, refer to “Specifying a color.”
1. Tap the button to access the context menu, and tap
[Design].
2. In the upper part of the screen, tap the [On] tab.
The following screen appears.
4. Tap [Back] to return to the previous screen.
5. In the same way, use the [Off] tab to specify the color
of the button in the Off state.
Now let’s verify that the button changes color between On and Off.
6. Tap the operation mode button to switch to “Con-
trol Mode.”
7. Tap the button, and verify that the button changes
color as you specified.
8. Tap the operation mode button to switch to
“Design Mode.”
In addition to the button’s color, you can change things such as the
rounding of its corners and the design, thickness, and color of its
border. For details, refer to “Widget design.”
12
4. Place a slider
Let’s place a slider that controls the volume.
1. In the menu bar, tap the Page Edit button .
2. In the widget menu, tap the slider icon and then move
it where you like.
3. The device that will be controlled is the same as the
one you specified for the button, so there’s no need to
specify it again.
Of course you are also free to specify a different device.
4. Tap the slider, and tap [Parameter] in the context
menu.
The [Slider Parameter Assign] screen appears.
5. In the [Devices] list, tap the “device” that you speci-
fied in step 1 of “2. Specify devices and parameters.”
A list of the assignable parameters appears.
Select the volume parameter that you want to control using this slider.
For example if you want the slider to adjust the channel 1 input level,
make the setting shown in the screen below.
* For more about [Upper], [Lower], [Home Position],and [Tooltip], refer to
“Assigning parameters.”
6. Tap [Done] to complete the assignment.
Move to control mode, and operate the slider to check it.
You can also change the design of the slider as you did for the button. For details, refer to “Widget design.”
13
5. Place a text panel
Let’s place a rectangle, and add text such as an operation guide, caution, or button or slider name.
* A rectangle does not have a device setting or parameter assignment.
1. In the menu bar, tap the Page Edit button .
2. In the widget menu, tap the rectangle icon, and then
change its location and size.
3. Double-tap the rectangle.
Enter text using the on-screen keyboard, and then tap somewhere
other than the rectangle to complete the entry.
* You can also enter Japanese.
* If you want to change the font type or size, tap the rectangle, and then tap
[Text] in the context menu.
14
6. Set the background
Let’s place an image as the panel background. In advance, place the
image that you want to use in the “Photos” app of the iPad.
1. In the menu bar, tap the Page Edit button .
2. Tap [Background] to access the background menu
screen, and turn the [Image] screen On ( ).
This completes one page of a control panel.
When controlling a target system, you will often want to have multiple control panels for different uses or setups of the building. To
explain how to handle multiple pages, let’s create one more page.
3. Tap the [Select Image] field, and in the screen that
appears, tap the [Photos] tab.
The image data in the “Photos” app of the iPad is shown.
If you want to use image data from the “Images” folder inside the
Documents folder of PV Touch, tap the [Imported] tab.
4. When you select the background image, it is immedi-
ately placed as the background.
Use [Expansion Mode] to specify how the image fits the background.
Specifying an image.
15
7. Create one more page 8. Specify an access code for the page
1. On the menu bar, tap the Page Management button
.
2. Tap [Add Page]; the new page name input screen
appears. Enter the page name and tap [Done]; the new
page is created, and you can place widgets on it to
create the page.
* You can also Duplicate the existing Page 1 and edit it.
Let’s specify access so that no authentication is required for Page 1
and authentication with a power user is required for Page 2.
1. On the menu bar, tap the Page Management button
, and then tap [Edit].
The page management screen appears.
In Control mode, you can tap the Page Selection icon in the menu
bar to switch the page that is displayed.
* For more about the Home Page and Fallback Page, refer to “Managing
pages.”
2. In [Select Page], in the [Page 2] field, tap [>].
The Page 2 settings screen appears.
16
3. Turn the [Power User Code] switch On ( ).
4. Move to Control mode, and tap the Page Selection but-
ton .
Verify that an icon is shown to indicate that authentication is
specified for Page 2.
9. Specify screen lock settings
Screen lock is a function that prevents operation by people with no
operating privileges after a specified time has elapsed since the last
operation.
* Screen lock settings can be made from either Design mode or Control mode.
1. On the menu bar, tap the Setup button , and then
tap [Screen Lock].
* For a newly created file, the power user code is unset (blank). Make this
setting in “Edit Power User Code.”
2. Turn [Enable] On ( ), and set [Unlock Code] and
[Time] as necessary. You can also use [Select Image]
and [Expansion Mode] to specify an image that is displayed when the screen is locked.
* For details, refer to “Screen Lock.”
17
10. Complete the settings file 11. Send the settings file to another iPad
This completes settings for the control panel.
To finish the procedure, specify or check the following items.
• Administrator code
• Enter information about the project
• Image files you used
1. Specify the administrator code. This will be unset
(blank) for a newly created file, but be sure to specify
an administrator code before you deliver the project.
For details on how to specify this, refer to “Edit
Administrator Code.”
2. Enter the project history for the settings file in the
[Information] field. Enter information such as the date
the project was created, the hardware and software
environment, and a contact in the event that there is a
problem. For details on entering this information, refer
to “Control panel information.”
Send the settings file to the iPad that will take delivery of the project.
* In advance, install this app or Kiosk to the destination iPad.
1. On the menu bar, tap the File Management button
.
2. Tap the settings file that you want to deliver; when the
context menu appears, tap [Send].
The Mail, AirDrop, Copy to P.V.Touch-K, and File Transfer icon
appears. Pass the settings file to the recipient iPad via email attachment, via AirDrop, or via direct communication between iPad units
(P2P). The file is saved in the Documents folder of the destination
iPad. For details, refer to “Send.”
3. As necessary, export the settings as a Kiosk settings
file.
18
12. Dedicating an iPad as a control panel
Here we explain how you can use an iPad as a dedicated controller
for a target system. Make these settings as necessary.
* If you specify Guided Access, this app will be the only app that can be used
on the iPad; it will not be possible to select other applications by pressing the
home button.
1.
Start this app or Kiosk, and specify the auto load setting.
“Load”
2. In the home screen of the iPad, tap the [Settings] icon;
in the settings menu, tap [General].
3. In the General menu, choose [Accessibility]
[Guided Access], and turn the guided access switch
On ( ).
This ends the explanation of the basic workflow.
Start the iPad, and verify that you can control the target system from
the control panel that you created.
* When you start ProVisionaire Touch or Kiosk, the app automatically searches
for a Wi-Fi access point and the target system, and connects to them.
For details on making connections, refer to “Preparations before
you make connections.”
4. After this app or Kiosk has started, click the home but-
ton three times.
The Homepage of this app (control panel) appears. If there is a region
for which you want to disable screen touch, use your finger to outline
that area. You can also disable the hardware button or specify a time
limit.
5. In the upper right corner of the screen, tap [Start]; a
passcode setting screen appears. Enter a four-digit
passcode; guided access is enabled.
If Guided Access is enabled, pressing the home button does not close
this app (control panel).
To close the app, click the home button three times and enter the passcode to end Guided Access.
19
Operations for common settings
Storing
a color
Here we explain settings and operations that you will frequently
encounter while using this app. Even if the contents of the display
are slightly different, the basic operations are the same.
Specifying a color
In the [Color] tab you can specify a desired color by adjusting the
sliders in the lower part of the screen. After creating a color, you can
drag it to one of the four palettes at the right to store it as a user
color.
In the [Preset] tab, you can choose a desired color from 32 colors (8
colors 4 hues).
20
Specifying an image
When placing an image on a widget or background, the following
setting screen appears.
* Widget Image directly accesses the screen shown at right.
Tap the [Select Image] field, and from the source image groups that
appear, select the desired image.
The following four source image groups are shown.
• Preset: Preset images of this app
• Settings: Images saved in a settings file that was sent via AirDrop or email.
* You can delete an image by choosing [Delete] select the image
trash can icon.
• Imported: Images saved by iTunes etc. in the “Images” folder
• Photos: Image files of the iOS “Photos” app
Use the tabs to switch groups, select the desired image, and use
[Back] to return to the screen shown at left.
21
Loading...