Owasys Owa4X User Manual

%&'"()*+,,-,,.".
% #'6
% 4#'
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.
% +7
The boot loader is the booting system that manages the kernel and file system
flashing.
It waits for 0 seconds before starting up Linux, but this time it can be changed
with the variable bootdelay. During this time, if the boot loader receives a
character different than SPACE through serial port, it starts up Linux
immediately. If it receives SPACE, it enters in command mode; therefore the
received characters are interpreted as commands. Once finished in command
mode, send boot command for Linux start up.
The boot can be customized with the necessary u-boot environment variables,
which can help the user to recover from unexpected crashes of the FS that
prevents it to run, or remotely make an OTA upgrade of the FW. It follows an
example to show how the u-boot environment variables can be used for this
purpose:
fw_setenv update 1
fw_setenv availableupdate 'ubifsls /home/debian/update/ubi.img'
fw_setenv flashupdate 'ubifsload 0x82000000
/home/debian/update/ubi.img; nand erase.part NAND.file-system; nand
write 0x82000000 NAND.file-system ${filesize}; setenv update'
fw_setenv updatecmd 'ubi part NAND.file-system; ubifsmount
ubi0:rootfs; if run availableupdate; then run flashupdate; else
echo "Nothing to update"; fi'
fw_setenv bootcmd 'if test -n $update; then echo Running
update!!!!...; run updatecmd; fi; run nandboot'
fw_setenv and fw_printenv are the tools you need to set and get environment
variables from the owa4x system.
As shown, u-boot variables can contain conditional statements that can be run
by the user.
The example will flash the file system if a file /home/debian/update/ubi.img
exists. Take into account that this is an example, which could (should) be
easily improved (e.g. from the security point of view), as writing the flash
memory is a critical function.
% 75
This is a Linux standard kernel, version 4.4.19. As this is a standard kernel, PC
developed applications are easily made compatible with owa4x platform. Also
this kernel can be updated to follow standard kernel revisions.
% #'
The file system is based in a Debian distribution, codename Jessie.
%! ")#'
/-

Owasys Owa4X Specifications

General

Model	Owa4X
Power Supply	9-36 VDC
Operating System	Linux
Cellular Connectivity	4G LTE
Wi-Fi	802.11 b/g/n
Ethernet	10/100 Mbps
GPS	Yes
Serial Ports	2x RS232/RS485
USB	1x USB 2.0
Digital Inputs	4
Storage	4GB Flash
Bluetooth	Yes
Ports	Ethernet, USB, Serial

Summary

Safety and Handling Precautions

General Device Safety

Covers safe operation, handling, environment, and specific warnings.

Electrical Safety and RF Exposure

Details power supply, connections, protections, EMC, and RF energy exposure.

Specific Environment Warnings

Addresses blasting areas, explosive atmospheres, and children's safety.

Introduction to Owa4X Platform

Product Overview and Features

Introduces the Owa4X platform, its purpose, and key features.

Abbreviations and Notes

Explains abbreviations and provides guidance on notes and warnings.

Getting Started with the Developer Kit

Physical Description

Details physical aspects of the Owa4X, rear cover options, and board connectors.

Connecting to a PC

Guides for establishing PC connectivity via serial and Ethernet interfaces.

Owa4X Hardware Features

Core Specifications and Interfaces

Covers microprocessor, memory, GSM/GPRS, GNSS, and general hardware interfaces.

Detailed Interface Descriptions

Specifics on USB, Machine Connector, digital/analog I/Os, and communication protocols.

System Time, Sensors, and Optional Features

Information on system clocks, temperature, accelerometer, watchdog, and optional modules.

Power Management

Functional States and System Halt

Describes operational states, power modes, and procedures for halting the system.

Firmware Specifications and Updates

Firmware Overview and Boot Loader

Details firmware structure, boot loader, kernel, file system, and recovery.

Application Development and APIs

Guidance on developing applications using available APIs and software notes.

Firmware Update and Customization

Procedures for updating firmware via uSD/TFTP and creating custom UBIFS images.

U-boot and Systemd Management

U-boot Environment and Boot Protection

Configuration of U-boot environment variables and system boot protection.

Systemd Service Management

Introduction to systemd, boot process, unit files, and logging.

Installation and Technical Data

Installation and Mounting Procedures

Guides for unit dimensions, mounting, antenna setup, and power connection.

Technical Data Summary

Comprehensive summary of specifications including general, mechanical, power, GSM/GPRS, GNSS, and environmental data.

References and History

Document References and Revision Log

Lists referenced documents and the history of changes made to the manual.