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