1. Manuals
  2. Brands
  3. Owasys Manuals
  4. Gateway
  5. Owa4X
  6. Integrator's manual

Owasys Owa4X Integrator's Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Owa4X
Platform
Integrator's Manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Owa4X and is the answer not in the manual?

Questions and answers

Related Manuals for Owasys Owa4X

Summary of Contents for Owasys Owa4X

  • Page 1 Owa4X Platform Integrator's Manual...
  • Page 2 2014/30/EU Low Voltage Directive 2014/35/EU as well as any other applicable requirements as those from RoHS Directive 2011/65/EU. The information contained in this document is the proprietary information of Owasys The contents are confidential and any disclosure to persons other than the officers, employees,...

  • Page 3: Table Of Contents

    1.9 Children........................6 1.10 Explosive atmospheres..................6 1.11 Handling the device....................6 1.12 For owa4X/b......................7 2 Introduction........................8 2.1 Overview.........................8 2.2 What is the owa4X Platform...................8 2.3 Abbreviations......................8 2.4 Notes and Warnings....................9 3 Getting started with the DK..................10 3.1 Introduction......................10 3.2 Development Kit Contents..................10 3.3 Physical Description....................10...
  • Page 4 7.1 uSD........................42 7.2 TFTP server......................43 7.3 Creating a customized UBIFS image from owa4x FS tree........44 7.4 Creating a customized UBIFS image from current FS running in owa4x.....46 7.5 Starting the recovery image...................46 7.5.1 FW < 1.1.x.......................46 7.5.2 FW >= 1.1.x.....................47 8 U-boot environment.....................49...
  • Page 5 Illustration 13: Insertion of BAT 418 6500..............24 Illustration 14: USB pinout...................24 Illustration 15: Main connector..................25 Illustration 16: Digital output typical loads..............28 Illustration 17: owa4x RS485 bus................29 Illustration 18: RJ45 connector..................32 Illustration 19: Accelerometer axis................34 Illustration 20: IP67 cover with Ethernet option............35 Illustration 21: Accelerometer / Gyroscope axis............35...

  • Page 6: Safety And Other Precautions

    . If there is any uncertainty, please contact Customer Support at customer_support@owasys.com. Owa4X protections The owa4x inputs have some protections to avoid damages when erroneously connecting to a power supply for example or due to voltage peaks: Power supply input (V_IN) reverse voltage protection and overvoltage protection •...

  • Page 7: Antenna Care And Replacement

    “turn off your two way radio”. Construction crew often uses remote control RF devices to set off explosives. Children owa4X. Do not allow children to play with It is not a toy and they could hurt themselves or others.

  • Page 8: For Owa4X/B

    Also, before you connect a cable make sure both connectors are correctly oriented and aligned. 1.12 For owa4X/b These models include the optional lithium-ion battery backup. Do not dispose off the battery along with household waste. Contact your local waste disposal agency for the address of the nearest battery disposal site.

  • Page 9: Introduction

    Integrators Manual describes how to install, set up, and configure Platform product. The owa4X device can be provided with battery backup as an option. In this case, the owa4X/b product is labelled with a “/b” at the end, e. g.: This first section provides a brief overview of the product followed by a “Getting Started”...

  • Page 10: Notes And Warnings

    Application Programming Interface Controller Area Network Circular Error Probability Central Processing Unit Data Terminal Equipment EDGE Enhanced Data GSM Environment GPRS General Packet Radio Service GNSS Global Navigation Satellite System Global System Mobile HSDPA High-Speed Downlink Packet Access Hardware MIPS Millions of Instructions Per Second Memory Management Unit Not Connected...

  • Page 11: Getting Started With The Dk

    The standard unit has GSM and GNSS external antenna connectors, while Bluetooth and WiFi antennas are internal, as shown in the following image. The AUX LTE antenna will only be available in owa4x with HW R4, which mounts a LTE module.

  • Page 12: Rear Back Cover Options

    Integrator's Manual owa4X BOK-100 9002 RB2 Illustration 2: WiFi-BT antenna placement When using either WiFi or Bluetooth functionality, try to make sure that the installation lets a free view of this side of the unit. The “UP” mark shows the side that must be upwards, and the front should also not be in contact or very close of metallic surfaces.

  • Page 13: Illustration 4: No Ip67 Rear

    Integrator's Manual owa4X BOK-100 9002 RB2 3.3.2.1 No IP67 rear back cover This back cover is open and does not support the IP67 requirements. Illustration 4: No IP67 rear back cover 3.3.2.2 IP67 rear back cover This back cover supports IP67 requirements, and has no opening at all.

  • Page 14: Illustration 6: Ip67 Rear Back Cover With Cable Gland

    Integrator's Manual owa4X BOK-100 9002 RB2 Illustration 6: IP67 rear back cover with cable gland 3.3.2.4 IP67 rear back with cable gland and M12 cable This back cover supports IP67 requirements, has a cable gland and also a cable with a M12 connector, that gets out the Ethernet connection signals.

  • Page 15: Illustration 9: M12 And Cable Gland

    Integrator's Manual owa4X BOK-100 9002 RB2 RJ45 (Eth) 1 TD+ 1 TX+ 2 RD+ 3 RX+ 3 TD- 2 TX- 4 RD- 6 RX- The M12 connector is connected to the cable gland. Illustration 9: M12 and cable gland...

  • Page 16: Developer's Board Physical Description

    Integrator's Manual owa4X BOK-100 9002 RB2 3.3.3 Developer’s Board Physical Description Following figure shows the layout of the Development Board connectors: Illustration 10: Developers board physical description...

  • Page 17: Schematic Of Developer's Board

    Integrator's Manual owa4X BOK-100 9002 RB2 3.3.4 Schematic of Developer’s Board Illustration 11: Developers board schematic...
  • Page 18 9V – 36V for HW R4 or newer, and a fuse F1 is mounted in the DK board to prevent damages to other components in case of over-voltage. Connectors J1 to J5 are used to connect the necessary signals to the owa4X. All the signals are available in the connectors mounted in the front in case they have to be connected to external devices.
  • Page 19 Integrator's Manual owa4X BOK-100 9002 RB2 3.2 Connector J1 of DK Microphone and speaker signals are connected to Jacks for the microphone and speaker connection. Analog inputs are connected to potentiometers through switches. The switches should be in OFF position if external signal sources are to be applied.

  • Page 20: Connecting The Owa4X Development Kit

    RS232 interface signals of the UART4 go to J6 DB9 connector too. J7, J8, J9, J10, J11 connectors are directly connected to signals coming from the owa4x connectors in order to connect external devices or signal sources. Connecting the owa4X Development Kit This section describes the owa4X development kit components connections.

  • Page 21: Connecting Owa4X To A Pc

    Linux distro, on this case Debian Jessie. To transfer a file from the PC to the owa4x, change to /home directory or to the directory where the file is to be stored (cd /home or cd /directory_name), type rz command and choose Transfer->...
  • Page 22 Integrator's Manual owa4X BOK-100 9002 RB2 3.4.3.1 Ethernet connections To communicate with the owa4x a SSH connection can be stablished too using the Ethernet interface, if the unit features this option. The system get the SSH daemon up by default, and its configuration is: IP: 192.168.10.1...

  • Page 23: Owa4X Main Features

    The supported GNSS receiver is Ublox NEO-M8N. 4.1.4 Hardware Interfaces Owa4X is able to interface with many different devices through an extensive range of hardware signals, grouped into several connectors. Here every connector pin-out is depicted together with a brief description of every signal...

  • Page 24: Illustration 12: Insertion Of Bat118 6500

    4.1.4.2 RTC and GNSS Data Battery This is a small dedicated non-rechargeable battery which is supplied with all owa4X units to provide backup of the RTC and GNSS data. The RTC will be maintained for 10 years. The GNSS data is continuously backed-up.

  • Page 25: Illustration 13: Insertion Of Bat 418 6500

    Integrator's Manual owa4X BOK-100 9002 RB2 Illustration 13: Insertion of BAT 418 6500 *The connectors at the batteries may vary. 4.1.4.4 USB interface USB connector with mass storage functionality. Illustration pinout Signal Function VBUS +5 V Data - Data +...

  • Page 26: Illustration 15: Main Connector

    Integrator's Manual owa4X BOK-100 9002 RB2 4.1.4.5 Machine Connector To provide maximum flexibility, a 35 pin TE automotive connector is provided with power input, several RS232 interfaces, digital and analog I/Os and a CAN bus connection. Illustration 15: Main connector...
  • Page 27 Integrator's Manual owa4X BOK-100 9002 RB2 POWER AIN0 Input. Imp: 5.12V or 0 to 50V 110K 30.72V DIO-0 Input. Imp: 0-6V 9V -50V 0 to 50V 220K DIO-0 Open Drain 0,6V@200mA Output DIO-1 Input. Imp: 0-2V 3.3V -50V 0 to 50V...
  • Page 28 Mating connector manufacturer part number: TE 776164-1 Crimps: TE 770520-1 3 Machine connector pinout 4.1.4.5.1 Power Supply Power supply in pin 24 of the machine connector is used to supply power to owa4x. Signals used for this purpose are: Signal Type Min level Max level...

  • Page 29: Illustration 16: Digital Output Typical Loads

    Vin, then the unit will remain OFF. 4.1.4.5.2 Digital Inputs/Outputs (DIO0..9) The owa4x provides up to 10 configurable digital Input/Outputs, from DIO0 to DIO9. These pins can be configured as inputs or as outputs. Note that if the pin is configured as an output it cannot be used as an input, and may be damaged if a voltage is applied while it is configured as an output.

  • Page 30: Illustration 17: Owa4X Rs485 Bus

    RS485 bus is shown. First and last devices in the bus should be equipped with terminating resistors of 120 ohms. owa4x does not have this terminating resistor internally so it must be added externally as depicted in next figure.
  • Page 31 • connector to receive K Line data. 4.1.4.5.7 Ground owa4x provides a ground connection for all interfaces, digital I/Os, RS485, CAN and analog inputs. 4.1.4.5.8 Speaker connection Audio output is of BTL type (Bridge Tied Load). That means none of the speaker signals are internally connected to ground.
  • Page 32 AIMMET 3659NTG14C1. Please contact Owasys to get more information on this connector. 4.1.4.9 LEDs There are 6 LEDs, 4 at the front of the owa4x, see 2, and 2 at the rear with the optional Ethernet RJ45 connector, see 2. These are the LEDs colours and functions:...
  • Page 33 GSM module and this has preference over the usage from the user application. The orange LED on owa4x is controlled by the GNSS module and gives one pulse per second when the GNSS module has coverage. GNSS Module State...

  • Page 34: Internal Temperature

    Card The microSD card is inserted in its slot. This holder is also under the cover at the rear of the owa4x, right above the SIM card holder as shown in 2 4.1.5 Internal Temperature The owa4x has an internal sensor to measure its internal temperature.

  • Page 35: System Time And Hw Time

    The CPU system time: This clock is able to maintain system time in  normal operation but loses the time when owa4x is powered off or is put into a low power mode. The RTC module: This is a dedicated Real Time Clock (RTC) ...

  • Page 36: Optional Features

    10/100 Ethernet can be provided with a RJ45 connector at the rear side of the owa4x. The owa4x has also an optiona back cover rated IP67 with a cable gland for the Ethernet cable. It has been designed and tested with Yamaichi Y-concable4 (external diameter 6.8mm) and Y-conplug-11 connector.
  • Page 37 A second KLine interface may be installed as option. 4.1.9.8 Trusted Platform Module (TPM) The owa4x with HW R4 has the option to mount a TPM2.0 (ISO/IEC 11889). This TPM is tamper resistant against invasive silicon, fault injection and side channel attacks, and provides protected storage, device hardware identity, secure generation of cryptographic keys and a random number generator.

  • Page 38: Power Management

    System halt The owa4x is a unit designed to run at all times, as it will be installed in remote places. As such, the power management will reset the unit whenever the main...
  • Page 39 Integrator's Manual owa4X BOK-100 9002 RB2 “reboot –halt” will not work as expected, and in less than 3 minutes the system will be rebooted. In case that the user wants to halt the system, a custom command, OwaTurnOff, must be used instead. This command makes use of the power management functionality to set the unit in STOP mode.

  • Page 40: Firmware Specifications

    Integrator's Manual owa4X BOK-100 9002 RB2 Firmware Specifications General Description of Firmware In order to manage the platform resources, a complete library of APIs, for GNSS management, Internet connection, management of the interfaces, GSM/ GPRS functions and other services is made available. Thus, the developer does not need to consider about low level hardware drivers and protocols, and can focus on the application by means of user-friendly APIs.

  • Page 41: Starting To Develop The Customer Application

    Once the cross compiler is installed, the user can use this compiler in the desired development environment, for example, Netbeans. To use the available APIs library functions, add the includes to owa4x files in application header files and compile the application using the provided cross compiler.

  • Page 42: Can Bus Fms Api

    6.6.2 CAN Bus FMS API There is available a FMS library, that can run in the owa4x under a license. This library provides the most important data in a FMS bus available through a couple of simple functions. This library must be first enabled to use it, so if desired please request this to your distributor.

  • Page 43: Updating Owa4X Fw

    The update is possible in any of the two following ways: A FW image can be flashed to the NAND of the owa4x from the bootloader, that previously has been stored in a uSD card. These are the instructions to flash the MLO, u-boot, DTB, kernel, backup FS and Debian FS.

  • Page 44: Tftp Server

    0x82000000 NAND.file-system ${filesize} TFTP server The owa4x FW components can be saved in a TFTP server in the same LAN where the owa4x is connected, or which is accessible to it, and the owa4x can get them using a set of commands.

  • Page 45: Creating A Customized Ubifs Image From Owa4X Fs Tree

    The user can create a customized UBIFS, based on the rootfs available in the dev zone, owa4x FS tree. After decompressing it in the PC and make the desired changes to it, mkfs.ubifs and ubinize commands may be used to create the image.
  • Page 46 Integrator's Manual owa4X BOK-100 9002 RB2 mode=ubi image=ubifs.img vol_id=0 vol_size=953MiB vol_type=dynamic vol_name=rootfs vol_flags=autoresize Commands to create a FS >= 1.1.0 and HW < R2: • $ sudo mkfs.ubifs -F -q -r debian_9.6_rootfs -m 4096 -e 520192 -c 1890 -o ubifs9.6-524288.img $ sudo ubinize -o ubi9.6-524288.img -m 4096 -p 512KiB -s 1024...

  • Page 47: Creating A Customized Ubifs Image From Current Fs Running In Owa4X

    Creating a customized UBIFS image from current FS running in owa4x The user can copy the filesystem that is currently in the owa4x executing the following command: tar --exclude="/dev" --exclude="/run" --exclude="/tmp"...

  • Page 48: Fw >= 1.1.X

    Integrator's Manual owa4X BOK-100 9002 RB2 Check what ubifs volume has been generated (e.g /dev/ubi1) and mount the partition (-m 10 is due to the mtd partition number): ubiattach /dev/ubi_ctrl -m 10 mount -t ubifs /dev/ubi1_0 /tmp After the changes, boot normally the device.
  • Page 49 0 In this backup FS all the Owasys libraries are available so the user program running on this FS could call to any API function as in the main FS, which can be of use in order to connect to the server and to try to recover the main system...

  • Page 50: Boot Environment

    Integrator's Manual owa4X BOK-100 9002 RB2 U-boot environment The u-boot environment variables can be saved permanently in flash, and accessed from the system using fw_printenv and fw_setenv command line tools. root@arm:/# fw_printenv arch=arm System boot protection The u-boot has a counter that can be enabled to protect undesired states, where an erroneous FS provokes a continuous reboot cycle of the system.

  • Page 51: Systemd - System And Service Manager

    The default.target file is a symbolic link to the true target file. In particular, the default target in the owa4x is multi-user.target which is like runlevel 3 in SystemV. For example, the multi-user.target unit starts other essential system services, such as, networking, D-Bus or systemd-timesyncd.

  • Page 52: Enabling And Disabling Services

    WantedBy = multi-user.target 9.3.1 Enabling and disabling services In the owa4x the user can enable multiple applications to automatically start at boot. This is achieved by the following command: systemctl enable application.service To disable the service from starting automatically, you can type: systemctl disable enable application.service...

  • Page 53: Backup Fs

    A backup FS is included that can be used to recover the system, either locally or remotely, as this small FS has all the libraries needed to open a data session with the 4G module, using the owasys GSM library. 11 Installation 11.1 owa4x dimensions...

  • Page 54: Antenna Tuning

    • 11.4 Choosing a location Choose a location for owa4x which allows for convenient routing and connection of the antenna and interface cables, and which has access to power source and status LEDs. When selecting a mounting location, avoid the following hazards: Direct exposure to weather.

  • Page 55: Opening The Unit

    The 2 metal brackets are fixed in the sides of the owa4x, and the screws to mount it are not provided, as the installation scenario can vary significantly.

  • Page 56: Illustration 24: Installation Brackets Measurements

    For the WiFi/BT option, take care not to blind the internal antenna, placing the brackets in the upper side of the owa4x, so that the antenna has an open view. See the “satellites up” signal in one the sides to guide on the installation of the fixing units, as this signal must have the open view.

  • Page 57: Technical Data Summary

    Integrator's Manual owa4X BOK-100 9002 RB2 12 Technical data summary 12.1 General Specification Item Specification Processing 32 bits CORTEX A8 core at 800MHz Capacity Available Memory for About 800 MB Flash About 450 MB RAM user General Specification 12.2 Mechanical Description...

  • Page 58: Owa4X With Hw = R4

    Integrator's Manual owa4X BOK-100 9002 RB2 Item Specification Operations Audio calls, Data calls, Short Message Service Integrated holder, 3 V Antenna Connector Fakra plug Male type D GSM/GPRS specifications 12.4.2 Owa4x with HW = R4 Item Specification LTE-FDD: B1/B2/B3/B4/B5/B7/B8/B12/B13/B18/ Frequency bands...

  • Page 59: Environmental Specifications

    With Li-Ion Battery option fitted -20ºC to +60 ºC 0ºC to +45 ºC Li-Ion Battery recharge Environmental specifications 12.7 Battery Backup Only for the owa4x/b with optional 3350 mAh Li-ion rechargeable battery. Item Specification Time to recharge 3.5 hours Charging temperature range 0 ºC to 45 ºC...

  • Page 60: References

    Integrator's Manual owa4X BOK-100 9002 RB2 13 References Ref. Doc. Number Description BOK_100_9000 Owa4x platform data-sheet Systemd https://www.freedesktop.org/software/systemd/man/ systemd.target.html BOK_100_9008 owa4x_API BOK_100_9007 Owa4x programming guide ubifs http://www.linux-mtd.infradead.org/doc/ubifs.html BOK-100_9016 TPM reference guide...

  • Page 61: History

    - UBIFS image creation instructions updated 44 - Vout max current updated 28 - Kline pinout corrected 29 - Instructions added to create image from current FS in the owa4x 46 - u-boot customization with OTA upgrade example added 39 - mount command corrected 46...
  • Page 62 Integrator's Manual owa4X BOK-100 9002 RB2 - Dimensions image updated 52 - GNSS spec table updated 57...

Table of Contents

Save PDF