Janz Tec emVIEW-7/RPI3 Hardware Manual

PROPRIETARY NOTICE

All rights reserved by Janz Tec AG. 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.

emVIEW-7/RPI3

embedded HMI System

(Hardware and Software Manual)

Version 1.0

refers to product revision no.

1.0

Title:

emVIEW-7/RPI3 embedded PC

File:

j:\as\entwicklung\projekte\hw\empc\empc-arpi\doc\manual\emview7rpi3_manual.doc

Pattern:

\\ntserv5\janzgrp\as\entwicklung\formulare\entwicklung (ew)\ew_manual.dot

Created:

Stefan Althöfer, 06.03.2015

Last Update:

Stefan Althöfer, 18.05.2017

D-33100 Paderborn, Germany

Tel.:

+49-5251-1550-0

FAX:

+49-5251-1550-190

email:

support@janztec.com

Internet:

www.janztec.com

emVIEW-7/RPI3 (Hardware and Software Manual) • Contents i

Rev. 1.0 © Janz Tec AG

Contents

1 Introduction 5

1.1 Features ............................................................................................................................... 5

1.2 Functional Overview ............................................................................................................ 6

2 Safety Instructions 7

2.1 Installation and Maintenance ............................................................................................... 7

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

3 Installation 9

3.1 Mounting .............................................................................................................................. 9

3.2 Connectors and Operators .................................................................................................11

3.2.1 POWER IN ....................................................................................................................11

3.2.2 Ethernet Interface .........................................................................................................12

3.2.3 USB host interfaces (USB1-USB4) ...............................................................................12

3.2.4 Console (RS232) ..........................................................................................................13

3.2.5 Serial Port (RS232/RS485) ...........................................................................................13

3.2.6 CAN ..............................................................................................................................13

3.2.7 Digital IO .......................................................................................................................14

3.2.8 Audio Video ...................................................................................................................15

4 Maintenance 16

4.1 Micro SDcard Replacement ...............................................................................................17

4.2 Battery Replacement .........................................................................................................17

5 Operating System and Drivers 19

5.1 Standard Raspbian Operating System ..............................................................................19

5.1.1 Installation .....................................................................................................................19

5.2 emVIEW-7/RPI3 Driver Installation Script .........................................................................19

5.2.1 Installation Instructions .................................................................................................20

5.2.2 CPU Frequency ............................................................................................................20

5.2.3 Bluetooth .......................................................................................................................20

5.2.4 Driver Details ................................................................................................................20

5.2.4.1 spi-bcm2835 : SPI driver (optimized for emVIEW-7/RPI3) ......................................20

5.2.4.2 mcp2515 : CAN driver (optimized for emVIEW-7/RPI3) ..........................................20

5.2.4.3 sc16is7xx : RS232/RS485 driver (optimized for emVIEW-7/RPI3) .........................21

5.2.4.4 rtc-ds1307 : RTC .....................................................................................................21

5.3 Janz Tec AG Linux Image for emVIEW-7/RPI3 .................................................................23

5.4 General Information ...........................................................................................................23

5.5 Optional Software...............................................................................................................23

5.5.1 CODESYS Control for Raspberry Pi SL Information ....................................................23

5.5.1.1 Information ...............................................................................................................24

5.5.1.2 License Information .................................................................................................24

6 Programming Information 25

6.1 User LEDs ..........................................................................................................................25

6.2 I²C Bus ...............................................................................................................................25

6.3 SPI Bus ..............................................................................................................................25

6.4 CAN ....................................................................................................................................26

6.5 Serial Port (RS232/RS485) ................................................................................................26

6.6 Digital IO ............................................................................................................................26

6.7 Console RS232 ..................................................................................................................26

6.8 Overclocking ......................................................................................................................26

ii emVIEW-7/RPI3 (Hardware and Software Manual) • Contents

7 Appendices 27

7.1 Technical Data ...................................................................................................................27

7.2 References .........................................................................................................................29

7.3 Dimensions ........................................................................................................................30

7.4 Raspberry GPIO Header ....................................................................................................31

7.5 EMC Cable Installation ................................................ Fehler! Textmarke nicht definiert.

7.6 Product History...................................................................................................................32

7.7 Manual History ...................................................................................................................32

emVIEW-7/RPI3 (Hardware and Software Manual) • Contents iii

Rev. 1.0 © Janz Tec AG

List of Figures

figure 1: emVIEW-7/RPI3 block diagram .................................................................................................. 6

figure 2: emVIEW-7/RPI3 mounting options: Desk-top, Wall and DIN Rail ...........................................10

figure 3: Multi connector for IO (Power Supply Pins highlighted) ...........................................................11

figure 4: digital IO detailed schematic ....................................................................................................14

figure 5: emVIEW-7/RPI3 case bottom part removal ...................... Fehler! Textmarke nicht definiert.

figure 6: emVIEW-7/RPI3 micro SDcard location ..................................................................................16

figure 7: Removing and replacing coin cell battery ................................................................................18

figure 8: housing dimensions ..................................................................................................................30

figure 9: EMC Shielding .................................................................... Fehler! Textmarke nicht definiert.

List of Tables

table 1: Power Supply connector pins ....................................................................................................11

table 2: Ethernet connector ....................................................................................................................12

table 3: USB host connector ...................................................................................................................12

table 4: Console (RS232) connector ......................................................................................................13

table 5: Serial Port connector pins .........................................................................................................13

table 6: CAN connector pins ...................................................................................................................13

table 7: Digital IO connector pins ...........................................................................................................14

Table 8: Internal I²C devices ..................................................................................................................25

iv emVIEW-7/RPI3 (Hardware and Software Manual) • Contents

About this Manual

This is the hardware manual for the emVIEW-7/RPI3 embedded HMI System.

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 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.

Acronyms and Abbreviations

EMC Electromagnetic capability. ESD Electrostatic discharge. GND System ground potential. Inside the product this is connected to the metal housing,

which might be connected to protective earth by the installation. There exist some isolated reference grounds for communication interfaces or IO. These reference signals are referred to as GND-x, where x indicates function.

SELV Safety extra low voltage.

emVIEW-7/RPI3 (Hardware and Software Manual) • Introduction 1 - 5

Rev. 1.0 © Janz Tec AG

1 Introduction

1.1 Features

• Raspberry PI 3 Model B powered

o BCM2837 processor, up to 1200MHz quad-core ARM 64bit ARMv8 CPU o 1GB LPDDR2 SDRAM o 10/100 Mbit/s Ethernet o 4 x USB 2.0 o microSD card socket o WiFi 802.11b, g, n o Bluetooth 4.1 LE

• 7” TFT display, 800 x 480 Pixel

• Capacitive touch screen

• CAN, ISO/DIN 11898-2 (isolated from logic), jumper switchable 120 Ohm termination resistor

• Console, 9 pin D-Sub

• Serial port, RS232 (4 wire) or RS485 (jumper selectable), jumper switchable 120 Ohm

termination resistor for RS485

• RTC with battery backup

• 4 x digital OUT (0.5 A max.), 10..32V externally powered (isolated from logic)

• 4 x digital IN (isolated from logic)

1 - 6 emVIEW-7/RPI3 (Hardware and Software Manual) • Introduction

1.2 Functional Overview

The processing core of the emVIEW-7/RPI3 is an unmodified Raspberry PI 3 B board. A Janz Tec specific add-on board implements the specific features. Refer to figure 1 for the block diagram. The display is the unmodified Raspberry 7” display with integrated touch screen.

10/100 BaseT

USB 2.0

User LEDs

USB 2.0

IIC

EE-

PROM

Temp.Sensor

Battery Power (RTC Only)

USB 2.0

Raspberry PI

RTC

RS232

Converter

main

DC/DC

5V, 2A

2.5A

VIN:

9..32

VDC

Isolator

Trans-

ceiver

RS485/

RS232

Transceiver

Isolator

UART CAN

Isolator

SPI

Console

GPIO

24pin IO header

VIO: 10..32VDC

High side

switches

4 x 0.5A

Isolation barrier

GND-IO

4 4

micro SD

eFuse

TPS2592AA

UVL:

9.1V ... 10.2 V rising

7.1 V . .. 7.9 V ... 8.8 V fallin g (12% tolerance)

DC/DC

3.3V

GND

120 Ohm 120 Ohm

Mode

J400J300

J301

Wire

7” Display

800x480

figure 1: emVIEW-7/RPI3 block diagram

emVIEW-7/RPI3 (Hardware and Software Manual) • Safety Instructions 2 - 7

Rev. 1.0 © Janz Tec AG

2 Safety Instructions

Refer to page iv 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, are capable of identifying risks and avoiding potential hazards when working with these products.

2.1 Installation and Maintenance

DANGER: Electrical Shock

Danger to life. This product operates with 10 .. 32 V DC SELV power supply. Do not connect this product to an improper power supply (No AC power, no more than 32 V DC/DC or no non-SELV circuit)!

DANGER: Electrical Shock

Danger to life. The IO interfaces (connectors) of the product are only suited to be connected to SELV circuits. Use interfaces (connectors) for their intended use only.

CAUTION: Explosive Risk

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.

CAUTION: Fire Risk

The digital IO must be powered by a SELV power supply, that complies with the requirements of a limited energy source (LPS) (By using an appropriate supply or an external fuse).

WARNING: Burns Hazard

The product generates considerable amount of heat. The housing transports this heat to the environment and therefore gets hot. Caution when touching the housing, burns hazard!

2 - 8 emVIEW-7/RPI3 (Hardware and Software Manual) • Safety Instructions

2.2 Ambient and Environmental Conditions

CAUTION: Damage

Do not operate the product beyond the specified ambient conditions

DANGER: Explosive Risk

Do not operate the 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.

NOTICE: System overheating

The cooling concept of the emVIEW-7/RPI3 is not sufficient to allow full loading of the Raspberry PI 3 Module processor without system overheating which leads to clock reduction. Refer to the technical data for details.

emVIEW-7/RPI3 (Hardware and Software Manual) • Installation 3 - 9

Rev. 1.0 © Janz Tec AG

3 Installation

WARNING: Burns Hazard

The product generates considerable amount of heat. The housing transports this heat to the environment and therefore gets hot. Caution when touching the housing, burns hazard!

The product can be operated with DC power supply from 10 to 32 V.

3.1 Mounting

The emVIEW-7/RPI3 is intended for installation into a panel, but can as well be mounted on a 35mm DIN-rail.

Top

Do not block heat

transfer below and

above the housing

Top

Do not block heat

transfer below and above the housing

Fix with

M3 washer

and nut

figure 2: emVIEW-7/RPI3 mounting options: DIN Rail or panel mount

3 - 10 emVIEW-7/RPI3 (Hardware and Software Manual) • Installation

In figure 3 you find the required cutout for panel mounting.

figure 3: emVIEW-7/RPI3 Panel cutout

emVIEW-7/RPI3 (Hardware and Software Manual) • Installation 3 - 11

Rev. 1.0 © Janz Tec AG

3.2 Connectors and Operators

The 24 pin multi connector provides interface to many of the emVIEW-7/RPI3 interfaces that are described later.

A suitable mating connector with lock-and-release levers is Phoenix Contact order number 1790580. A Model witch screw locking is available with order number 1790399.

The plug uses spring-cage connection and accepts solid or flexible wires from 0.2 mm² to 1.5 mm². Push in connection is possible, in case of flexible wires you must use ferrules for this. If you use ferrules with plastic sleeve, the maximum wire size reduces to 0.75 mm².

Stripping length for the wires is 10 mm. If you use ferrules, obey that standard ferrules for 0.75 mm² have only 7 mm length.

3.2.1 POWER IN

The system power supply is located on the multi connector.

1 23

2 24

GND

VIN (10..32 VDC)

table 1: Power Supply connector pins

DANGER

The product may only be operated with power supplies which can be considered SELV circuits.

Pins 21 and 22 should be connected to EMI protective earth (PE). These contacts are internally connected to the DC power supply EMI filter and to the D-SUB shell of the console (RS-232). The signal is doubled to prevent false connection, it only requires one connection. In locations where no EMI noise is present, the PE connection is not required. The PE has no safety function.

1 23

2screw

locking

lock-and-

release locking

figure 4: Multi connector for IO (Power Supply Pins highlighted)

3 - 12 emVIEW-7/RPI3 (Hardware and Software Manual) • Installation

3.2.2 Ethernet Interface

Ethernet interfaces of the Raspberry PI. The Ethernet physics is 10/100BaseT, available through the shielded modular jack. Twisted pair cable can be used to connect to this port.

The two LEDs indicate Ethernet status as follows:

LED1

LED2

No activity

No Link

Activity

10/100 MBit Link

NOTICE

If your Ethernet cable is long (normative limit = 30 m) or leaves a building, then an additional protection against surges is required. Add an external surge protector is such cases. E.g. ground the Ethernet cable shield where it enters the building or your cabinet.

If you just connect to a nearby switch, such countermeasures are not required.

3.2.3 USB host interfaces (USB1-USB4)

Two USB interfaces are available at the connector panel.

+5V, I

MAX

= 500 mA, 1000 mA for all ports

USB-

USB+

GND

table 3: USB host connector

NOTICE

Although each port can deliver supply current of 500 mA, the overall load on USB1 to USB4 interfaces must be limited to 1000 mA to prevent power supply from overheating.

If you draw excessive power from USB ports or short circuit USB power supply outputs, then the Raspberry PI board will temporarily shut off the USB power supply and retry every 2 seconds.

RD+

n.c. 2 RD- 6 TD- 3 TD+

n.c. 4 n.c. 8 n.c. 1

table 2: Ethernet connector

emVIEW-7/RPI3 (Hardware and Software Manual) • Installation 3 - 13

Rev. 1.0 © Janz Tec AG

3.2.4 Console (RS232)

The RS232 (Console) serial interface is provided by Raspberry PI board. The connector is a standard 9 pin D-SUB plug, but the interface is connected with two wires only, table 4 shows the pin out.

9pin male D-Sub

n.c. 6 n.c. 2 RxD

n.c. 3 TxD 8 n.c. 4 n.c. 9 n.c. 5 GND

table 4: Console (RS232) connector

3.2.5 Serial Port (RS232/RS485)

The Serial Port is implemented by SC16IS740 UART. A multiprotocol transceiver is utilized to support both RS232 and RS485. The interface signals are located on the multi connector, refer to table 5.

TxD , B / D+

RTS , A / D-

RxD

CTS

GND

table 5: Serial Port connector pins

RS232 mode is selected by shorting jumper J301, else RS485 mode is selected. The case has to be opened to access this jumper.

In RS232 mode, the signals TxD (out), RxD (in), RTS (out) and CTS (in) are provided. In the RS485 mode the bidirectional differential signals D+ and D- are provided. When the transmitter

is enabled and no data is send (MARK=1), then D+ > D-. Refer to section 6 (Programming Information) for more information about RS485 control.

An internal 120 Ohm termination resistor can be enabled between D+ and D- by shorting jumper J300. The case has to be opened to access this jumper.

3.2.6 CAN

The CAN interface is implemented with a MCP2515 controller chip. The interface is located on the multi connector, refer to table 6. The CAN interface signals support ISO 11898-2 (high speed) and are isolated from system logic.

CAN-H

CAN-L

GND-CAN

n.c.

table 6: CAN connector pins

An internal 120 Ohm CAN termination resistor is enabled by shorted jumper J400. To disable the termination, the case has to be opened to remove this jumper.

CAUTION

Factory setting: Jumper J400 is not set by default, and therefore the 120 Ohm termination resistor is disabled!

3 - 14 emVIEW-7/RPI3 (Hardware and Software Manual) • Installation

3.2.7 Digital IO

Digital input (DI1-DI4) and output (DO1-DO4) ports are provided on the multi IO connector (refer to table 7).

DO4

DO3

DO2

DO1

GND-IO

VIO (10..32 VDC)

DI4 8 DI3 9 DI2

DI1

table 7: Digital IO connector pins

CAUTION

The digital IO must be powered by a SELV power supply, that complies with the requirements of a limited energy source (LPS) (By using an appropriate supply or an external fuse).

The digital inputs and outputs are isolated from system power supply. Refer to figure 5 for detailed schematic.

The digital input signals (DI1-DI4) refer to GND-IO and have an input impedance of about 5 kΩ. Switching level for low is ≤4V and high ≥9V. The digital inputs do not require VIO to be present.

The digital outputs drive VIO power to the output pins (high side switch). The load must be connected between the output pin and the return of the VIO power supply.

The output driver supports resistive and inductive loads.

NOTICE

When using inductive loads, the output driver has internal clamping to demagnetize the load. This clamps the output pin to about 55 V below VIN. When using this feature, very carefully evaluate that the demagnetization energy does not overheat the output driver. Parameters to check are the switching frequency, the load current, the load inductance and VIO voltage. Refer to the VN330SP datasheet for more information. If in doubt, add external clamping circuits.

VIO

VN330SP

Polarity

Reversal

Protection

Output GPIO

GND-IO

Input GPIO

Load

figure 5: digital IO detailed schematic

emVIEW-7/RPI3 (Hardware and Software Manual) • Installation 3 - 15

Rev. 1.0 © Janz Tec AG

3.2.8 Audio Video HDMI

The combined audio and analogue video connector, as well as the HDMI connector is not accessible on the emVIEW-7/RPI3.

4 - 16 emVIEW-7/RPI3 (Hardware and Software Manual) • Maintenance

4 Maintenance

NOTICE

Always follow common ESD practice when you service the product!

Task

Remarks

Replace µSD-card

Remove SD card bracket

Change jumper settings

Remove CPU top

Replace Battery

Complete disassembly

Refer to the images below for the screws to be removed for different maintenance tasks.

micro-

SDcard

Remove these 3 screws

figure 6: emVIEW-7/RPI3 microSD card

location and SD card bracket removal

Remove these

4 screws

figure 7: emVIEW-7/RPI3 CPU top cover removal

emVIEW-7/RPI3 (Hardware and Software Manual) • Maintenance 4 - 17

Rev. 1.0 © Janz Tec AG

4.1 icroSD card Replacement

NOTICE

Power must be turned off before removing or inserting the microSD card

Refer to Fehler! Verweisquelle konnte nicht gefunden werden. to identify the location of the microSD card. Remove the SD card bracket. The microSD card is hidden by the internal display cable. Gently pull the display cable out, to be able to remove/install the microSD card.

4.2 Jumper Settings

Refer to figure 7 for the screws related to CPU top cover removal.

NOTICE

Do not damage the display cable when removing the CPU top cover.

When the top cover is removed, you can access the jumpers. After modification, re-mount the top cover.

4.3 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 (refer chapter 4) and locate the battery on the Janztec board.

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

5. Insert the new battery (See figure 8)

6. Re-assemble the housing

7. See chapter 5.2.4.4 for important software information

4 - 18 emVIEW-7/RPI3 (Hardware and Software Manual) • Maintenance

1 2

1. Removal: Insert screwdriver at right side and bend so that the battery pops outs. Use only gentle force, otherwise the battery holder might be damaged. The use a plastic tool is preferred to avoid shorting the battery

2. Insertion: Align new battery to the left side of the holder (below the hooks) and gently press down on the right side of the battery until the battery snaps into the holder.

figure 8: Removing and replacing coin cell battery

emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers 5 - 19

Rev. 1.0 © Janz Tec AG

5 Operating System and Drivers

When you order the emVIEW-7/RPI3 with pre-installed software (Raspbian operating system), then

our default Janz Tec image is pre-installed on the µSD-card and the emVIEW-7/RPI3 driver package

is already installed and fully configured. For more information, refer to 5.2.

Of course, you can order the emVIEW-7/RPI3 without software, so you can choose a Raspberry PI 3 B compatible operating system of your choice and install it manually on a µSD card. (Raspbian recommended) Refer to 5.1.1 on how to install an image from the official Raspberry Pi website.

5.1 Standard Raspbian Operating System

If the additional interfaces of the emVIEW-7/RPI3 (RTC, CAN and RS232/RS485) are not required, then the latest official Raspbian operating system is recommend for emVIEW-7/RPI3 systems. (Digital IO and LEDs are controllable by standard GPIO commands and console (RS232) is supported by Raspbian by default). To use all the emVIEW-7/RPI3 features, refer to chapter 5.2 and 5.3.

5.1.1 Installation

For more information on how to prepare a µSD-card to run the Raspbian operating system visit:

https://www.raspberrypi.org/documentation/installation/installing-images/README.md

Our Janz Tec image is based on the official RASPBIAN JESSIE LITE image from 2016-09-23 with Kernel 4.4. (SHA-1: 3a34e7b05e1e6e9042294b29065144748625bea8)

Download at: https://downloads.raspberrypi.org/raspbian_lite/images/ raspbian_lite-2016-09-28/

Default log in credentials:

Username: pi Password: raspberry

(depending on your keyboard layout language, the last “y” might be “z” on your keyboard) For more information visit the official Raspberry quick start guide:

https://www.raspberrypi.org/help/quick-start-guide/

5.2 emVIEW-7/RPI3 Driver Installation Script

NOTICE

Always create a backup of the µSD card before installing this script! NOTICE

This script is only compatible to Raspbian based installations!

5 - 20 emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers

To automatically install all configuration entries and drivers to enable the additional features of the emVIEW-7/RPI3 (RTC, CAN and RS232/RS485), we provide an installation script and installation instructions available at: https://github.com/janztec/empc-arpi-linux-drivers

All source code modifications made by Janz Tec AG are publicly available at

https://github.com/janztec/empc-arpi-linux

5.2.1 Installation Instructions

The installation requires that the emVIEW-7/RPI3 has booted successfully from the Raspbian image on the µSD-card prepared in chapter 5.1.1 and that you have created a backup copy of the µSD-card. For more installation instructions visit:

https://github.com/janztec/empc-arpi-linux-drivers/blob/master/README.md

5.2.2 CPU Frequency

CPU frequency is set to fixed 600MHz in file /boot/config.txt. See 7.1 “Environmental Specifications” for more information:

root@raspberry ~$ nano /boot/config.txt arm_freq=600

5.2.3 Bluetooth

Bluetooth is not available after installing this driver package. The reason is, that the Raspberry PI 3B module has internally two serial ports. Normally the Raspbian image has the following configuration:

Serial console (uart1): this uses the core clock and when the CPU core clock changes, the baud rate will change also

Bluetooth (uart0): this UART has larger FIFOs and a dedicated clock, so the baud rate is not dependent on the CPU core clock

In favour of the serial console, we have configured that the two serial ports are switched. Serial console then uses uart0 and Bluetooth uses uart1. This is configured in file /boot/config.txt. With this configuration setting, serial console works the same as on the Raspberry PI 2B, but Bluetooth does not work correctly.

root@raspberry ~$ nano /boot/config.txt dtoverlay=pi3-miniuart-bt

5.2.4 Driver Details

The following drivers are automatically installed by our driver installation script:

5.2.4.1 spi-bcm2835 : SPI driver (optimized for emVIEW-7/RPI3)

CAN and RS232/RS485 controllers are connected by SPI to the Raspberry PI board and we have optimized the default Raspberry SPI (spi-bcm2835) driver for better performance.

5.2.4.2 mcp2515 : CAN driver (optimized for emVIEW-7/RPI3)

emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers 5 - 21

Rev. 1.0 © Janz Tec AG

This driver installation includes a SocketCan compatible driver. In the configuration file /etc/network/interfaces the CAN device with the Linux device name can0 is enabled by default (buson) and is configured to 500Kbit (bitrate 500000). To change the default bitrate, edit file /etc/network/interfaces, change the bitrate parameter and restart your system.

Here are some can-utils examples: Print incoming can frames:

pi@raspberry ~$ candump can0

Send random can frames:

pi@raspberry ~$ cangen can0

Show can bus load information:

pi@raspberry ~$ canbusload can0@5000000 -r -t -b -c

NOTICE

On high CAN-bus utilization, incoming CAN frames might get dropped because of an overrun in the MCP2515 FIFO. To reduce the possibility of such overruns, we have highly optimized the CAN and SPI drivers to receive incoming CAN frames significant faster than the default mcp2515 Linux driver. As a result, even with high bus utilization, baudrates up to 500Kbit/s can be used with (almost) no CAN frame drops. Because of the limitations of the MCP2515 controller and the interrupt latency of Linux, the 1Mbit/s baudrate is not recommend, when CAN frame drops cannot be accepted.

5.2.4.3 sc16is7xx: RS232/RS485 driver (optimized for emVIEW-7/RPI3)

By default, the emVIEW-7/RPI3 is configured to RS232 mode (Jumper J301 is set). If you want to use RS485 mode, open the case as described in chapter 4 and remove the jumper J301

and check the following configuration:

pi@raspberry ~$ sudo nano /boot/cmdline.txt

When parameter RS485 is set to 2 (RS485=2), then ‘automatic mode’ is enabled. Starting with hardware revision 1.1, this parameter sets RS232 or RS485 mode based on the jumper J301 setting and no further manual software configuration is required. For older hardware revisions, manually configuration as shown below is required.

Parameter RS485=1 enables the automatic RS485 RTS control mode and automatically controls the RS485 transceiver direction for sending or receiving.

Parameter RS485=0 disabled the RS485 mode and enables normal RS232 operation.

5.2.4.4 rtc-ds1307: RTC

MCP7940N RTC is compatible with the rtc-ds1307 Linux driver (supported from kernel 3.19). The emVIEW-7/RPI3 installation installs the RTC service, so that the RTC automatically sets the system time on every boot.

5 - 22 emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers

Reading the RTC time:

pi@raspberry ~$ sudo hwclock -r

Writing the system time to the RTC

pi@raspberry ~$ sudo hwclock --systohc -D --noadjfile --utc-r

After replacing the RTC battery, call the following command lines to set the RTC oscillator trim register to value 0 persistently. (Otherwise the RTC will be less precise than it could be)

pi@raspberry ~$ sudo bash pi@raspberry ~$ modprobe i2c-dev pi@raspberry ~$ mknod /dev/i2c-1 c 89 1 2>/dev/null pi@raspberry ~$ i2cset -f -y 1 0x6f 8 0x00 b

emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers 5 - 23

Rev. 1.0 © Janz Tec AG

5.3 Janz Tec AG Linux Image for emVIEW-7/RPI3

Our pre-installed Janz Tec AG Image is optionally available and contains the combination of the official Raspbian operating system as well as our emVIEW-7/RPI3 drivers. File /root/imageversion.txt contains the image name and version of the installed Janz Tec image.

You can start the raspi-config Raspberry PI configuration tool with “sudo raspi-config”, which offers important configuration settings in a convenient menu.

https://www.raspberrypi.org/documentation/configuration/raspi-config.md

5.4 General Information

• 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). Alternatively, mount the µSD card as read-only, in combination with a RAM-file system overlay.

5.5 Optional Software

5.5.1 CODESYS Control for Raspberry Pi SL Information

NOTICE

Without further agreements, Janz Tec AG does not provide support for configuring and running CODESYS Control for Raspberry PI SL on the emVIEW-7/RPI3!

CODESYS control runtime system is a soft PLC created by the company 3S-Smart Software Solutions GmbH and is available for Raspberry Pi based devices. Using this IEC 61131-3 programming system in combination with our emVIEW-7/RPI3 system is ideal for testing and educational applications, because the control can make use of the additional interfaces the emVIEW-7/RPI3 offers (digital IO, CAN, RTC and RS232/RS485).

To download a time limited evaluation version, or buy a full license visit: http://store.codesys.com/

NOTICE

Always consult the official “CODESYS Control for Raspberry Pi SL” documentation, product description, features and licensing terms.

The following summary of features is only for your information and might not be accurate. Even with the standard Raspbian operating system without any modifications, the CODESYS Control

for Raspberry Pi SL can control all digital IO’s on the emVIEW-7/RPI3 by using the GPIO device already included in the CODESYS device repository. (Red and green LED also controllable by this GPIO device). The serial console (RS232) is also support by default. *2

When the optionally available emVIEW-7/RPI3 driver package is installed, the CODESYS control can also access the CAN port for CAN/CANopen as well as the serial console (RS232) and the RS232/RS485 ports for serial and Modbus RTU communications. The RTC support is especially useful when you do not have a network time server connected, but you want to use date and time in e.g. log files.

5 - 24 emVIEW-7/RPI3 (Hardware and Software Manual) • Operating System and Drivers

CODESYS Features

Standard Raspbian

Raspbian + emVIEW-7/RPI3 driver package

CAN/CANopen *1

not supported

supported (using SocketCan)

Modbus RTU Master *2

console (RS232, 2wire)

console (RS232, 2wire) serial port RS232 (4wire) serial port RS485

GPIO device

digital IO (4in, 4out) red and green LEDs

Date / Time

requires a time server in the network

• RTC / system time

• (network time server also possible)

*1: In the current version: 2.1.1.0 of the CODESYS control package, CAN/CANopen is included in the evaluation and paid version, but not mentioned in the product description *2: May require manual configuration in the CODESYS configuration files

5.5.1.1 Information

If you are interested in CODESYS runtime systems with real-time support, more Ethernet ports, or more fieldbus ports, our embedded PC series emPC and panel PC series emVIEW offer the whole range of industrial PCs in many performance classes.

https://www.janztec.com/en/embedded-computing.html

5.5.1.2 License Information

NOTICE

We strongly recommend, that you create a backup copy of an activated license!

In case that the contents of the card will become corrupt, the license will be lost! We strongly recommend, that your first step is to create a backup copy of the activated license.

To create a backup copy of the license, copy the folder “backup” with the file „3SLicenseInfo.tar“ from

the Raspberry Pi (accessible in CODESYS via double-click on the device under the tab “Files”) to a safe external storage.

emVIEW-7/RPI3 (Hardware and Software Manual) • Programming Information 6 - 25

Rev. 1.0 © Janz Tec AG

6 Programming Information

This chapter gives technical information on how to program, or adapt existing Linux drivers to the emVIEW-7/RPI3 hardware and is intended for users familiar with creating own Linux kernels and drivers.

For standard Linux users, optionally our emVIEW-7/RPI3 driver package (chapter 5.2) is available and this already includes all required drivers, therefore no driver programming is needed to use the emVIEW-7/RPI3 hardware and it’s interfaces.

6.1 User LEDs

The two front panel LEDs of the CPU module are controllable by the user. They are controlled by Raspberry GPIOs.

GPIO

GREEN

GPIO5 (Pin 29)

RED

GPIO12 (Pin 32)

LEDs are turned on by setting the GPIO to low level. Example:

root@raspberry ~$ echo "12" > /sys/class/gpio/export root@raspberry ~$ echo "out" > /sys/class/gpio/gpio12/direction root@raspberry ~$ echo "1" > /sys/class/gpio/gpio12/value root@raspberry ~$ echo "0" > /sys/class/gpio/gpio12/value

NOTICE

When the emVIEW-7/RPI3 driver package (chapter 5.2) has been installed, the green LED is configured to show the µSD-card activity. To control this LED by from the command line, uncomment the entry “dtparam=act_led_gpio=5” from the configuration file /boot/config.txt and remove all entries starting with “bcm2708.disk_*” from the configuration file /boot/cmdline.txt and reboot the system and reboot the system. After this, setting the output value of GPIO 5 controls the green LED.

6.2 I²C Bus

The emVIEW-7/RPI3 utilizes the Raspberry I2C bus to connect to several peripheral devices.

Type

Device

Address

Notes

EEPROM

0b1010000

Optional

Thermal Sensor

DS75

0b1001000

Optional RTC

MCP7940

0b1101111

Table 8: Internal I²C devices

6.3 SPI Bus

The emVIEW-7/RPI3 utilizes the Raspberry PI SPI bus to connector CAN and an additional UART.

Type

Device

Chip Select

Interrupt

CAN

MCP2515

CE0#

GPIO25 (Pin22)

UART

SC16IS740

CE1#

GPIO17 (Pin11)

6 - 26 emVIEW-7/RPI3 (Hardware and Software Manual) • Programming Information

6.4 CAN

The CAN controller is clocked by a 16 MHz crystal.

6.5 Serial Port (RS232/RS485)

The UART is clocked by a 1.8432 MHz oscillator. When in RS485 mode, the transmitter is controlled by the UART’s RTS signal. A low enables the

transmitter. The receiver is disabled whenever the transmitter is enabled, hence transmitted characters are not

received. It is possible to modify the hardware such that the receiver is always enabled, to allow verification of transmitted characters. Ask for details if you need to make such a modification.

6.6 Digital IO

The digital inputs and outputs are controlled by Raspberry PI GPIO signals.

GPIO

DI1

GPIO6 (Pin 31)

DI2

GPIO13 (Pin 33)

DI3

GPIO16 (Pin 36)

DI4

GPIO19 (Pin 35)

DO1

GPIO23 (Pin16)

DO2

GPIO22 (Pin 15)

DO3

GPIO27 (Pin 13)

DO4

GPIO18 (Pin 12)

To turn digital output on (drive VIO to the output), set the GPIO to high state. All other states (low, high-Z or weak pullup) will turn the digital output off.

Digital input GPIOs must be configured as input. A high level will be detected if sufficient voltage is detected on the digital input pin.

Programming the digital inputs and outputs is the same as on a standard Raspberry PI 2 B, so you can get more information on http://elinux.org/RPi_Low-level_peripherals#Shell

6.7 Console RS232

On Raspbian based installations, by default this port is configured as a serial Linux console and you can log into the Raspberry using a standard serial (null modem) cable and a terminal program like

“Putty”. Use the following settings to log in: Speed (baud rate): 115200, Bits: 8, Parity: None, Stop

Bits: 1, Flow Control: None To permanently disable the serial console and use this port for RS232 (2 wire) connections with the

device name /dev/ttyAMA0, the tool “raspi-config" allows the configuration in menu, 8 Advanced Options, A7 Serial and “No”. (if you need 4-wire RS232, use the RS232/RS485 port, see 3.2.5)

6.8 Overclocking

The thermal design of the emVIEW-7/RPI3 does not support CPU overclocking. Changing the CPU parameters (CPU MHz, Voltage) is not recommended as it will permanently set a fuse in your SoC and void your warranty.

emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices 7 - 27

7 Appendices

7.1 Technical Data

Only Raspberry features usable on emVIEW-7/RPI3 are listed.

Processing Core

CPU

BCM2837, up to 1200MHz quad-core 64bit ARMv8 Cortex A53 CPU

Memory

Main Memory

1GB LPDDR2 SDRAM

Storage

MicroSD card

1 x internal socket

Display

Size

7” TFT, 800x480 pixel

Touch

capacitive

External Interfaces

Ethernet

1 x 10/100 Mbit/s Ethernet (LAN9512, USB based)

WLAN

As defined by Raspberry PI 3 Module

Bluetooth

As defined by Raspberry PI 3 Module

USB

4 x USB2.0

CAN

MCP2515 controller

• ISO/DIS 11898-2 (isolated from logic),

• jumper switchable 120 Ohm termination resistor

Serial Port

Console (RPI defined)

• RS232 (2 wire) SC16IS740 controller

• RS232 (4 wire)

• RS485

Digital IO

• 4 x digital OUT (0.5 A max.), 10..32V

• 4 x digital IN

• Isolated from system ground

Indicators and Switches

User LEDs

2 programmable LEDs (red, green)

System

Housing

aluminumFront, Sheet metal backside

RTC

MCP7940

Battery

CR 2032, for real time clock

Power Requirements

Power Supply

DC power, 9 .. 32 V

Inv.-pol. protection

Yes

Fuse

Internal 2.5 A melting fuse in DC in, GND is unfused

potential separation

No, GND is connected to connector shells and PE contact

Inrush Current (max)

TBD

Power Dissipation

Without external load or expansion cards 7 W

7 - 28 emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices

External Load Capabilities

+5V (USB)

Max. 500 mA per USB port, max 500 mA for all USB ports

Environmental Specifications

Ambient Temperature operating

0 .. +40 °C (vertical orientation / wall and DIN rail mounting) 0 .. +35 °C (horizontal orientation / desk-top mounting)

at sea level, derated by 1 °C per 300 m above sea level to a maximum

of 2000 m.

the above temperature ratings are defined under the following CPU

load:

• No GPU load

• 4 cores loaded at 600 MHz or 1 core loaded at 1200 MHz,

where the load per core is comparable to that of the Linux stress utility

• The above numbers are without safety margins to compensate process variations of the Broadcom SoC

• More load will bring the CPU Junction temperature above 80 °C and the CPU will reduce clock frequency towards 600 MHz. The system will not overheat under such conditions.

Temperature storage

-20..+75 °C

Humidity

5%..95% r.H., non condensing

Protection Class

IP20

Physical Dimensions

Size (WxHxD)

203 x 120.8 x 47 mm (w.o. DIN rail clip or connector overhang)

Weight

TBD

emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices 7 - 29

7.2 References

These references direct you to manuals and specifications that you might need to know when you attempt to program the product. Most of the documents can be downloaded from the Internet. Look for the WWW servers of the component/chip manufacturers.

[1] https://www.raspberrypi.org/downloads/ [2] https://www.raspberrypi.org/documentation/

WWW-References

Janz Tec AG

www.janztec.com

7 - 30 emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices

7.3 Dimensions

Refer to figure 9 for the housing dimensions.

Note that the IO connector will hang over the dimensioned housing outline. Refer to figure 3 for the required panel cutout.

7,50 mm

39 mm

DIN Rail Clip

120,80 mm

203,0 mm

8,00 mm

11,60 mm

>4,2 mm

107,70 mm

R=12.0

M3 mounting bolt

figure 9: housing dimensions

emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices 7 - 31

7.4 Raspberry GPIO Header

Pin Number

Raspberry

emVIEW-7/RPI3

Direction

+3.3V

NC 2

+5V 3 GPIO2

I2C-SDA

Bidir

+5V 5 GPIO3

I2C-SCL

Bidir

GND

GPIO4

EEP_WP

Out 8 GPIO14

Console TxD

Out 9 GND

GPIO15

Console RxD

GPIO17

INT_UART#

GPIO18

DO4

Out

GPIO27

DO3

Out

GND

GPIO22

DO2

Out

GPIO23

DO1

Out

+3.3V

GPIO24

RS485_MODE_DETECT (0=RS232, 1=RS485)

In 19

GPIO10

SPI_MOSI

Out

GND

GPIO9

SPI_MISO

GPIO25

INT_CAN#

GPIO11

SPI_CLK

Out

GPIO8

SPI_CE_CAN

Out

GND

GPIO7

SPI_CE_UART

Out

27 NC 28 NC 29

GPIO5

LED green

Out

GND

GPIO6

DI1

GPIO12

LED red

Out

GPIO13

DI2

GND

GPIO19

DI4

GPIO16

DI3

GPIO26

NC 38

GPIO20

GND

GPIO21

7 - 32 emVIEW-7/RPI3 (Hardware and Software Manual) • Appendices

7.5 Product History

Version

Release Date

Name

Changes

1.0

2017-01-10

• First series with DIN rail mounting only

2.0

2017-05-10

• New model with flange mounting option

7.6 Manual History

Version

Release Date

Name

Changes

1.0

2017-05-10

• Initial release

•

Janz Tec emVIEW-7/RPI3 Hardware Manual

Specifications and Main Features

Frequently Asked Questions

User Manual