Topcon OPUS A6G2 User manual

OPUS Projektor Manual

2
OPUS Projektor Manual
Table of Contents
1. Welcome 6
2. Quick Start Tutorial 10
2.1 Creating a Project ........................................................................................................ 11
2.2 Designing Page Content .............................................................................................. 13
2.3 Simulate the Project ................................................................................................... 28
3. User Interface 31
3.1 Convert Project ............................................................................................................ 40
3.2 Copy and Paste ............................................................................................................ 42
3.3 Drag and Drop ............................................................................................................. 43
3.4 Image Library ............................................................................................................... 46
3.5 Image Pool ................................................................................................................... 54
3.6 Import Variables .......................................................................................................... 59
3.7 Launcher ....................................................................................................................... 61
3.8 Licensing ....................................................................................................................... 63
3.9 Options ......................................................................................................................... 65
3.10 Page Editor ................................................................................................................... 73
3.11 Project Properties ....................................................................................................... 76
Image Handling ..................................................................................................... 923.11.1 Languages ............................................................................................................. 983.11.2 Units ...................................................................................................................... 983.11.3 Variable logging .................................................................................................. 1003.11.4
3.12 Project Search ............................................................................................................ 108
3.13 Project Versioning ..................................................................................................... 123
3.14 Sample Projects ......................................................................................................... 130
3.15 Start Page ................................................................................................................... 134
3.16 Symbol Library ........................................................................................................... 135
3.17 Undo/Redo ................................................................................................................. 142
3.18 Variable View ............................................................................................................. 146
Find Variable Usages ........................................................................................... 1483.18.1
3.19 Z-Order ....................................................................................................................... 151
4. Variables 153
4.1 Variable Owner Menus ............................................................................................. 160
4.2 Variable Menus .......................................................................................................... 165
4.3 Pre-Defined Variables ................................................................................................ 174
5. CAN 306

3
OPUS Projektor Manual
Table of Contents
5.1 CANFreestyle .............................................................................................................. 308
5.2 CANopen .................................................................................................................... 328
5.3 J1939 ........................................................................................................................... 342
J1939 Basic Settings ............................................................................................ 3455.3.1 J1939 ECUs and Variables ................................................................................... 3495.3.2 J1939 PGN Mappings ........................................................................................... 3605.3.3 J1939 DM1 and DM2 ........................................................................................... 3705.3.4
5.4 Import DBC File .......................................................................................................... 381
5.5 Export DBC File ........................................................................................................... 391
5.6 Visual CAN Mapping .................................................................................................. 397
6. Object Reference 411
6.1 Common Object Properties ...................................................................................... 415
6.2 Events and Actions .................................................................................................... 430
6.3 General Objects ......................................................................................................... 443
Page Object ......................................................................................................... 4436.3.1 Alarms .................................................................................................................. 4436.3.2 Virtual Keyboards ................................................................................................ 4466.3.3 Softkey Frame ...................................................................................................... 4486.3.4 Softkey ................................................................................................................. 4496.3.5
6.4 Palette Objects .......................................................................................................... 451
2D Graph .............................................................................................................. 4516.4.1 Graph History Tool .............................................................................................................................. 4596.4.1.1
Arched Bargraph .................................................................................................. 4616.4.2 Button .................................................................................................................. 4636.4.3 Container ............................................................................................................. 4666.4.4 Frame ................................................................................................................... 4676.4.5 Gauges ................................................................................................................. 4676.4.6 Lamp .................................................................................................................... 4736.4.7 Linear Bargraph ................................................................................................... 4756.4.8 List ....................................................................................................................... 4776.4.9 Meter ................................................................................................................... 4816.4.10 Multimedia Player ............................................................................................... 4846.4.11 Numeric Field ....................................................................................................... 4956.4.12 Picture Graphic .................................................................................................... 4966.4.13 Power Switch ....................................................................................................... 4996.4.14 Push Switch .......................................................................................................... 5016.4.15 Rocker Switch ...................................................................................................... 5036.4.16 String Field ........................................................................................................... 5046.4.17 Table .................................................................................................................... 5056.4.18
6.5 Video Properties ........................................................................................................ 508
7. JavaScript 513

4
OPUS Projektor Manual
Table of Contents
7.1 The JavaScript Editor ................................................................................................ 515
7.2 Assign a JavaScript file to an Event ......................................................................... 523
7.3 JavaScript Basics ........................................................................................................ 524
7.4 Custom JavaScript functions for device specific functionality .............................. 529
RS232 JavaScript Functions ................................................................................. 5607.4.1
7.5 Programming Guidelines .......................................................................................... 565
8. Functionalities 567
8.1 Alarms ......................................................................................................................... 568
8.2 Day/Night Mode ........................................................................................................ 571
8.3 ISOBUS Application ................................................................................................... 576
8.4 Object Themes ........................................................................................................... 580
8.5 Visibility ...................................................................................................................... 588
9. Simulations 595
9.1 Simulation Settings ................................................................................................... 596
9.2 PClient Simulation ..................................................................................................... 598
9.3 Variable Simulation Overview .................................................................................. 601
Variable Simulation Toolbar ................................................................................ 6069.3.1 Variable Simulation Variable View ...................................................................... 6079.3.2 Variable Simulation - Value Operations .............................................................. 6099.3.3 Variable Simulation - Variable Properties ........................................................... 6149.3.4 Variable Simulation - Initialization Lists .............................................................. 6149.3.5 Variable Simulation FAQ ...................................................................................... 6169.3.6
10. Device Software Update 617
10.1 Project Update ........................................................................................................... 618
10.2 OS / PClient Update .................................................................................................. 653
Software Versions Overview ............................................................................... 65710.2.1
11. Miscellaneous 659
11.1 Online Update ............................................................................................................ 660
11.2 Welcome Projects ...................................................................................................... 669
11.3 Tutorial Videos ........................................................................................................... 730
11.4 Crash, Issue, Feedback reports ................................................................................. 730
12. How To 743
12.1 How to create switch buttons with changing colors ............................................. 744
12.2 How to use one script for several buttons .............................................................. 744
12.3 How to create a drop down menu .......................................................................... 744
12.4 How to use the automatic backlight dimming ....................................................... 745

5
OPUS Projektor Manual
Table of Contents
12.5 How to set up SDO communication ........................................................................ 745
12.6 How to remember variable values when the device is powered off .................... 746
12.7 How to use the power management ....................................................................... 746
12.8 How to use the digital outputs ................................................................................ 749
12.9 How to process CAN messages with a multiplexer bit ........................................... 750
12.10 How to create dynamic icons ................................................................................... 751
13. FAQ 753
14. OPUS devices update manual 763
14.1 Overview .................................................................................................................... 764
14.2 Contents of the software update ............................................................................. 765
OS 1.x ................................................................................................................... 76514.2.1 OS 2.x ................................................................................................................... 76514.2.2 OS EGSPRO .......................................................................................................... 76514.2.3 OS EGSCORE ........................................................................................................ 76614.2.4 OPUS Toolchain – PClient .................................................................................... 76614.2.5 Codesys ............................................................................................................... 76614.2.6 ISO-VT .................................................................................................................. 76714.2.7 ISO-V2 .................................................................................................................. 76714.2.8
14.3 Updating the device .................................................................................................. 768
OPUS A3 / A6 G1 ................................................................................................. 76814.3.1 Updating from OS 0.x / 1.x to 2.x ...................................................................................................... 77014.3.1.1
Downgrading from OS 2.x to 1.x ....................................................................................................... 77014.3.1.2
OPUS A6 G2 / OPUS A8 ....................................................................................... 77014.3.2 OPUS B3 ............................................................................................................... 77214.3.3 ISO-V2 .................................................................................................................. 77314.3.4 Update via partition ............................................................................................. 77514.3.5
14.4 Additional information ............................................................................................. 775
Connecting to the serial console ......................................................................... 77514.4.1 Using a different boot logo image ...................................................................... 77714.4.2 Manual update of the boot loader and service ramdisk (OS 1.x) ....................... 78114.4.3 Manual update of the boot loader ................................................................................................... 78114.4.3.1
Manual update of the service ramdisk ........................................................................................... 78514.4.3.2
Touch Screen Calibration ..................................................................................... 78614.4.4
15. Tools 789
15.1 ISO 17215 Camera Configuration ............................................................................. 790

Welcome

7
OPUS Projektor Manual
Welcome
1Welcome
If you are new to this program, the best starting point is the Quick Start Tutorial .
New content for this version
Heavily enhanced reporting functionality with issue view
Image Pool project tree node
A new event OnProjektInitFinished
Many useful changes like:
setVariableValid JavaScript function
String Fields now can have up to 65535 characters
Containers can be pasted into containers (don't do it, though)
Create JavaScript array from objects
new event OnCancel
possibility to deactivate multi touch with @MultiTouchEnabled
and much more...
Version check!
Starting with version 2020.4, a version check is implemented in the PClient. Only if
the major and minor version of the used development version and PClient version
are the same, the project will be loaded. Otherwise a red warning screen will be
shown that informs of the version discrepancy.
Important disclaimer!
Please note that for i.MX6 devices, installing the OS 2.x will prohibit a downgrade
back to OS 1.x!
Once an OS 2.x is installed, there is currently no way to downgrade back to OS 1.x!
Limitations in the demo version
The demo version is limited to the creation of up to 2 pages and up to 5 user-defined
variables.
Additional pages or variables cannot be created.
If a project is opened that exceeds one of these limitations, the project can not be
downloaded to the device.
Read here how to get a license!
Known issues
- GIF files can only be used as Image to Display for Picture Graphic objects, but not
as background, needle, border etc. images
11
730
54
430
559
504
466
43
435
174
63

8
OPUS Projektor Manual
Welcome
- For devices with multi touch, buttons should not be put too close together,
especially for contrary functionalities (up/down or plus/minus). With distances < 1.5
cm a second press can sometimes not be recognized as such but will instead be
registered as a false coordinate for the first finger, resulting in an unwanted release
for the first button.
- Properties of objects should not excessively be changed before the modifications
were actually seen on the screen. This is especially relevant with i.MX 35 devices
and string properties like Image to Display.
All rights reserved, including translation.
No part of this operating manual may be reproduced, in any form, (print, photocopy, microfilm,
or a different process), nor may it be processed, duplicated, or distributed using electronic
systems, without written permission of the creator and distributor of the manual.
All previous versions are rendered obsolete with publication of this manual.
All information contained herein is subject to correction, manufacturer is not liable for any
errors in this material.
This manual has 141 chapters with ~162.000 words and 732 images.
Last change: 2022/10/07, revision 1268.
- new event OnCancel added
- Search Tips & Tricks added
- new and changed welcome project screens added
- possibility to bulk-delete CAN mappings added in user interface
- validation information for J1939 DM1/2 translation files added
- language project properties updated with new functionality
- adjusted max. object width / height to 2 * max. device resolution
- new chapter Image Pool in User Interface
- new event OnValidStateChange
- video mirror information corrected and example images added
- Several small improvements
- Rounding up of power management timeout variables added to documentation
- New events OnProjektInitFinished and OnPageInitFinished
- New reporting features added
- JS function setVariableValid added
- Heartbeat page added to Welcome Project (2.3.9) documentation
- FAQ about PDF reader added
- known problem added
- remark about camera frame size and position added
- new screenshots for Welcome Project 2.3.1
- audio options in events and actions corrected
- copy buttons added in key/ encoder color page in Welcome Project
- New pages low power times and alarm logging in Welcome Project
- Error -93 in Updater FAQ for Ethernet transfer
- variable list updated
- multi touch added to known issues
- FAQ about screenshots added
- constraints of using GIF files added, incl. FAQ and known issues
- Updater CLIdocumentation added
- tradeshow dashboard added
- New screenshot for new themes

9
OPUS Projektor Manual
Welcome
- Introduced text variables for pre-defined variables chapter device descriptions
- Update of Ethernet FAQ
- Updated some screenshots for updater settings in welcome project
- New screenshot for DayNight
- OS/PClient update with partition in update manual
- New splash for pdf manual
- Icon reference in welcome project added
- New chapter for project search
- New chapter for versioning system
- New chapter for undo-redo
- New page multi language in Welcome Project
- Added font FAQ
- Added documentation for rsc JS command
- Corrections in variable logging chapter
- Touch Input property for list objects documentation added
- list object documentation improved
- runSystemCommand function added
- documentation for openPDFReader JS function added
- EEPROM page added to welcome project documentation
- CANopen PDO page added to welcome project documentation
- info about rtsp availability
- updated tour link
- known issues added on welcome page
Imprint
Privacy policy
108
123
142

Quick Start Tutorial

11
OPUS Projektor Manual
Quick Start Tutorial
2Quick Start Tutorial
Tour of the program
https://www.youtube.com/playlist?list=PLhLYlu1YL064ENX6BsFDBaUDtaBr6TD4L
This quick start tutorial demonstrates the basic steps to create a display project. Start with
creating a project , then continue with designing the page content , then simulate the
project ..
2.1 Creating a Project
To create a new project, click on the New Project button in the toolbar (1) or use the menu
File -> New Project...
The New Project window opens. Stay on the General category and click the Next button (2)
After you finished the tutorial, you are invited to check out some of the sample projects that
you can access in this dialog.
11 13
28

12
OPUS Projektor Manual
Quick Start Tutorial
In the next step you have to provide the following information:
· The project name
· The directory where the project will be stored
· The display device and orientation the project shall run on (for the tutorial, leave the
display that is selected by default)
· Click Finish button to complete the project creation.

13
OPUS Projektor Manual
Quick Start Tutorial
Continue with designing page content .
For certain device types the option Use ISOBUS Application can be activated. Read the
chapter ISOBUS Application for more information.
2.2 Designing Page Content
A new project always comes with a page having a default page name. By following the next
steps the page name can be changed.
· Double click on project name (7)
· Double click on "Pages" (7)
· Double click the Home Page in the project tree. (8)
· The Home Page Editor opens. (9)
· In the Properties window change the page name into Gauges Page. (10)
13
576

14
OPUS Projektor Manual
Quick Start Tutorial
In this tutorial, the basic page layout is given by a background image. To add a background
image, open the Image Library tab (11), and use the Browse button (12) to add the folder
where the tutorial images were saved. Then select the image Training Background1.png (13)
and drag & drop it onto the gray frame in the virtual device (14). Select the Frame 1 and then
Background Image.
Note that the image now has a suffix _480_272 in the file name . A new instance of the image
in this resolution is automatically created.
Visualization of Received Values

15
OPUS Projektor Manual
Quick Start Tutorial
Adding a Gauges Needle
Now you're ready to add the Meter object.
· Drag the Meter object from the Palette (15) and drop it in the editor (16).
Now change the following properties of the Meter in the Properties window (for the
min/max values use the exact order as listed here):
Make sure that the Meter object is selected in the scene!
· Select the Theme Template "modern_bright"
· X Location: 181
· Y Location: 51
· Width: 118
· Height: 118 (will be set automatically when you set the width)
· Check Transparent
· Max Value: 100
· Absolute Max Value: 100
· Min Value: 0
· Absolute Min Value: 0
· Start Angle: 325
· End Angle: 215
· Uncheck Draw Ticks
Here is what the result looks like:

16
OPUS Projektor Manual
Quick Start Tutorial
Attaching a Variable to the Meter
To be able to change the value shown by the meter, you need to create a variable and
attach it to the meter:
· Click the Add New Variable button (17) of the Variable View.
· A new variable with name New Variable_1 is created.
· Change the Variable Name of New Variable_1 into kmh (18).
To make it easier to work with variables you have created, there are two possibilities to
reduce the amount of variables shown in the Variable View:
· One option is to check the Hide pre-defined variables check box (19).
· A second option is to enter a search sting (e.g. the variable name kmh)in the
search area (20).
· In both cases, the amount of visible variables is reduced.

17
OPUS Projektor Manual
Quick Start Tutorial
Now you need to attach the variable kmh to the meter:
· Click the kmh variable row to select it and drag & drop the variable over the meter.
You can also drop the variable on the Meter 1 in the project tree (22).
· A context menu appears. In the first level, select the Meter 1 object. In the second
level, select the the Variable Reference option (21).
· You can now check in the Properties window, that the variable kmh is referenced
by the meter object (23).
Later we will simulate the project. To be able to easily simulate the correct variable
values, we have to set the minimum and maximum values of the kmh variable:
· Select the kmh variable in the Variable View (24).
· Open the right click context menu of the kmh variable and choose Edit in
Variable Manager (25).

18
OPUS Projektor Manual
Quick Start Tutorial
The Variable Manager window opens: Set the following properties:
· Minimum Value: 10
· Maximum Value: 170
· Default Value: 10
Then close the window by clicking the OK button (22).

19
OPUS Projektor Manual
Quick Start Tutorial
Configure How Variable KMH is Received via CAN
Setting up CAN communication start with the port configuration:
· Choose Port Configuration... from the menu Communication (29).
In the Port Configuration window:
· Select CAN:1 (30).
· Set the Bus Speed to 250 kbps (31).
· Close the window by clicking OK button (32).

20
OPUS Projektor Manual
Quick Start Tutorial
After configuring the CAN port, the CAN protocol and a communication partner, e.g. an
ECU, must be defined:
· Click the Terminal and Owner ECU(s) Configuration... entry in the
Communication menu (33).
The Terminal and Owner ECU(s) Configuration... dialog appears.
· Choose protocol CANFreestyle running on CAN1 (34) and click the Add button
(35).
· Choose CANFreestyle running on CAN1 (36).
· Enter ECU Name MyECU (37) and click the Add button (38).
· Now the ECU is listed in the Select ECU dropdown menu (39).
· Close the window by clicking OK button (40).