iXBlue Octans User manual

AHRS
Advanced Configuration
User Guide

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 1
Document Revision History
Edition Date Comments
A 09/2011 First Edition
B 03/2012 iXBlue graphical chart applied to the document
C 01/2015 OCTANS NANO product added
Appendice B added
D 03/2015 New style guide updated to the document
E 11/2015 Input and output protocols lists updated

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 2
Copyright
All rights reserved. No part of this manual may be reproduced or transmitted, in any form
or by any means, whether electronic, printed manual or otherwise, including but not
limited to photocopying, recording or information storage and retrieval systems, for any
purpose without prior written permission of iXBlue.
Disclaimer
iXBlue specifically disclaims all warranties, either expressed or implied, included but not
limited to implied warranties of merchantability and fitness for a particular purpose with
respect to this product and documentation. iXBlue reserves the right to revise or make
changes or improvments to this product or documentation at any time without notify any
person of such revision or improvments.
In no event shall iXBlue be liable for any consequential or incidental damages, including
but not limited to loss of business profits or any commercial damages, arising out of the
use of this product.
Trademarks
Microsoft, MS-DOS and Windows are registered trademarks of Microsoft Corporation.
Intel and Pentium are registered trademarks and Celeron is a trademark of Intel
Corporation.

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 3
Text Usage
bold
Bold text is used for items you must select or click in the
software. It is also used for the field names used into the dialog
box.
Courier
Text in this font denotes text or characters that you should enter
from the keyboard, the proper names of disk Drives, paths,
directories, programs, functions, filenames and extensions.
italic
Italic text is the result of an action in the procedures.
Icons
The Note icon indicates that the following information is of particular interest and should
be read with care.
Important
The Important mention indicates that the following information should be read to forbid or
prevent a product dysfunction or a faulty operation of the equipment.
The Caution icon indicates that the following information should be read to forbid or
prevent product damage.
The Warning icon indicates that possible personal injury or death could result from failure
to follow the provided recommendation.
Abbreviations and Acronyms
Abbreviations and acronyms are described in document Inertial Products - Principle &
Conventions (Ref.: MU-INS&AHRS-AN-003).

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 4
Overview of this Document
This document is the Advanced Configuration User Guide for the Attitude and Heading
Reference Sensor (AHRS). This document is a part of the set of documentation provided
with the AHRS. The set of documentation must be read and understood prior to using the
AHRS.
The manufacturer shall in no case be held liable for any application or use that does not
comply with the stipulations in this guide.
AHRS – Advanced Configuration - User Guide is divided into several parts:
•Part 1: Introduction – This part introduces the commands describes in this user
guide.
•Part 2: Version of Products Concerned – This part lists all the products and the
firmware version associated to which this user guide applies. This section lists the
availability of the commands depending on the products.
•Part 3: General Conventions – This part describes command syntax and how to send
and receive commands.
•Part 4: General System Configuration – This part lists the available commands to
configure the AHRS.
•Part 5: Interfaces Configuration – This part describes commands to configure serial
or Ethernet ports and analog Inputs and Outputs (I/O).
•Part 6: Dynamic String Retrieve Commands: This part describes commands to
retrieve all configuration strings to dynamically get firmware feature list.
•Appendix A: NMEA Checksum Web Page – This appendix gives a mean to calculate
the checksum (“hh” parameter) required in all transmitted sentences.
•Appendix B: Factory Setting Details – This appendix details the factory default
settings.
A Table of Contents is available in the following pages to allow a quick access to
dedicated information.

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 5
Table of Contents
1INTRODUCTION..............................................................................................................6
2VERSION AND PRODUCTS CONCERNED ..........................................................................7
3GENERAL CONVENTIONS ...............................................................................................8
3.1 COMMAND SYNTAX .....................................................................................................................8
3.2 HOW TO SEND AND RECEIVE COMMANDS.....................................................................................8
4GENERAL SYSTEM CONFIGURATION...............................................................................9
4.1 SAVE TO EEPROM.....................................................................................................................9
4.2 SOFTWARE SYSTEM REBOOT ......................................................................................................9
4.3 WEB MMI PASSWORDS RESET....................................................................................................9
4.4 MANUAL POSITION AND SPEEDS..................................................................................................9
4.5 AXIS ORIENTATION....................................................................................................................10
4.6 HEADING,ROLL AND PITCH ANGULAR OFFSETS..........................................................................12
4.7 MAIN LEVER ARM .....................................................................................................................13
4.8 SECONDARY LEVER ARMS ........................................................................................................13
4.9 CENTER OF GRAVITY POSITION..................................................................................................13
4.10 HEAVE PARAMETERS ................................................................................................................14
4.11 UTC (TIME SYNCHRONIZATION)INTERFACE ...............................................................................14
5INTERFACES CONFIGURATION......................................................................................15
5.1 PORT MAPPING AND ID..............................................................................................................15
5.2 SERIAL AND ETHERNET COMMANDS ..........................................................................................16
5.2.1 Serial I/O General Parameters (Parity, Stop Bit, Level, Baudrate)....................................16
5.2.2 Serial/Ethernet Input Port Configuration............................................................................17
5.2.3 User Defined Output Protocol............................................................................................18
5.2.4 Serial/Ethernet Output Port Configuration.........................................................................18
5.2.5Output Device Selection ....................................................................................................20
5.2.6 Input Device Selection.......................................................................................................20
5.3 ETHERNET CONFIGURATION ......................................................................................................21
5.3.1 Network Setup Command..................................................................................................21
5.3.2 IP Output Configuration .....................................................................................................21
5.3.3 IP Input Configuration........................................................................................................22
5.4 PULSES INTERFACES.................................................................................................................23
5.4.1 Input Pulses .......................................................................................................................23
5.4.2 Output Pulses ....................................................................................................................23
6DYNAMIC STRING RETRIEVE COMMANDS......................................................................24
6.1 GENERIC TEXT RETRIEVE COMMAND .........................................................................................24
APPENDICES.....................................................................................................................26
ANMEA CHECKSUM WEB PAGE ....................................................................................26
BORIENTATION AND SIGN CONVENTIONS RECALL ............................................................27
CFACTORY SETTING DETAILS.........................................................................................28

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 6
1 INTRODUCTION
This document describes the Attitude and Heading Reference Sensor (AHRS)
configuration and monitoring commands which can be used during operation. These
commands are sent directly through the repeater port to check settings and modify AHRS
or external sensors configuration (depending of the external sensor and of the AHRS
capabilities), to reset the unit, and save the configuration to PROM.
Full configuration of the AHRS, prior to operation, requires the use of the Web-based User
Interface.
However, commands described below are exactly equivalent to the ones which are sent
by the Web-based User Interface. They may be useful when launching and using the
Web-based User Interface during operation is not possible.

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 7
2 VERSION AND PRODUCTS CONCERNED
The current edition of this document is applicable to the following 4th generation AHRS:
Table 1 – List of products and firmware
Product Firmware version
OCTANS higher than FrmWCINT_OCT_v3.87 version
OCTANS 3000
OCTANS NANO higher than FrmWCINT_INS_v5.64 version
Refer to section 6.1 to check the firmware version currently downloaded into your unit.
Several commands described in this manual are associated with specific external
sensors that may not be available on your product. Please, refer to your Product User
Manual to check which external sensors are available.
Contact iXBlue customer support to get the updated firmware version to be downloaded
into your system (see document: Inertial Products - General Information (Ref.: MU-
INS&AHRS-AN-007) for contact information).

AHRS - Advanced Configuration - User Guide
MU-AHRS-AN-002 Ed. E November 2015 8
3 GENERAL CONVENTIONS
3.1 Command Syntax
All frames are compatible with NMEA 0183 standard and are formatted as follows:
$CMD[,xxx,…,…y*hh<CR><LF> for configuration commands
$PHTXT,CMD[,xxx,…,..y]*hh<CR><LF> for configuration text retrieve commands
$ is a header and “CMD” depends on the command
Brackets [ ] indicates optional parameters, depending on the command. Most commands
can be used either to send configuration parameters “xxx,…,..y” to the system, or to ask
for the current value for the parameter. In such case, the “,xxx,…,..y” should be replaced
by “,,”.
“hh” is the checksum of the sentence, and allows for a control during the transmission. It is
calculated by exclusive-OR’ing (XOR) the 8 bits (no start bits or stop bits) of each
character in the sentence, excluding “$” and “*”. The hexadecimal value of the most
significant and least significant 4 bits of the result are converted to two ASCII (0-9, A-F) for
transmission. The most significant character is transmitted first.
The checksum field is required in all transmitted sentences. All frames should be ended by
the two characters <CR><LF> (0D 0A hexadecimal).
A Web based NMEA calculator is given in Appendix A to help computing checksums.
3.2 How to Send and Receive Commands
The AHRS will listen for COMMAND protocol on repeater port.
On repeater port, serial configuration is fixed and set to 19200 bauds, odd parity bit, 2
stop bits. Repeater port will also output OCTANS STANDARD protocol. Answers to
commands sent to this port will thus be mixed in OCTANS STANDARD output frames
(refer to AHRS Interface Library (Ref.: MU-AHRS-AN-003) for details).
If a command is not correctly formatted, the AHRS will ignore it and no answer will be
sent. If a parameter is out of allowed range, it will be ignored by the AHRS and set to
default value (0 or none). Thus, to confirm that a command was correctly handled by the
AHRS, the control application should systematically send the command to change a
parameter, and then send the read back command to check stored value. After all
changes are made, the application can send a SAVE command to store parameters in
non volatile memory inside the AHRS.