Owasys owa23X User manual

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
i
owa23X Platform Integrator's Manual

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
ii
The products described in this manual conform to the essential Requirements in
Radio and Telecommunications Terminal Equipment Directive 1999/5/EC, covering
requirements included in EMC directive 2004/108/EC Low Voltage Directive 2006/95/EC as well
as any other applicable requirements as those from RoHS Directive 2002/95/EC
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,
agents or subcontractors of the owner or licensee of this document, without the prior written
consent of owasys, is strictly prohibited.
Furthermore, no portion of this publication may be reproduced, stored in a retrieval system, or
transmitted in any form or by any means, electronic or mechanical, including photocopying and
recording, without the prior written consent of owasys, the copyright holder.
Additional information at www.owasys.com.
Edition: January 2010
owasys publishes this manual without making any warranty as to the content contained herein.
Further owasys reserves the right to make modifications to this manual due to typographical
errors, inaccurate information, or improvements to programs and/or equipment at any time and
without notice. Such changes will, nevertheless be incorporated into new editions of this
manual.
All rights reserved.
© owasys, 2010
Document number: BOK-100 1065-C
Trademarks
© ARM is a registered trademark of ARM Limited.
Linux is a registered trademark of Linus Torvalds
DISPOSAL OF OLD ELECTRICAL & ELECTRONIC EQUIPMENT (APPLICABLE IN THE
EUROPEAN UNION AND OTHER EUROPEAN COUNTRIES WITH SEPARATE COLLECTION
SYSTEMS).
This product shall not be treated as household waste. Instead it shall be handed over to the
applicable collection point for the recycling of electrical and electronic equipment. By
ensuring this product is disposed of correctly, you will help prevent potential negative
consequences for the environment and human health, which could otherwise be caused by inappropriate
waste handling of this product. The recycling of materials will help to conserve natural resources. For
more detailed information about recycling of this product, please contact your local council, your waste
disposal service or the distributor where you purchased the product.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
iii
Table of Contents
1SAFETY AND OTHER PRECAUTIONS ............................................................................... 1
1.1 GENERAL..........................................................................................................................1
1.2 OWA23X CONNECTIONS ....................................................................................................1
1.3 EMC INSTRUCTIONS .........................................................................................................1
1.4 EXPOSURE TO RF ENERGY................................................................................................1
1.5 ANTENNA CARE AND REPLACEMENT. .................................................................................2
1.6 ELECTRONIC DEVICES.......................................................................................................2
1.7 BLASTING AREAS ..............................................................................................................2
1.8 CHILDREN.........................................................................................................................2
1.9 EXPLOSIVE ATMOSPHERES................................................................................................2
1.10 HANDLING THE DEVICE ..................................................................................................3
1.11 FOR OWA23X/B.............................................................................................................3
1.12 ACCESSORIES ...............................................................................................................3
2INTRODUCTION....................................................................................................................4
2.1 OVERVIEW........................................................................................................................4
2.2 WHAT IS THE OWA23X PLATFORM......................................................................................4
2.3 OWA23X MODELS .............................................................................................................5
2.4 ABBREVIATIONS ................................................................................................................5
2.5 NOTES,WARNINGS AND ESD............................................................................................6
3GETTING STARTED WITH THE DEVELOPMENT KIT ....................................................... 6
3.1 INTRODUCTION..................................................................................................................6
3.2 DEVELOPMENT BOARD DESCRIPTION.................................................................................6
3.2.1 Development Board Connectors .............................................................................7
3.2.2 Development Board LEDs, Switches & Pots...........................................................8
3.3 MOUNTING THE OWA23X DEVELOPMENT KIT......................................................................8
3.4 DEVELOPMENT KIT SOFTWARE SET UP..............................................................................9
3.4.1 Installing and Using the Cross Compiler .................................................................9
3.5 CONNECTING OWA23X TO A PC.......................................................................................10
3.5.1 Ways of Booting.....................................................................................................10
3.5.2 Windows HyperTerminal .......................................................................................11
3.5.3 Linux Minicom........................................................................................................11
3.5.4 Updating owa23X Boot loader, Kernel or File system...........................................12
3.6 DOWNLOAD A DEMO APPLICATION ...................................................................................12
4OWA23X DESCRIPTION ....................................................................................................14
4.1 OWA23X PHYSICAL DESCRIPTION....................................................................................14
4.2 HARDWARE FEATURES....................................................................................................15
4.2.1 Microprocessor and Memory.................................................................................15
4.2.2 GSM/GPRS System ..............................................................................................15
4.2.3 GPS .......................................................................................................................16
4.2.4 30 Pin Multipurpose Connector.............................................................................17
4.2.5 Power Supply.........................................................................................................18
4.2.6 Fusing....................................................................................................................18
4.2.7 Digital Inputs/Outpus .............................................................................................18
4.2.8 Odometer / Counter...............................................................................................20
4.2.9 Vout Power Output ................................................................................................20
4.2.10 Analog Inputs.........................................................................................................21
4.2.11 CAN .......................................................................................................................21
4.2.12 RS485....................................................................................................................22
4.2.13 RS232....................................................................................................................22
4.2.14 Ground...................................................................................................................23
4.2.15 Audio......................................................................................................................23
4.2.16 Ethernet 10-BaseT.................................................................................................24
4.2.17 LEDs......................................................................................................................24
4.2.18 SIM Card Holder....................................................................................................25

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
iv
4.2.19 Battery Back-up.....................................................................................................25
4.2.20 Internal Temperature.............................................................................................28
4.2.21 System Time..........................................................................................................28
4.2.22 Watchdog...............................................................................................................28
4.2.23 Protection...............................................................................................................29
4.2.24 Movement Sensor..................................................................................................29
4.3 FUNCTIONAL STATES.......................................................................................................30
4.4 POWER MANAGEMENT.....................................................................................................30
4.4.1 Power Modes.........................................................................................................31
4.4.2 Power Consumption ..............................................................................................34
4.5 FIRMWARE SPECIFICATIONS.............................................................................................35
4.5.1 General Description of Firmware...........................................................................35
4.5.2 User ‘Hard Disk’.....................................................................................................36
4.5.3 Starting to Develop the Customer Application.......................................................36
4.5.4 Loading the Customer Application.........................................................................39
4.5.5 Available APIs........................................................................................................39
4.5.6 Power Management...............................................................................................40
4.5.7 RS232 Driver.........................................................................................................40
4.5.8 Software Application Notes ...................................................................................40
5INSTALLATION...................................................................................................................41
5.1 SIM CARD INSTALLATION.................................................................................................41
5.1.1 Open Cover ...........................................................................................................41
5.1.2 Insert SIM ..............................................................................................................42
5.1.3 Close Cover...........................................................................................................42
5.2 ANTENNA INSTALLATION ..................................................................................................43
5.2.1 Location.................................................................................................................43
5.2.2 Antenna Tuning .....................................................................................................43
5.2.3 Antenna Cable Routing .........................................................................................43
5.3 POWER AND SIGNAL CONNECTION...................................................................................43
5.4 CHOOSING A LOCATION ...................................................................................................44
5.5 MOUNTING THE UNIT .......................................................................................................44
5.6 ANTENNA CONNECTOR PROTECTION................................................................................44
6TECHNICAL DATA SUMMARY..........................................................................................46
7OWA23X FIRMWARE ADVANCED CONFIGURATION....................................................50
7.1 ETHERNET......................................................................................................................50
7.1.1 Ethernet interface activation..................................................................................50
7.1.2 Ethernet interface deactivation..............................................................................52
7.2 ROUTING AND FIREWALL TOOLS.......................................................................................52
7.3 REMOTE FIRMWARE UPGRADE.........................................................................................53
8REFERENCES.....................................................................................................................54

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
v
Index of Figures
Figure 3.2.1 Development board physical description .................................................................... 6
Figure 4.1.1 owa23X Physical description ..................................................................................... 14
Figure 4.2.1.1Memory arrangement.............................................................................................. 15
Figure 4.2.1.1 . 30 Pin Mating Connector with cable..................................................................... 17
Figure 4.2.1.2 . 30 Pin Connector pin functions............................................................................. 17
Figure 4.2.7.2 Digital output typical loads .....................................................................................19
Figure 4.2.7.3 Driving loads from user supply .............................................................................. 20
Figure 4.2.12.1 Adapting sensors to Analog Inputs....................................................................... 21
Figure 4.2.12.1 owa23X RS485 bus................................................................................................22
Figure 4.2.19.2.1 Battery back-up installation. ............................................................................. 27
Figure 4.3.1 Functional states. ...................................................................................................... 30
Figure 4.5.1.1 owa23X Software structure .................................................................................... 35
Figure 4.5.1.3.1 File system structure........................................................................................... 35
Figure 4.5.2.1 User hard disk structure ........................................................................................ 36
Figure 5.1.1.1 Opening front cover ................................................................................................ 41
Figure 5.1.2.1 Inserting SIM........................................................................................................... 42
Figure 5.1.3.1 Latches.................................................................................................................... 42
Figure 5.6.1 Protecting antenna connectors ................................................................................. 45
Index of Tables
Table 2.3.1 owa23X Models Table.................................................................................................... 5
Table 2.4.1 Abbreviations list........................................................................................................... 5
Table 3.2.1 Development board connectors list.............................................................................. 7
Table 3.2.2 Development board J4 pin out ...................................................................................... 7
Table 3.2.3 Development board J5 pin out ...................................................................................... 8
Table 3.2.2.1 Development board LED, switch and pot description................................................ 8
Table 4.2.2.1.1 GSM antenna connector ........................................................................................ 16
Table 4.2.3.11 GPS antenna connector.......................................................................................... 16
Table 4.2.4.1 30 Pin connector pin functions................................................................................. 17
Table 4.2.5.1 Power supply connector pins function..................................................................... 18
Table 4.2.5.1 Digital I/O pin out...................................................................................................... 18
Table 4.2.5.1 Digital I/O signal levels............................................................................................. 19
Table 4.2.5.2 Cross Platform I/O signal mapping.......................................................................... 20
Table 4.2.5.1 Analog Inputs............................................................................................................ 21
Table 4.2.5.1 CAN pin out............................................................................................................... 22
Table 4.2.5.1 RS485 pin out............................................................................................................ 22
Table 4.2.5.1 RS232 pin out............................................................................................................ 22
Table 4.2.5.1 Audio pin out............................................................................................................. 23
Table 4.2.5.1 Ethernet pin out........................................................................................................24
Table 4.2.16.1 owa21I-ETH: Yellow LED indications ..................................................................... 24
Table 4.2.16.2 owa21I-ETH: Green LED indications ...................................................................... 24
Table 4.2.17.1 owa23X Green LED indications............................................................................... 24
Table 4.2.172 owa23X Yellow LED indications............................................................................... 25
Table 4.2.17.3 owa23X Orange LED indications............................................................................. 25
Table 4.3.1 owa23X Functional states............................................................................................ 30
Table 4.4.1.4 Dedicated internal battery duration......................................................................... 32
Table 4.4.2 Power consumption..................................................................................................... 34
Table 6.1 General specification...................................................................................................... 46
Table 6.2 Mechanical description .................................................................................................. 46

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
vi
Table 6.3 Power interface .............................................................................................................. 46
Table 6.4 GSM/GPRS specifications............................................................................................... 47
Table 6.5 Ethernet specifications .................................................................................................. 47
Table 6.6 GPS specifications..........................................................................................................48
Table 6.7 Environmental specifications......................................................................................... 49
Table 6.8 Battery backup ............................................................................................................... 49

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
1
1 Safety and other precautions
1.1 General
IMPORTANT: FOR THE EFFICIENT AND SAFE OPERATION OF YOUR owa23X
DEVICE, READ THIS INFORMATION BEFORE USE!
Care must be taken when handling the unit. It must not be dropped or exposed
to excessive heat.
Only authorized staff can disassemble the product.The product may be opened
to install the SIM card OBSERVING the ESD precautions described in this
document. Otherwise if the product was disassembled by non-authorized
people, and/or no ESD precautions are taken the warranty is no longer valid.
Do not force objects into the joints around the cover. This may damage the
seals. Only use the specified tools to open the unit.
If the product is exposed to severe conditions beyond the limits specified in
Environmental Specifications, the product could be damaged.
Keep the device away from radiators and heat sources.
Do not clean the device when powered. Clean it with a damp soft cloth, and do
not use solvents.
1.2 owa23X Connections
The highest internal voltage applied to the owa23X unit can be 40Vdc and
complies with low voltage European directive (See Chapter 4.2.5 Power Supply).
The power supply can be made with a battery or continuous voltage supply with
reinforced isolation, and limited in power to a maximum of 8 A and 100 VA.
Before you connect the device to a power supply, check the voltage and current
rating to ensure that the required ones match the available power source.
Exceeding the specified input range may cause unexpected operation and/or
irreversible damage to owa23X.
To remove the device from all power sources turn the device off and disconnect
it from the power supply.
Be sure that nothing rests on the connected cables and that the cables are not
located where they can be tripped over or stepped on.
Applying loads outside of the range specified may result in unintended
operation and/or possible permanent damage to owa23X. Read section 4.2.7
carefully before connecting any load to the outputs. If there is any uncertainty,
please contact owasys Customer Support.
1.3 EMC Instructions
Use shielded signal cables to ensure that you maintain the appropriate EMC
classification for the intended environment.
Keep cables as short as possible, lengths not longer than 3 meters are
recommended.
1.4 Exposure to RF Energy
Minimize RF energy exposure by limiting the duration of GSM calls and
operating the unit efficiently.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
2
The antenna must be mounted in such a position that no part of the human body
rests close to any part of the antenna.
The product is intended to be used with an external GSM antenna, located at
least at 20 cm. away from any part of the human body. Those installations not
complying with this statement are responsible for providing SAR measurement
reports and corresponding declaration.
Do not hold the antenna during a call since it affects call quality and can cause
the module to operate at a higher power level than needed.
1.5 Antenna Care and Replacement.
Do not use the product with a damaged antenna because when the antenna
comes into contact with the skin, a minor burn may result. Replace the antenna
immediately.
Use only antennas that are according to the technical specifications. Antennas
that do not fulfil the specifications could damage the product and may
contravene local RF emissions regulations or invalidate type approval.
1.6 Electronic Devices
Most electronic devices are shielded from RF energy. However RF energy may
cause some malfunctioning of improperly shielded electronic devices.
When the product is mounted in a vehicle, check your vehicle to determine that
all on board electronic equipment is adequately shielded from RF energy.
In the same way, when the product is in the proximity of medical devices
(hospitals, etc) check with the manufacturer of medical equipment to determine
if they are properly shielded.
This equipment should never be operated on an aircraft.
1.7 Blasting Areas
To avoid interfering with blasting operations, turn the unit OFF in these kinds of
areas or in areas ported “turn off your two way radio”.
Construction crew often uses remote control RF devices to set off explosives.
1.8 Children
Do not allow children to play with owa23X. It is not a toy and they could hurt
themselves or others. Children could also damage the unit.
1.9 Explosive Atmospheres
Do not operate this product in environments containing explosive materials or
vapour. This includes petrol service stations.
The unit accessories could generate sparks that can cause an explosion or fire
resulting in bodily injury or even death.
To avoid interfering with blasting operations, turn the unit off in areas posted
“blasting area”.
Do not transport or store flammable gas, liquid or explosives, in the
compartment of your vehicle which contains owa23X or its accessories.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
3
1.10 Handling the Device
Observe the following safe-handling guidelines to prevent damage to owa23X:
When setting up the device for work, place it on a flat level surface.
Protect the device from environmental hazards such as extreme
temperatures and overexposure to sunlight.
When you move your device between environments with very
different temperature and/or humidity ranges, condensation may
form on or within the device. To avoid damaging it, allow sufficient
time for the moisture to evaporate before using the device.
When taking the device from low-temperature conditions into a
warmer environment or from high-temperature conditions into a
cooler environment, allow the device to acclimate to room
temperature before turning on power.
When disconnecting a cable, pull on its connector or on its strain-
relief loop, not on the cable itself. As you pull out the connector,
keep it evenly aligned to avoid bending any connector pins. Also,
before you connect a cable make sure both connectors are correctly
oriented and aligned.
When opening the device to insert the SIM card, ensure that the
device is dry so that moisture doen not enter. The unit contains ESD
sensative electronics so follow appropriate ESD precautions.
1.11 For owa23X/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,
always respecting the environmental regulations in place.
The battery poses a burn hazard if you handle it improperly. So do not
disassemble or handle it. If the battery is damaged, electrolyte may leak from
the cells and may cause personal injury.
Keep the battery away form children.
When the battery is heated to excessive temperatures (above 60ºC), its cells
could explode or vent, posing a risk of fire.
To maximise the battery capacity, it is recommendable to use it at room
temperatures. At lower temperatures the battery life is reduced.
Turn the equipment OFF always before removing or replacing the battery.
1.12 Accessories
Use only accessories that are compatible with your owa23X equipment, and
recommended by owasys. Using inappropriate accessories can generate health
risks or can damage the equipment because of incompatible devices and
guarantee will not be valid.
There may be a risk of explosion if battery is replaced by an incorrect type.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
4
2 Introduction
2.1 Overview
The owa23X Integrators Manual describes how to install, set up, and configure
owa23X Platform products. This platform covers the products described in
chapter2.3.
This document focuses on the explanation of the basic operation that is
common to all of the owa23X devices. Whenever a feature is supported by the
whole owa23X family, model is referred as owa23X.
All the devices are provided with a small dedicated internal battery for RTC
back-up and owa23Amodels are also provided with GPS data backup. In
addition to this, the devices can be provided with high capacity internal battery
backup as an option. In this case, the products are labelled with a “/b” at the
end, e.g.: owa23A/b. The high capacity battery can also be supplied separately
(POP 100 2100).
This first section provides a brief overview of the products followed by a
“Getting Started” chapter. Further sections go into more detail on the hardware
specifications and various firmware functions available to the development of
the user application. Application notes, technical specifications,
troubleshooting, and a peripheral devices reference, complete this manual.
2.2 What is the owa23X Platform
The owa23X range of products provides a powerful platform for management of
geographically distributed equipment. The owa23x units integrate a GSM/GPRS
communication system with embedded IP functionality, allowing an efficient
and bi-directional transmission of information across the cellular wireless
network. Additionally, the owa23A unit includes a GPS receiver for reception of
positioning information.
The basic features that are common to this family of products are:
GSM-GPRS, quad–band (GSM850-900-1800-1900).
GPRS Class B, Class 10 (4+2) system and 07.10.
Stack TCP/IP for transparent Internet connection.
User-friendly programming environment with a complete set of APIs.
Extensive range of external serial interfaces, digital and analog I/Os.
Additionally, different models may include specific hardware or functionality:
GPS, 16 channel
CAN
Audio interface for speaker and microphone
Ethernet 10baseT

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
5
2.3 owa23X Models
Note: the standard model is owa23A-CAN. Other models are only available for special orders.
Please contact your distributor for more information.
Product Code Name CAN GPS 30 Way Connector Pin Options
A3 B3 D3 E3
POP 100 3000#01 owa23A • MICP MICN SPKP SPKN
POP 100 3001#01 owa23I MICP MICN SPKP SPKN
POP 100 3002#01 owa23A-CAN • • MICP MICN SPKP SPKN
POP 100 3010#01 owa23A-ETH • ETH-RX+ ETH-RX- ETH-TX+ ETH-TX-
POP 100 3011#01 owa23I-ETH ETH-RX+ ETH-RX- ETH-TX+ ETH-TX-
POP 100 3012#01 owa23A-ETH-CAN • • ETH-RX+ ETH-RX- ETH-TX+ ETH-TX-
Table 2.3.1 owa23X Models Table
2.4 Abbreviations
API Application Programming Interface
CEP Circular Error Probability
CPU Central Processing Unit
CTS Clear to Send
DCD Data Carrier Detect
DSR Data Send Ready
DTE Data Terminal Equipment
DTR Data Terminal Ready
GND Ground
GPIO Generl Purpose Input Output
GPRS General Packet Radio Service
GPS Global Positioning System
GSM Global System Mobile
HW Hardware
MIPS Millions of Instructions Per Second
MMU Memory Management Unit
NA Not Available
NC Not Connected
O&M Operation and Maintenance
OS Operating system
PWM Pulse Width Modulation
RI Ring Indicator
RTC Real Time Clock
RTS Request to Send
RX Reception
SAR Specific Absorption Rate
SIM Subscriber Identity Module
SMS Short Message System
SW Software
TTY TeleType Writer
TX Transmission
USB Universal Serial Bus
VSWR Voltage Standing Wave Ratio
Table 2.4.1 Abbreviations list

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
6
2.5 Notes, Warnings and ESD
Notes – Provides additional information about the products. It normally shows
the difference between the owa2X family products.
Warning – Alerts you to situations that could cause hardware damage or
software error.
ESD – Alerts you to parts that are sensitive to electrostatic discharge damage.
In these cases the product must be handled in appropriate ESD safe conditions,
3 Getting Started with the Development Kit
3.1 Introduction
This section explains the steps to install and configure the development kit and
begin with the setup of the customer application. The development kit offers
the possibility of testing the developed applications and easy control and test of
the owa23X interfaces.
This section starts with a description of the development board and then with
the steps for mounting and connecting the kit, and then the software set up
procedure.
3.2 Development Board Description
Following figure shows the layout of the Development Board:
Figure 3.2.1 Development board physical description

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
7
3.2.1 Development Board Connectors
Number Connector
X3 Power Supply DC Jack.
J1 Screw Terminal for owa23 row A
J2 Screw Terminal for owa23 row B
J3 Screw Terminal for owa23 row C
J4 Signals for external use.
J5 DB9 for RS232 on UART0 (note: null modem pinout)
J6 Speaker output (for headset).
J7 Microphone input (for headset).
J8 Ethernet jack.
Table 3.2.1 Development board connectors list
J1, J2 and J3 are for connecting to the owa23X. Connect the cable as shown in
section 4.2.4.
Power can be connected either to X3, or pins 10 (+VIN)
and 9 (GND) of J4. For connecting power to X3, ensure
that the positive pin is in the centre, and ground is on the
outer conductor, as follows:
J4 provides screw terminal connections for the various signals on the
development board. Pin-outs are as follows:
Pin Signal Function
J4-1 CAN0H CAN bus 0
J4-2 CAN0L CAN bus 0
J4-3 RS485A RS485 bus
J4-4 RS485B RS485 bus
J4-5 ADIN1 Analog input 1
J4-6 ADIN0 Analog input 0
J4-7 VOUT 4.5V supply output (max 100mA)
J4-8 ON/OFF ON/OFF input (low = OFF)
J4-9 GND Ground
J4-10 VIN Positive power input (6-40 VDC)
Table 3.2.2 Development board J4 pin out
If using external signals for ADIN0 or ADIN1, then leave the switches SW1-1,
SW1-2, SW1-3 and SW1-4 in the OFF position.
Note: do not draw more than 50mA from the 4V5 output as this is also powering
other items on the development board.
If using external signals for I/O-0 to I/O-7, then leave the switches SW2 & SW3
in the OFF position.
J5 provides a DB9 connection for UART0 RS232. J5 has the following pin out.
Note that this is a null modem pinout and must be used with the cable supplied
in the development kit.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
8
Pin Signal Function
J5-1 - -
J5-2 RX RS232 Tx
J5-3 TX RS232 Rx
J5-4 - -
J5-5 GND Ground
J5-6 - -
J5-7 RTS RS232 RTS
J5-8 CTS RS232 CTS
J5-9 - -
Table 3.2.3 Development board J5 pin out
Note that to use RS485 or CAN, a 120Ωtermination resistor must be placed at
each end of the network. One of them may be mounted by inserting a 120Ω
leaded resistor in terminals 1 & 2 or 3 & 4 of J4. The other termination resistor
must be mounted at the other end of the network.
3.2.2 Development Board LEDs, Switches & Pots
Following table shows the LED indicators, Switches and Potentiometers on the
Development Board. The LEDs enable monitoring of the various supplies and
outputs, and the switches and pots enable activation of the various inputs.
LED Description
I/O-0..I/O-7 ON when outputs 0 to 7 are activated.
VOUT Indicates that 4.5V supply is available.
VIN Indicates VIN power is applied.
Switch Description
SW1-1 Connect ADIN0 to light dependent resistor LDR.
SW1-2 Connect ADIN1 to temperature sensor TEMP.
SW1-3 Connect ADIN0 to potentiometer RV1.
SW1-4 Connect ADIN1 to potentiometer RV2.
SW2-1..4 Activate inputs 0 to 3 (note active = input low).
SW3-1..4 Activate inputs 4 to 7 (note active = input low).
Pot Description
RV1 Adjust voltage for ADIN0 (when SW1-3 selected).
RV2 Adjust voltage for ADIN1 (when SW1-4 selected).
Table 3.2.2.1 Development board LED, switch and pot description
Do not select both the LDR and RV1 on SW1 or the measurement on ADIN0 will
not be correct. The same applies to TEMP and RV2 for ADIN1.
Note: SW2 and SW3 pull the I/O pins to ground, so the LEDs will be ON.
3.3 Mounting the owa23X Development Kit
The steps for mounting the components in owa23X are the following:
GSM & GPS Antenna: Connect the antenna supplied by following the colour
coding and/or labels.
RS-232 Serial cable: This cable is a null-modem type. It should be connected to
the RS-232 DB9 connector in the developer’s board. The other end of the cable
should be connected to a personal computer.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
9
Multipurpose connector cable: This connector carries power and I/O signals.
The 30 pins in this connector should be supplied pre-connected to the
development kit, but if not then follow the pin-out in section 4.2.4 to connect the
30 wires to J1, J2 and J3 on the development kit.
AC/DC Power supply: The provided AC/DC power supply adaptor can be
connected to developers board connector X3, and to a suitable AC main outlet.
Alternatively a laboratory power supply can be connected to pins 10 (+VIN) and
9 (GND) of J2 connector. In this case set the voltage to 12V and the current limit
to 2A.
SIM card: See section 5.1 for details on how to install the SIM card.
Ethernet Cable: If your owa23X has the ETH option, then connect the Ethernet
Cable between the personal computer and the Ehernet connector RJ45 one the
development kit. The supplied cable is cross connected.
3.4 Development Kit Software Set Up
Instructions found in the remainder of this chapter show how to configure the
owa23X unit using the provided files in the development kit CD. The
Development Kit CD includes the following software:
The necessary files to install a cross compiler for ARM that
contains the header files of the APIs.
Demo application notes (source files, header files and makefiles).
Current firmware version (boot, kernel and file system SW)
The PC requirements for using the offered applications are (as follows):
Linux Operating System (min. Kernel 2.4.18 recommended)
Free disk space (minimum needed): 0.5GBytes
Linux Development tools installed according to the customer’s
preferences, as KDeveloper (or similar).
Note - To develop applications for the owa23X platform the user
must have knowledge of programming in C and the Linux
environment.
3.4.1 Installing and Using the Cross Compiler
In order to help the integrator, a compiler is included in the Development Kit
CD. The cross compiler allows the developer to easily create binary files that
can be directly executed in owa23X. In order to install the ARM cross compiler,
follow the steps listed below.
Copy the content of the
/crosscompiler directory to your PC.
Login as root.
Run the install script:
./install.sh to install the cross compiler in
/usr/local/arm/[version]/ automatically.
Include in the
/etc/profile file the following line:
PATH=$PATH:/usr/local/arm/[version]/bin .
Reboot the machine.
[version] must be replaced for the current version number of the
compiler you will find in the CD.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
10
To know more about how to use the cross compiler go to help that will
print all available functions.
$arm-linux-gcc --help
It is recommended to use the compiler included in the CD, or provided by
owasys.This compiler is a standard GNU tool available in the web, and although
it is possible to use other appropriate compilers (adapted to owa23X micro and
with the required header files of the APIs), owasys is not responsible for
possible compilation errors or any other malfunction.
Changes in owa2x firmware, due to SW improvements etc, may require a new
version of the cross compiler to be installed. If that is the case the previous
version should be removed from the system.
For uninstalling the cross compiler:
Remove all cross compiler files,
rm –rfv /usr/local/arm
From
/etc/profile file remove the following line
PATH=$PATH:/usr/local/arm/[version]/bin.
3.5 Connecting owa23X to a PC
Either Linux OS or Windows OS can be used to connect to the device from a
Personal Computer (PC) through serial port. The required configuration
parameters are the following:
Bit Rate: 115200 bps
Data Bits: 8
Parity: none
Bit Stop: 1
Flow Control: None
Note that a null modem cable as supplied in the DK should be used.
3.5.1 Ways of Booting
In the “normal” booting process, after switching on the device, the boot loader
starts to decompress the file system and kernel from Flash memory and store
it to RAM memory. While doing this operation, the system sends through the
RS232 DB-9 connector (ref. 3 of fig. 3.3.1.1) the message: “Booting…” . At the
end of this process the system asks the user for a login and password.
Booting process can be modified by pressing and holding the ENTER key during
switch ON of the device. The boot loader then stops in commands mode, with
the prompt:
bootloader%% . The allowed commands are:

boot : The system boots in the “normal” way.

bootl1 : The system boots in the “normal” way but in verbose mode
so that system messages are sent to serial port

bootl2 : The system boots, but skipping the copy of /home/@sysinit
directory. See section 7 for further details.

reboot : The system reboots again. It is useful when upgrading
bootloader code, so that a power cycle is not needed for the new
boot code to be executed.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
11

erasejffs : Utility to format the Flash memory. Be careful, as all the
contents of the Flash memory (everything stored under
/home
directory) will be erased.

loadx [boot, kernel, ramdisk] : Utility to download new bootloader,
kernel or filesystem respectively. See 3.5.4 for further details
If no command is issued at the prompt
Bootloader%% , the device will stay in
this situation for a maximum of 30 minutes. Then, it will continue with the
normal boot sequence.
3.5.2 Windows HyperTerminal
Use Windows HyperTerminal to connect owa23X to the PC configuring the
serial port parameters to the values indicated in section 3.5.
Switch on the owa23X. Once the File System and Kernel are loaded in RAM
memory, the device waits for the user to enter a valid user name to log in. This
user name is
root and it has no password.
Once logged in, the user is in the owa23X file system which has the directory
structure described in section 4.5.1.3. As stated in that section, user
applications should be stored under
/home directory, in a non-volatile memory.
Any other directory outside
/home uses volatile RAM memory and should be
preferred to store dynamic data.
To transfer a file from the PC to the owa23X, change to
/home directory or to
the directory where the file is to be stored (
cd /home or cd /directory_name ),
type
lrz command and choose Transfer-> Send File… option of the
HyperTerminal and zmodem protocol.
To transfer a file from the device to the PC, change to the directory where the
file is, then type
lsz command indicating the name of the file ( lsz file_name ) and
choose the
Transfer -> Receive File… option of the HyperTerminal. File
transfer protocol is zmodem in both cases.
When a file is transferred using Windows HyperTerminal, the file permissions
are modified automatically. To revert to the proper file permissions inside the
owa22X, use the command:

chmod a+x file_name (for executing permissions).

chmod a+r file_name (for reading permissions).

chmod a+w file_name (for writing permissions).
3.5.3 Linux Minicom
Run the minicom program and configure the serial port parameters to the
values indicated in section 3.5.
Minicom help is shown by typing Ctrl-A Z.
Serial port device files
(/dev/ttyS0, /dev/ttyS1 …) must have reading and writing
permissions for all users. Log in as root and type
chmod a+rw /dev/ttySx to
change permissions
Switch on the owa23X and wait until login prompt appears. Log in as
root user
with no password to enter into the device Operating system. The directory
structure is described in section 4.5.1.3.
To transfer a file from the local PC to the device, change to
/home directory (or
to the directory where the file is to be stored), type
lrz command in owa23X OS,
type
Contol-A S so that the minicom knows the file that is to be transferred. The
file transfer protocol is zmodem.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
12
To transfer a file from the device to the local PC, change to the directory where
the file to be transferred is stored, type lsz command indicating the name of the
file (
lsz file_name ) and type Control-A R so that the minicom starts to receive
the file. The file transfer protocol is also zmodem.
3.5.4 Updating owa23X Boot loader, Kernel or File system
This operation can be carried out only with firmware (Boot loader, Kernel and
File System) provided and authorized by owasys.
Connect the owa23X to the local PC using Linux OS (See section 3.5.3) or
Windows OS (See section 3.5.2). Turn on the unit and press return key within 2
seconds after, so that the boot loader enters in command mode.
To update the boot loader type
loadx boot command choosing the boot
loader file provided by owasys. The transfer protocol must be xmodem.
To update the kernel type
loadx kernel command choosing the kernel file
provided by owasys. The transfer protocol must be xmodem.
To update the file system type
loadx ramdisk choosing the file system
provided by owasys. The transfer protocol is also xmodem.
3.6 Download a Demo Application
Some Applications Notes are included in the Development Kit CD as simple
examples that may help in testing owa23X features. In this section we will
explain how to download an application into the owa23X File System, and how to
run it. This application will in the future be the customer application, following
the steps described in chapter 4.5.3.
Download the application into the device as explained in sections 3.5.2 and
3.5.3. Once we are sure it has execution permissions, the application can be run
directly from the console. Just type
./home/owaANX
In case you want owa23X to run the application with neither need to log-in nor
having to type anything, there’s a straightforward way to achieve this. There is a
special configuration script named
userinit.sh that should include the
commands to be executed. The
userinit.sh file must have execution permission.
For example:
#!/bin/sh
/home/owaANX
The first line tells the system which shell is used to parse the commands. The
next one runs the application note owaANX.
The
userinit.sh file must always be stored in /home directory. This file can be
created on a PC and transferred to owa23X, or created directly in the device
with
cat command ( cat > userinit.sh ).
It is better to edit this file inside the owa23X, because some editors, such as
Windows Wordpad, insert some end file characters that can not be translated
by Linux.
To change the permissions of this file type use the following command:
chmod a+x userinit.sh
From now on, userinit.sh script will be automatically executed every time the
system boots, with no login prompt. To end this application and return to the
system, use CTRL+C.

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
13
You may also choose to run the application in background, by adding an
ampersand
#!/bin/sh
/home/owaANX
&
Some applications can not be run in background mode because the user must
enter some parameters through the keyboard during the execution of this
program. When executing a program in the background, the control of the
terminal is recovered immediately and the standard output and error output
must be addressed to files.
Now you are ready to start developing your own applications!

owa23X Platform Integrator’s Manual
BOK-100 1065-C-owa23X Platform Integrator's Manual
14
4 owa23X Description
4.1 owa23X Physical Description
Figure 4.1.1 owa23X Physical description