Janz tec Emweb-10wt Mounting instructions

emWEB-10WT (Hardware and Software Manual) •Introduction 1 - 1

Rev. 1.1 © Janz Tec AG

Refers to product revision

V x.x

emWEB-10WT

Web panel with browser support

(Hardware and Software Manual)

Version 1.1

PROPRIETARY NOTICE

No parts of this technical manual may be modified, copied or reproduced

in any form or by any means for commercial use without the prior written

permission of Janz Tec AG, Germany.

All instructions, information and specification contained in this manual

are for reference only and remain subject to change without

announcement.

Preliminary

1 - 2 emWEB-10WT (Hardware and Software Manual) •Introduction

Title:

emWEB-10 hardware and software manual

Created:

fhu, 26.06.2018

Last Update:

fhu, 23.07.2018

Tel.:

+49-5251-1550-0

FAX:

+49-5251-1550-190

email:

support@janztec.com

Internet:

www.janztec.com

emWEB-10WT (Hardware and Software Manual) •Introduction 1 - 3

Rev. 1.1 © Janz Tec AG

Contents

1 Introduction 7

1.1 Features...............................................................................................................................7

1.2 Functional Overview ............................................................................................................7

2 Safety Instructions 8

2.1 Installation and Maintenance...............................................................................................8

2.2 Ambient and Environmental Conditions...............................................................................8

3 Intended use 9

3.1 Disposal and Recycling........................................................................................................9

3.1.1 EU...................................................................................................................................9

3.1.2 Germany .........................................................................................................................9

4 Installation 10

4.1 Dimensions and mounting information ..............................................................................10

4.2 Technical specification.......................................................................................................12

4.2.1 DC main power supply..................................................................................................13

4.2.2 Universal serial bus - USB............................................................................................13

4.2.3 Display ..........................................................................................................................13

4.3 Micro SDcard Replacement...............................................................................................14

4.4 Battery Replacement .........................................................................................................14

5 Operating System and Drivers 15

5.1 Janz Tec AG Linux Image for emWEB-10WT ...................................................................15

5.1.1 Default configurations...................................................................................................15

5.1.2 Disk Partitioning information.........................................................................................15

5.1.3 Overlay filesystem (AUFS) ...........................................................................................15

5.2 Optional Software...............................................................................................................16

5.2.1 Google Chromium webbrowser ....................................................................................16

5.2.2 Webmin Configuration Webserver................................................................................16

6 Open Source Licensing 18

6.1 Disclaimer ..........................................................................................................................18

6.2 How to obtain the source code ..........................................................................................18

6.3 Software packages ............................................................................................................18

6.4 Verbatim License Texts .....................................................................................................19

6.4.1 BSD 2-clause "Simplified" License ...............................................................................19

6.4.2 BSD 3-clause "New" or "Revised" License...................................................................20

6.4.3 GNU General Public License v2.0................................................................................21

6.4.4 GNU Library General Public License v2.......................................................................25

6.4.5 GNU Lesser General Public License v2.1....................................................................31

6.4.6 eCos license version 2.0...............................................................................................37

6.4.7 IBM PowerPC Initialization and Boot Software.............................................................38

Technical Data 39

7 Product History 40

7.1 Manual History...................................................................................................................40

1 - 4 emWEB-10WT (Hardware and Software Manual) •Introduction

List of Figures

figure 1: emWEB-10WT measures.........................................................................................................10

figure 2: emWEB-10WT drilling template...............................................................................................11

figure 3: Block diagram for the internal logic..........................................................................................12

figure 4: Power connector.......................................................................................................................13

figure 5: Removing and replacing coin cell battery ................................................................................14

figure 6: Webmin overview.....................................................................................................................17

figure 7: webmin kiosk mode..................................................................................................................17

List of Tables

table 1: emWEB-10WT dimensions .......................................................................................................10

table 2: Power connector assignment ....................................................................................................13

table 3: Display specifications ................................................................................................................13

emWEB-10WT (Hardware and Software Manual) •Introduction 1 - 5

Rev. 1.1 © Janz Tec AG

About this Manual

This is the hardware manual for the emWEB-10WT. It gives all necessary information to users and

programmers of the emWEB-10WT. We have tried to keep it compact, so there are no special

sections for users and programmers. I.e. everything that can be said about the serial port is said in

one place (connector layout, signal levels and programming hints). Users that are not programmers

might therefore only read the first sections (Introduction and Installation) and come back to the

detailed sections when they need more information.

The manual starts with an Introduction to the emWEB-10WT. This is some prose that describes the

features and architecture of the emWEB-10WT. You should already know this if you have bought the

board! It then discusses some topics about Installation of the product.

The rest of the manual then covers technical details about the emWEB-10WT.

Conventions

If numbers are specified in this manual, they will be either decimal or hexadecimal. We use C-notation

to identify hexadecimal numbers (the 0x prefix).

If we refer to low active signal names, they will be suffixed by a “#” character.

Some parts of the text are important. These are visually marked with the following signs:

Some parts of the manual contain notices you have to observe to ensure your personal safety, or to

prevent damage to property. These are visually marked with the following alert symbols:

DANGER

Indicates that death or severe personal injury will result if proper precautions are not

taken.

WARNING

Indicates that death or severe personal injury may result if proper precautions are not

taken.

CAUTION

Indicates that minor personal injury can result if proper precautions are not taken.

NOTICE

Indicates that damage to equipment can result if proper precautions are not taken.

Indicates information that we think you should have read to save your time by avoiding

common problems. Important suggestions that should be followed will also be marked

with this sign.

1 - 6 emWEB-10WT (Hardware and Software Manual) •Introduction

Acronyms and Abbreviations

DVI

Digital Visual Interface

ESD

Electrostatic discharge

HMI

Human Machine Interface

LCD

Liquid Crystal Display

LVDS

Low Voltage Differential Signal, Video signal to the TFT display

SVGA

Super Video Graphic Array

SXGA

Super EXtended Graphics Array

TFT

Thin Film Transistor

USB

Universal Serial Bus

UXGA

Ultra EXtended Graphics Array

VGA

Video Graphic Adaptor, Video Graphic Array

XGA

EXtended Graphics Array

emWEB-10WT (Hardware and Software Manual) •Introduction 1 - 7

Rev. 1.1 © Janz Tec AG

1 Introduction

emWEB panel devices are designed to simply visualize machine data provided in web pages, either

in pages of a CODESYS web visualization or in web pages of any other web-based environment.

emWEB panel devices are based on a Freescale i.MX6 single core ARM processor. It can be supplied

with 24V power and is connected via an Ethernet interface with the machine network.

1.1 Features

•resistive touch screen (PCT optionally)

•24 V DC power supply

•Fan less cooling concept

•Protection rating of the front is IP65

•High grade aluminium front

•Customizable design of the front panel

1.2 Functional Overview

The emWEBs are normally delivered with a touch-screen. And are normally delivered with Debian

Linux.

The power must be supplied by an external power supply. This power supply must be capable to

provide enough power for the emWEB-10WT. Please refer to the technical specifications section for

more information.

2 - 8 emWEB-10WT (Hardware and Software Manual) •Safety Instructions

2 Safety Instructions

Refer to page 5 for explanation of the warning notice system.

The product described in this documentation may be operated only by personnel qualified for the

specific task in accordance with the relevant documentation for the specific task, in particular its

warning notices and safety instructions. Qualified personnel are those who, based on their training and

experience, can identify risks and avoiding potential hazards when working with these products.

2.1 Installation and Maintenance

NOTICE

The product is intended to be used in industrial environments. Typical applications are

process virtualization.

WARNING: Unauthorized Opening

Improper opening of the device may result in substantial damage to the equipment.

Remove power before you open the housing of the product. Do not connect power or

operate the product until you have closed the housing and tightened all screws.

WARNING: Electrical Shock

The IO interfaces (connectors) of the product are only suited to be connected to SELV

circuits. Use interfaces (connectors) for their intended use only.

2.2 Ambient and Environmental Conditions

WARNING

This product does NOT fulfil the requirements for a fire enclosure according to EN

60950-1 in all possible mounting positions. In these mounting positions, installation is

only permitted above concrete or other non-inflammable materials.

NOTICE: Damage

Do not operate the product beyond the specified ambient conditions. Do not cover the

vent slots of the product.

DANGER: Electrical Shock

Danger to life.

This product operates with 9..34 V DC. Do not connect this product to an improper power

supply.

DANGER: Explosive Risk

This product is NOT designed to be used in potentially explosive atmosphere.

Do not operate this product in potentially explosive atmosphere.

NOTICE: EMI

This product is a class A device. This product may cause radio interference. In this case

the user must take adequate measures.

emWEB-10WT (Hardware and Software Manual) •Intended use 3 - 9

Rev. 1.1 © Janz Tec AG

3 Intended use

The emWEB-10WT is designed for computing purposes in industrial environments

3.1 Disposal and Recycling

Janz Tec products are manufactured to satisfy environmental protection requirements where possible.

Some of the components used are capable of being recycled. Final disposal of this product after its

service life must be accomplished in accordance with applicable country-, state-, or local-laws or -

regulations.

This product contains a lithium battery. This should be removed before disposal and be

returned separately

Don’t forget to delete all sensitive data on the product before disposal. Especially delete

all person related data.

3.1.1 EU

Janz Tec electronic products are labelled with the crossed-out trash can. This means that the products

must not be disposed into the domestic garbage.

Used Janz Tec products have to be recycled properly. If in doubt, you can return them to Janz Tec at

your own expense. Refer to https://www.janztec.com/recycling or contact Janz Tec under

[email protected] for more instructions how and where to return the products.

3.1.2 Germany

All Janz Tec products are registered as B2B custom at the german EAR. Hence Janz Tec products

must not be disposed to public collection points for used electronic equipment. Refer to §14 of

General Terms & Conditions of Janz Tec AG for the details regarding the mutual obligations as to the

disposal of Janz Tec products.

The Lithium battery included in the product is registered at “GRS Batterien” and can be disposed to

public collecting points for used batteries.

As stated above, used Janz Tec products can also be returned to Janz Tec at you own expense for

free-of-charge recycling.

4 - 10 emWEB-10WT (Hardware and Software Manual) •Installation

4 Installation

When opening the shipping package of the emWEB-10WT, the contents of the package should be

checked immediately.

The emWEB-10WT is delivered in a configured state, but the configurations can be adjusted by the

user as well. To adjust the emWEB-10WTs configuration.

The package also contains a terminal plug for the power connector. The emWEB-10WT needs a

power source in between 9 to 34V DC for operation.

The installation of this equipment is allowed for qualified service personnel, only.

Auxiliary existing rules for installation of electrical equipment must be attended to.

4.1 Dimensions and mounting information

figure 1: emWEB-10WT measures

The needed cut-out measures are given in figure 2. The overall front panel dimensions are denoted

with W and H. D is the depth of the case. The front has 8 mm thickness.

288.0 mm

225.0 mm

33.0 mm

table 1: emWEB-10WT dimensions

emWEB-10WT (Hardware and Software Manual) •Installation 4 - 11

Rev. 1.1 © Janz Tec AG

figure 2: emWEB-10WT drilling template

4 - 12 emWEB-10WT (Hardware and Software Manual) •Installation

4.2 Technical specification

The emWEB-10WT has three connectors, the main power supply, an USB connector and an Ethernet

connector. Optionally a CAN connector is orderable. The figure 3 shows a block diagram of the

internal function.

figure 3: Block diagram for the internal logic

emWEB-10WT (Hardware and Software Manual) •Installation 4 - 13

Rev. 1.1 © Janz Tec AG

4.2.1 DC main power supply

The Power unit (figure 3) is energizing all internal components, the display and its backlight. Thereby

the power supply can vary in between 9 to 34 VDC. The emWEB-10WT has a power dissipation with

less than 11 W. Before connecting the DC main power supply the protective bonding conductor (PE)

must be connected

The power connector is included in delivery. The assignment of this connector is shown in figure 4 and

table 2.

Description

+ 9..34 VDC

NC, do not connect

GND

figure 4: Power connector

table 2: Power connector assignment

4.2.2 Universal serial bus - USB

To connect the touch-screen to a host computer the USB can be used, too. The connector is USB

Type B, so a standard USB Type A to Type B cable can be used to connect the touch-screen with the

host.

The length of USB cable must not exceed 5 m.

4.2.3 Display

The panel is built as a thin film transistor liquid crystal display TFT-LCD with a diagonal screen of

10,1’’ and up to 16.7M colours.

Description

Specification

Display area

216.96 x 135.60 mm

Number of dots

1280x3 (H) x 800 (V) (RGB vertical stripe)

Pixel Pitch

0.1695 (H) x 0.1695 (V)

Brightness

500 (Cd/m²) typ.

Viewing angles

-85° to 85° (H), -85° to 85° (V) typ.

Contrast

800 (typ.)

Backlight

LED

table 3: Display specifications

4 - 14 emWEB-10WT (Hardware and Software Manual) •Installation

4.3 Micro SDcard Replacement

NOTICE

Power must be turned off before removing or inserting the micro SDcard

To replace the micro SD card, remove all screws located on the rear panel. After lifting the housing,

you can access the Micro SD card slot.

4.4 Battery Replacement

CAUTION

The installed computer board is equipped with a Lithium battery.

Danger of explosion if battery is incorrectly replaced. Replace only with battery of the

same or equivalent type (3-volt lithium coin cell battery).

•Do not attempt to recharge the battery.

•Do not disassemble, crush, puncture, short external contacts, or dispose of

in fire or water.

Compatible battery type: CR2032 (3 Volt lithium coin cell battery)

The battery is used for backing up the system time when the power supply is removed.

1. Turn off the computer properly through the operating system, then turn off any external

devices.

2. Disconnect the power supply from the power inlet and disconnect any external devices.

3. Disassemble the housing by removing the located screw on the back side and lifting the

housing. Then locate the battery on the Janz Tec board.

4. Remove the battery from the holder (See figure 5)

5. Insert the new battery (See figure 5)

6. Re-assemble the housing

figure 5: Removing and replacing coin cell battery

1. Removal: Insert screwdriver at right side and bend so that the battery

pops out. Use only gentle force, otherwise the battery holder might be

damaged.

The use of a plastic tool is preferred to avoid shorting the battery

2. Insertion: Align new battery to the left side of the holder and gently

press down on the right side of the battery until the battery snaps into

the holder.

emWEB-10WT (Hardware and Software Manual) •Operating System and Drivers 5 - 15

Rev. 1.1 © Janz Tec AG

5 Operating System and Drivers

When you order the emWEB-10WT with pre-installed software (Debian 8 operating system), then our

default Janz Tec image is pre-installed on the µSD-card and the emWEB-10WT driver package is

already installed and fully configured.

5.1 Janz Tec AG Linux Image for emWEB-10WT

Our pre-installed Janz Tec AG Image contains the combination of the official Debain operating system

as well as our emWEB-10WT drivers. File /root/imageversion.txt contains the image name and version

of the installed Janz Tec image.

You can change the emWEB-10WT configuration on accessing the local hosted website at

http://127.0.0.1/

The local running web service is named “webmin” (http://www.webmin.com) and gives through a web

interface access to different configuration features on the emWEB-10WT. Please refer to chapter 5.2.2

Webmin Configuration Webserver Webmin Configuration Webserver for further configuration

information.

An additional Janz Tec image feature is a write protected root filesystem. The AUFS filesystem is

integrated to the custom kernel and enabled in the Debian 8 distribution. For further usage

instructions, please have a look at chapter 5.1.3 Overlay filesystem (AUFS).

5.1.1 Default configurations

The emWEB-10WT is delivered with an enabled ssh service. During the first start, the SSH keys will

be created. Following the log in credentials are listed, but please note, that the access for the “root”

user is denied for SSH connections.

Default log in credentials:

Username: dev

Password: dev1

Username: root

Password: root1

5.1.2 Disk Partitioning information

Depending on the installed µSD card, the drive has 3 partitions:

- /dev/mmcblk0p1: Boot Partition (not mounted)

- /dev/mmcblk0p2: Linux System Partition (write-protected)

- /dev/mmcblk0p3: Data Partition (read-write)

omounted to /data/ →use this partition for user data

5.1.3 Overlay filesystem (AUFS)

Note: The overlay filesystem is default enabled on your system. This prevents data loss on the local

system partition.

In the case of the enabled filesystem protection, all data written to the “Linux System Partition”

(/dev/mmcblk0p2) will be lost during the next restart of the system. The /data folder can be used to

save user specific data. Use the following commands to configure the behaviour of the overlay

filesystem:

5 - 16 emWEB-10WT (Hardware and Software Manual) •Operating System and Drivers

Using reboot-commit will write all changes to write-protected system partition.

commit:

dev@emWeb-aimx6: sudo reboot-commit

enable:

dev@emWeb-aimx6: sudo reboot-ro

disable:

dev@emWeb-aimx6: sudo reboot-rw

For production environment, we recommend that the write-protection of the system

partition is enabled!

NOTICE

To reduce the risk of losing information stored in files on the µSD-card, especially when

writing to the card during a power failure event, consider the use of an external UPS

(uninterruptable power supply).

5.2 Optional Software

This chapter lists and describes additional installed software in the Janz Tec AG default image for the

emWEB-10WT.

5.2.1 Google Chromium webbrowser

The used web browser is Chromium with the installed version 51.0.2704.79. Additional packages for

the Chromium browser are:

- chromium-codecs-ffmpeg

- chromium-codecs-ffmpeg-extra

- Janz Tec Chrome Extension (for automatically redirect the NewTabPage to the webmin

configuration page.

5.2.2 Webmin Configuration Webserver

Webmin version 1.820 is preinstalled. “Webmin is a web-based interface for system administration for

Unix. Using any modern web browser, you can setup user accounts, Apache, DNS, file sharing and

much more.”For more information have a look at http://www.webmin.com/

Following features are supported on the emWEB-10WT:

- Show recent system information

- Change of the passwords

- Kiosk mode configuration

- Linux Firewall rules

- Network configuration

- System time

- Touchscreen calibration

emWEB-10WT (Hardware and Software Manual) •Operating System and Drivers 5 - 17

figure 6: Webmin overview

On the first boot the system has to be configured for the kiosk mode. This includes to define a default

homepage which should be loaded after starting the operating system.

For configuring the kiosk mode, open the “Kiosk Configuration” page on the webmin service. Have a

look to Fehler! Verweisquelle konnte nicht gefunden werden.. After setting up the homepage, note

that the changes has to be committed to the filesystem. Choose the “reboot-commit now” button to

apply the configuration.

figure 7: webmin kiosk mode

Once the kiosk mode is enabled and a default page is shown at the start up, there are following ways

to (re-)configure the emWEB-10WT.

1. GUI based modification

Apply a keyboard to the emWEB-10WT and press “Ctrl” + “Shift” + “T”. This opens

a new browser tab and show the navigation bar. Open “http://127.0.0.1/”

2. Command line based modification

Apply a keyboard to the emWEB-10WT and press “Ctrl” + “Alt” + “F1” (Alternatively

open a SSH shell).

After pressing, a shell will appear and gives access with the specified credentials. For

modifying the homepage, edit the file “/etc/kiosk.conf”

6 - 18 emWEB-10WT (Hardware and Software Manual) •Open Source Licensing

6 Open Source Licensing

This product uses a number of open source software packages which are listed below. The open

source software is provided free of charge. You are entitled to use the open source software in

accordance with the respective license conditions as provided in the following chapters.

6.1 Disclaimer

The open source software is distributed WITHOUT ANY WARRANTY; without even the implied

warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. The respective

licenses may contain more details

6.2 How to obtain the source code

The software included in this product contains copyrighted software that is licensed under the GPL

and other open source licenses. Copies of those licenses are found below. You may obtain the

complete Corresponding Source code from us:

Open Source Compliance Division

Janz Tec AG

Im Doerener Feld 8

D-33100 Paderborn

Email: opensource@janztec.com

This offer is valid to anyone in receipt of this information.

6.3 Software packages

The software contained in this product makes use of the following open source software packages.

Package

License

u-boot

BSD-2-Clause

BSD-3-Clause

eCos-2.0

GPL-2.0

IBM-pibs

LGPL-2.0

LGPL-2.1

The u-boot software is stored in the SPI flash of the emWEB-10WTand is required to boot software

that is stored on the CFast, SD card or the internal eMMC.

As the u-boot can be replaced by the skilled end user, we have no control of which version of u-boot is

installed on which device. You can check the u-boot version by checking the u-boot start up

messages. Please indicate this version when you request the source code.

This license Agreement does NOT cover any software that is installed on the CFast, SD card or the

internal eMMC.

emWEB-10WT (Hardware and Software Manual) •Open Source Licensing 6 - 19

6.4 Verbatim License Texts

All license texts can be found electronically on http://spdx.org/licenses.

6.4.1 BSD 2-clause "Simplified" License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the

following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following

disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the

following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED

AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

6 - 20 emWEB-10WT (Hardware and Software Manual) •Open Source Licensing

6.4.2 BSD 3-clause "New" or "Revised" License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the

following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following

disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the

following disclaimer in the documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote

products derived from this software without specific prior written permission.