System integration ================== Supported sensors ----------------- .. rubric:: IMU * Applanix POSAV * Applanix AP+ * all GNSS sending NMEA * iXBlue AIRINS / ATLANS .. rubric:: Imaging sensors * ITRES * Nasa CWIS-II DCS * Phase One * Simplex * UltraCam .. rubric:: LiDAR * Riegl .. rubric:: Integrated systems * AISPECO - Robincop .. rubric:: Sensor mount platforms * SOMAG Version 1 * SOMAG Version 2 * Aerostab3 * SteadyTrack Setting up a list of SensorHandler integrated sensors ----------------------------------------------------- This chapter is intended for the system integrator only. The SensorHandler sensor list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Each button on the left of the SensorHandler panel represents a device being used. Right click on a button to add or remove a device from the list of devices. .. |ico1| image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 .. |ico2| image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 .. |ico3| image:: ../../pics/navigator/settings/NG_settings_number3.png :width: 22 .. |ico4| image:: ../../pics/navigator/settings/NG_settings_number4.png :width: 22 .. |ico5| image:: ../../pics/navigator/settings/NG_settings_number5.png :width: 22 .. |ico6| image:: ../../pics/navigator/settings/NG_settings_number6.png :width: 20 .. list-table:: :class: unbordered-table :widths: 35 65 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_sensor_handler_list.png - | | | |ico1| SensorHandler will communicate with Applanix to receive position information and to control the SOMAG platform and, optionally, to take an image. | | |ico2| SensorHandler will communicate to RiAcquire to start and stop scanning | | |ico3| In the settings the following information is stored: - location of the log files - location of the settings files | | |ico4| Definition of COM ports (not needed in Riegl configuration) | | |ico5| Definition of Ethernet ports used SensorHandler Ethernet settings ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the Ethernet settings dialog, set the IP address and port of each of the devices: .. image:: ../../pics/navigator/systemintegration/NG_ethernet.png Setting up a PhaseOne camera ---------------------------- By default, PhaseOne and iXCapture both run on the same computer (usually on an iXController). The operator thus can see the images taken (with iXCapture) while also seeing the navigation window of the flight. This default installation implicates that SensorHandler runs on the same machine. Some special installations are required to run iXCapture on a different machine than that of the navigation program. In this case, |Navigation Software name| and SensorHandler run on one machine and iXCapture on another. .. topic:: Adding PhaseOne into SensorHandler The PhaseOne handler needs to be visible in the sensor list. Right click on a free button and select PhaseOne sensor to populate the free button: .. image:: ../../pics/navigator/systemintegration/NG_phase_one.png :width: 200 .. topic:: Configuring the Ethernet settings Set the IP to the local address (127.0.0.1) and the port to 9569. This allows SensorHandler and iXCapture to exchange information on the images taken and on correct file names including the line and the image number. .. image:: ../../pics/navigator/systemintegration/NG_phase_one_ethernet.png :width: 600 .. topic:: Accessing the Phase One dialog #. | Click on the PhaseOne button in SensorHandler's main list of connected sensors to open the dialog box. Normally, this dialog does not need to be opened. However, it is useful for verifying correct system behavior. .. image:: ../../pics/navigator/systemintegration/NG_phase_one_dialog.png | |ico1| The symbol is colored green as soon as the camera is connected correctly and running. It sends the *system ready* message to SensorHandler. The symbol is colored red when there is no connection to the camera. | |ico2| The instant the camera takes an image, the red box around the lens changes to green for 0.4 seconds. Then it turns back to red. | |ico3| Click this button to ask if the system is ready. It shows system ready on the bar at the bottom of the dialog. | |ico4| In the default setting, an image will be released the instance the airplane passes the position where the image is to be taken. Optionally, images can be released at regular time intervals between the start and end of the line of flight (no images will be taken if the airplane is outside of the line of flight). | |ico5| This button can be pressed to manually release an image. This is often used to verify that the system is working correctly or to define the correct values for aperture and exposure time. | |ico6| Click on this button for more settings. | #. | **Use standard communication with iXCapture** This is the default option. It is used in standard installations where |Navigation Software name|, SensorHandler and iXCapture are installed on the same machine. | **Use TCP/IP bridge to remote iXCapture** This option is selected when |Navigation Software name|/SensorHandler are installed on a different computer than iXCapture. In this case, use the IP address of the remote computer on which IXCapture and iXBridge are running. .. image:: ../../pics/navigator/systemintegration/NG_standard.png .. topic:: Optional installing with iXBridge: iXCapture separate from SensorHandler | If iXCapture runs on a different computer than |Navigation Software name| / SensorHandler then SensorHandler needs to know the IP address of the computer on which iXCapture is running. Additionally, iXBridge software needs to run on the same computer as iXCapture. As its name suggests, iXBridge builds a bridge for commands between the navigator's computer and the computer on which iXCapture is running. | **Example** of such an integration: | On computer 1, TOPOFLIGHT |Navigation Software name| and SensorHandler are running. The GPS/IMU and an ITRES multispectral sensor are also connected to computer 1. | Computer 2 is used to control the PhaseOne camera(s) and to store the collected images. .. image:: ../../pics/navigator/systemintegration/NG_iXbridge.png :width: 600 | .. image:: ../../pics/navigator/systemintegration/NG_iXbridge1.png :width: 400 | #. **Settings of SensorHandler on computer 1** .. image:: ../../pics/navigator/systemintegration/NG_phase_one.png :width: 200 PhaseOne handler needs to be visible in SensorHandler's list of sensors: right click on a free button and select PhaseOne sensor to populate the free button. .. image:: ../../pics/navigator/systemintegration/NG_phase_one_ethernet2.png :width: 400 Set IP address of the remote computer on which iXCapture and iXBridge are running. Set the port to be used with iXBridge on the remote computer. By default, it is port 5000. #. | **Settings on computer 2** | The program iXBridge needs to be launched automatically at system start. It opens as a minimized dialog and is shown on the task list. When clicking on its icon, the following dialog appears: .. image:: ../../pics/navigator/systemintegration/NG_port.png :width: 600 .. list-table:: :class: unbordered-table :widths: 35 65 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_port1.png - | **Port for** iXCapture | This is the port through which data flows from SensorHandler to iXCapture (e.g. actual line deviation, image number). The default port is 9569. | **iP address of iXCapture** | This address is that of the computer on which iXCapture runs The address is usually 127.0.0.1 since iXBridge normally is installed on the same machine as iXCapture. | **Port for FMS** | This is the port defined in SensorHandler. Through this port, the remote SensorHandler and the local iXCapture communicate. Default port is 5000. #. A log file is written and saved in the windows temp folder. The log file is named in the form of ``iXBridgeYYMMDD-HHMM.txt``. The log file can be opened with Notepad by clicking on the **open log file** entry in the main menu. Riegl RiAcquire settings ------------------------ Settings in SensorHandler ^^^^^^^^^^^^^^^^^^^^^^^^^ .. rubric:: SensorHandler .. image:: ../../pics/navigator/systemintegration/NG_RiAquire.png .. list-table:: :class: unbordered-table :widths: 10 90 :header-rows: 0 * - .. image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 - | **Automatic mode:** This mode stops scanning at the end of a line of flight by setting the scanner to initialized mode. It starts scanning again at the beginning of the line the scanner is set to logging mode. | **Semi-automatic mode:** this mode switches between working and logging only. This option is recommended for the newest Riegl scanners and the following scanners: VQ-1560II, CVQ-1560I, LMS-Q1560, VQ-780i, VQ-780II, LMS-Q780 (all 1560 and 780 models). | **Manual mode:** In this mode the scanner won't stop logging at the end of the line. In fact, it continuously keeps scanning after the first start of logging on the first line. It can be started and stopped manually with RiAcquire. * - .. image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 - | If the airplane leaves the defined corridor the scanner will normally stop scanning by changing from logging to working mode. If the option *if outside corridor do not stop scanning* is set, then the scanner will keep scanning even outside of the corridor. | If the option *outside corridor do not stop taking images* is set the images will be taken even if the airplane is outside of the horizontal tolerance (corridor). .. rubric:: RiAcquire .. image:: ../../pics/navigator/systemintegration/NG_RiAquire1.png .. list-table:: :class: unbordered-table :widths: 10 90 :header-rows: 0 * - .. image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 - **Get devices from Riegl** can be selected as soon as the scanner has been connected. Both lists (scanners and cameras) will automatically be filled with the existing scanners and cameras. A Q1560 scanner typically has two scanners and one camera. By default, the scanner(s) and camera(s) are switched on, meaning that |Company name| controls the devices. * - .. image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 - **Automatic connection and disconnection** set the time limits of - when the scanner switches to working mode before the start of the line - when to change to working-logging mode before the start of the line - when to change to initialized mode after the end of the flight line Make sure to switch off *Release camera using RiAcquire* .. image:: ../../pics/navigator/systemintegration/NG_RiAquire2.png * - .. image:: ../../pics/navigator/settings/NG_settings_number3.png :width: 22 - To change any of the values above, the lock has to be opened. Click on the **black lock symbol** and use the password: *riegl* Settings for Image Takings in RiAcquire method 1 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: Standard method SensorHandler takes images through RiAcquire and NOT through Applanix: .. list-table:: :class: unbordered-table :widths: 40 60 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_IT_RiAquire1.png - The picture shows the default settings in the RiAcquire dialog. If the release camera is enabled SensorHandler will release the camera using RiAcquire. * - .. image:: ../../pics/navigator/systemintegration/NG_IT_RiAquire2.png - In the Applanix dialog, disable the option to take images through Applanix. * - .. image:: ../../pics/navigator/systemintegration/NG_IT_RiAquire3.png - In RiAcquire, set trigger mode to Manual Remote Control. Settings for Image Takings in RiAcquire method 2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: Alternative method SensorHandler takes images through Applanix POS and **NOT** through RiAcquire: .. list-table:: :class: unbordered-table :widths: 40 60 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_IT_AM_RiAquire1.png - If the release camera is disabled SensorHandler will NOT release the camera using RiAcquire. * - .. image:: ../../pics/navigator/systemintegration/NG_IT_AM_RiAquire2.png - In the Applanix dialog, enable the option to take images through Applanix. This means that SensorHandler will take images using Applanix POS commands. * - .. image:: ../../pics/navigator/systemintegration/NG_IT_AM_RiAquire3.png - In RiAcquire, set trigger mode to *External High*. Setting up Applanix POSAV ------------------------- Applanix POSAV in SensorHandler ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_Applanix_POSAV.png | .. list-table:: :class: unbordered-table :widths: 10 90 :header-rows: 0 * - .. image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 - | Set the Display Port, TCP Control Port, TCP Real Time Port | Ports 5605 and 5606 can only be used if the Applanix FMS option is installed * - .. image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 - | Use GPS and IMU Data for navigation. Position, speed and altitude will be read and sent to |Company name| |Navigation Software name|. | For special applications, the other options can be selected. * - .. image:: ../../pics/navigator/settings/NG_settings_number3.png :width: 22 - Switch this option to *ON* if you need to release images through Applanix. For UltraCam and Riegl scanners these options are usually not activated. * - .. image:: ../../pics/navigator/settings/NG_settings_number4.png :width: 22 - | If *ON*, the mount will be controlled through Applanix. **Default:** ON. | Follow mean track: the mount will be steered to match the ground track. | Follow desired heading: the mount will be steered on the planned angle of the flight line. * - .. image:: ../../pics/navigator/settings/NG_settings_number5.png :width: 22 - Switching *ON* this option will correct the received GPS ellipsoidal altitudes to get orthometric heights (heights on the geoid). **Default:** ON. Settings in Applanix POSView program ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Make sure the following settings are made in POSView Ethernet Real-Time Port 2: .. image:: ../../pics/navigator/systemintegration/NG_POSView.png :width: 550 Enable the following groups: * 1: Navigation solution * 3: Primary GNSS Data * 5: Event 1 * 200: Gimbal Encoder Data * 203: Gimbal Yaw Drift Correction Data * 222: Reference frame Navigation solution, only if you use direct control of the mount with the special handler for somag mount V2 (by default group 222 is not activated). .. image:: ../../pics/navigator/systemintegration/NG_somag.png :width: 200 | Store the settings in PosView: .. image:: ../../pics/navigator/systemintegration/NG_POSView1.png :width: 400 .. _Applanix-setup: Setting up Applanix AP+ ----------------------- SensorHandler needs two ports to communicate with Applanix AP+: * TCP/IP to get navigation data (it is usually defined as port 28001) * TCP/IP to get event information (it is usually defined as port 28002) Definition in web interface of Applanix AP+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Ports 28001 and 28002 are used. These are the default ports but other port numbers can also be used. .. image:: ../../pics/navigator/systemintegration/NG_Applanix_1.png .. rubric:: Definitions for navigation data (port 28001): .. image:: ../../pics/navigator/systemintegration/NG_Applanix_2.png .. rubric:: Definitions for event port (28002): .. image:: ../../pics/navigator/systemintegration/NG_Applanix_3.png :width: 800 Settings in SensorHandler ^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: Integrating Applanix AP+ in SensorHandler #. In SensorHandler, add IMU / Applanix AP+ to one of the buttons: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH1.png #. Click on Ethernet button to define the address and port of navigation data: .. image:: ../../pics/navigator/systemintegration/NG_ethernet_button.png #. In one of the combo boxes, select Applanix AP+. Enter the IP address of AP+. In this example it is *10.8.121.90*. Then set the port for receiving the navigation data: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH3.png #. Click on the Applanix AP+ button: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH4.png #. Tick the option to trigger images if Applanix is to trigger the images and enter the port number through which the event numbers will be received. .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH5.png :width: 600 #. Set the option Mount is controlled by Applanix if the mount is connected to Applanix AP+. In this case, do NOT define a special mount button in SensorHandler: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH6.png .. important:: | **Note for conducting Riegl scanners** | If the images will be released through the RiAcquire interface, then do **NOT** enable the Trigger images option: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH7.png :width: 250 Enable it in the RiAcquire dialog instead: .. image:: ../../pics/navigator/systemintegration/NG_Applanix_SH8.png :width: 500 Remarks for controlling a gyro mount ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_gyromount1.png | If the system is leveled using a mount, the corresponding option must be set. | The figure shows that the mount is switched to STAB mode 30 seconds before the start of the line. .. important:: The mount will only switch to STAB mode (unfreeze) when the aircraft is inside the corridor. | .. image:: ../../pics/navigator/systemintegration/NG_gyromount2.png The green box signifies that the mount is in MAN mode (freeze). The aircraft is outside the corridor, so the two buttons (set manually *ON*, set manually *OFF*) can be activated. .. image:: ../../pics/navigator/systemintegration/NG_gyromount3.png The green box signifies that the mount is in STAB mode (unfreeze). The aircraft is inside the corridor. Therefore, the two buttons (Set manually *ON*, set manually *OFF*) cannot be activated. .. list-table:: :class: unbordered-table :widths: 30 70 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_gyromount4.png - A prompt indication of whether the mount is in stabilization mode is provided through the icon displayed in the main window of the |Navigation Software name| program, see :ref:`Status of MNT - SOMAG Mount `. Setting up Applanix GSOF in AVX 210 ----------------------------------- Settings for GSOF in SensorHandler ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: Adjusting the settings in SensorHandler #. In SensorHandler, click on the **Ethernet** button to check IP address and port. .. image:: ../../pics/navigator/systemintegration/NG_ethernet_button.png #. | The standard IP address is ``192.168.53.100`` | The standard port for navigation data is ``5017`` .. image:: ../../pics/navigator/systemintegration/NG_GSOF1.png :width: 450 #. Open the GSOF dialog by clicking on the **IMU Applanix GSOF** button in SensorHandler. #. Then click the **Settings** button. .. image:: ../../pics/navigator/systemintegration/NG_GSOF2.png :width: 400 #. Adjust the settings: .. image:: ../../pics/navigator/systemintegration/NG_GSOF3.png :width: 400 |ico1| In the standard case navigation data from this IMU is used for navigation. So, for default settings, select the first option. |ico2| The port 5018 is the default port through which the event ID arrives as soon as an image has been taken. The event id is recorded in the log files and submitted to iXCapture to tag the file names correctly. |ico3| The EGM96 option is switched on, by default. This means that the altitudes are referenced to the EGM96 geoid. If this option is switched off, displayed altitudes will be referenced to the WGS84 ellipsoid. Settings for GSOF in AVX210 ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_GSOF4.png The following GSOF messages need to be transmitted: .. image:: ../../pics/navigator/systemintegration/NG_GSOF5.png The following NMEA message needs to be transmitted: .. image:: ../../pics/navigator/systemintegration/NG_GSOF6.png .. hint:: **Background information:** NMEA altitudes are referenced to the EGM96 geoid. Most often, the planned altitudes for the lines of flight are also referenced to the EGM96. GSOF Message 9, however, is referenced to the WGS84 ellipsoid. In most cases, the flight has to be done on EGM96 altitudes. Therefore, NMEA GGA needs to know the difference between EGM96 and WGS84 altitudes. .. image:: ../../pics/navigator/systemintegration/NG_GSOF7.png :width: 500 | .. image:: ../../pics/navigator/systemintegration/NG_GSOF8.png :width: 500 | .. image:: ../../pics/navigator/systemintegration/NG_GSOF9.png :width: 500 Setting up NMEA --------------- Setting up NMEA GPS in SensorHandler ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: Defining the button to connect to GPS NMEA #. In the main sensor list, right click on the button where you want to place the GPS NMEA connection. .. image:: ../../pics/navigator/systemintegration/NG_NMEA_settings.png :width: 400 #. Select GPS / NMEA Serial or UDP. #. The button is now connected with GPS NMEA. .. image:: ../../pics/navigator/systemintegration/NG_NMEA_settings1.png :width: 200 .. hint:: Remember to define the port (COM or TCP) through which the device can be reached. Settings for NMEA in SensorHandler for TCP/IP or UDP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. topic:: NMEA settings in SensorHandler fro TCP/IO or UDP #. Populate one of the buttons with GPS NMEA handler. .. image:: ../../pics/navigator/systemintegration/NG_NMEA_SHsettings1.png :width: 200 #. In SensorHandler, click on the **Ethernet** button to check the IP address and port. .. image:: ../../pics/navigator/systemintegration/NG_ethernet_button.png #. | The standard IP address is ``192.168.53.100`` | The standard port for all data is ``5018`` .. image:: ../../pics/navigator/systemintegration/NG_NMEA_SHsettings2.png :width: 500 #. Open the NMEA dialog by clicking on the **GPS NMEA serial or UDP** button in SensorHandler. #. Then click **Settings** button. .. image:: ../../pics/navigator/systemintegration/NG_settings.png :width: 150 #. | |ico1| By default, navigation data enters via TCP/IP. In this case, select the first option. | If data enters via UDP, then select the second option. | If data enters through a serial port, then the settings will be disregarded by the software. .. image:: ../../pics/navigator/systemintegration/NG_NMEA_SHsettings3.png :width: 500 |ico2| The standard case is that navigation data from this IMU is used for navigation. So, by default, select the first option. Settings for NMEA in AVX210 ^^^^^^^^^^^^^^^^^^^^^^^^^^^ If NMEA is the protocol, then use the settings shown below: .. image:: ../../pics/navigator/systemintegration/NG_NMEA_protocol.png :width: 500 | .. image:: ../../pics/navigator/systemintegration/NG_NMEA_protocol1.png :width: 500 Settings NMEA for NOVATEL ^^^^^^^^^^^^^^^^^^^^^^^^^ To synchronize PhaseOne image line and image ID with the image names you need to log MARKTIME sentences: ``MARKTIME ICOM1 0 66.5 FINESTEERING 2137 131289.096 02004000 292e1599017.999999999 VALID`` This allows SensorHandler and iXCapture to synchronize the event id, line id and image id. The image file name then can also contain the line and image id. Using the SOMAG mount handler ----------------------------- The two main configurations ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. important:: | To control the SOMAG mount this question must be answered: which device controls the mount? | Is it a) the Flight Management system or b) the INSS? | If using POS AV, then a) and b) can both be applied. | If using Novatel, then only a) is possible. .. image:: ../../pics/navigator/systemintegration/NG_mount_control.png .. list-table:: :class: unbordered-table :widths: 45 10 45 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_mount_control1.png - - .. image:: ../../pics/navigator/systemintegration/NG_mount_control2.png * - **1** POS AV or any other INSS sends position data to the FMS. This is usually done by ethernet but it can also be done by serial communication. - - **1** POS AV sends position data to the FMS. The FMS sends freeze / unfreeze to POS AV * - **2** The FMS is connected to the mount by a serial port. The FMS does the whole control of the mount: * Changing to STAB and MAN before and after the line * Sending pitch, roll and yaw corrections to the mount * Reading the mount angles - - **2** POS AV is connected to the mount. POS AV fully controls the mount: * Changing to STAB and MAN before and after the line * Sending pitch, roll and yaw corrections to the mount * Reading the mount angles * - No mount angles are logged. - - The mount angles can be logged on POS AV. .. topic:: Configuration 1: Settings for the mount controlled by FMS #. One of the buttons needs to be populated with the INSS being used (select one of those): .. image:: ../../pics/navigator/systemintegration/NG_config1_1.png :width: 200 #. In SensorHandler, select the SOMAG_V2 on one of the buttons: .. image:: ../../pics/navigator/systemintegration/NG_config1_2.png :width: 200 #. In SensorHandler, click on COM ports to define the com port the mount is connected to: .. image:: ../../pics/navigator/systemintegration/NG_config1_3.png :width: 200 #. In the list, select the SOMAG_V2. #. Then select the com port and baud 4 by clicking the button on the left. .. image:: ../../pics/navigator/systemintegration/NG_config1_4.png #. Set Baud rate to 115'200 .. topic:: Configuration 2: Settings for the mount controlled by POS AV #. Since the mount is controlled by POS AV, only the POS AV is required on a button (no SOMAG driver has to be selected): .. image:: ../../pics/navigator/systemintegration/NG_config2_1.png :width: 200 #. In SensorHandler, click on the Ethernet button: .. image:: ../../pics/navigator/systemintegration/NG_ethernet_button.png :width: 200 #. In one of the lists, select Applanix POS AV. Set the IP Address and display port: .. image:: ../../pics/navigator/systemintegration/NG_config2_2.png :width: 600 #. Click on the Applanix POS AV button .. image:: ../../pics/navigator/systemintegration/NG_config2_3.png :width: 200 and then on the Settings button .. image:: ../../pics/navigator/systemintegration/NG_settings.png :width: 150 #. Enter the following settings: .. image:: ../../pics/navigator/systemintegration/NG_config2_4.png :width: 300 Basic modes of operation ^^^^^^^^^^^^^^^^^^^^^^^^ This handler is used to control all the gyro mounts of the SOMAG AG Jena, running Protocol Version 2.0 . .. image:: ../../pics/navigator/systemintegration/NG_basicmode.png | In standard mode, the mount will be set to STAB mode before the line of flight starts and will be set to MAN mode after the line has been finished or when the line is left. The following angles need to be known to drive the mount accurately to the needed position: * pitch, roll, heading angles coming from the IMU * ground track heading coming from the GPS * actual yaw angle of the mount * the desired heading angle the mount should to be driven to. This heading angle can either be the heading of the planned line of flight or of the ground track. For special cases (like testing the mount), the automatic control of the mount can be switched off: .. image:: ../../pics/navigator/systemintegration/NG_basicmode.png After switching off the automatic mode, the mount won't switch between MAN and STAB mode automatically. This mode is mostly used for testing system components like communication and behavior of the mount. Pre-flight settings ^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_preflight.png .. list-table:: :class: unbordered-table :widths: 10 90 :header-rows: 0 * - .. image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 - | By default, heading corrections are switched ON. This means that the IMU yaw angle will be corrected in accordance with the received IMU angles. SensorHandler requires the actual yaw of the gimbal in order to calculate the amount of correction for accurate yaw positioning of the mount. Here, you set the time intervals in which actual gimbal angles are sent to SensorHandler. Normally, a value of 100 milliseconds is used. | | Select the method for heading correction: * Heading correction in STAB mode: this is the default. The mount is set to STAB mode at the start of the line and to MAN mode after having left the line. * Heading correction in MAN mode: in this mode, the mount's heading correction is carried out only by SensorHandler. No correction will be performed by the mount. This mode can be useful for ground tracks with short and intense changes in the heading (e.g. flying along a river or road by helicopter). * Set drift to Planned Heading: this is the default. |Company name| |Navigation Software name| sends the line's heading to SensorHandler. SensorHandler then sends small corrections to the mount to accurately align it with the line's heading. * Set drift to Ground Track: the yaw angle of the mount will be directed towards the ground track. The following sketch illustrates the distinction between the modes *Set Drift to Ground Track* (on the left) and *Set Drift to Planned Heading* (right): .. image:: ../../pics/navigator/systemintegration/NG_driftsketch.png * - .. image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 - The default position is switched ON. This means that roll and pitch angles coming from the IMU are used to increase the accuracy of the mount's stabilization process during flight. * - .. image:: ../../pics/navigator/settings/NG_settings_number3.png :width: 22 - In the edit fields, you define how many seconds before the start of the line of flight the mount will go into STAB mode and how many seconds after the end of the line of flight the mount will switch back to MAN mode. Automatic transition between STAB and MAN mode ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_stabmanmode1.png | .. list-table:: :class: unbordered-table :widths: 60 40 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanmode2.png - While on the line of flight the mount is automatically set to STAB mode * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanmode3.png - After having left the line of flight the mount is automatically switched back to MAN mode Manual transition between STAB and MAN mode ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: ../../pics/navigator/systemintegration/NG_stabmanmode4.png | .. list-table:: :class: unbordered-table :widths: 25 75 :header-rows: 0 * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanbutton1.png - switches back to automatic mode * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanbutton2.png - sets the STAB mode for all axes (roll, pitch, yaw) * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanbutton3.png - STAB mode is switched off and MAN mode is activated * - .. image:: ../../pics/navigator/systemintegration/NG_stabmanbutton4.png - * When the FMS control is switched OFF the mount can only be manually driven with using the SOMAG app. In this case, no commands from SensorHandler will be received. * When the FMS control is switched ON the mount is driven only by SensorHandler. No commands from the SOMAG app will be received. For system integrators: COM port settings ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The SOMAG mount and SensorHandler communicate through serial communication, requiring accurate configuration of the corresponding COM port settings. .. topic:: COM port configuration #. Right click on a free button and add *Platform SOMAG_V2* to the sensor list. #. Click on COM ports button: .. image:: ../../pics/navigator/systemintegration/NG_COMportsettings1.png #. In the COM ports dialog select a combo box and the SOMAG_V2 driver. #. Select the correct COM port. .. image:: ../../pics/navigator/systemintegration/NG_COMportsettings2.png #. These are the correct settings: .. image:: ../../pics/navigator/systemintegration/NG_COMportsettings3.png .. rubric:: Tip for system Integrators .. important:: Read the section below on how to verify the proper functionality of SensorHandler in conjunction with the SOMAG mount! Often, when integrating a system, you have the mount on the table but do not yet have an IMU available. Switch the mount without a connected IMU to STAB mode. You will notice that the mount moves slightly to the end stops (it does not really stabilize). But you can check if SensorHandler and mount behave correctly. You can perform this system check by forcing SensorHandler to send the mount gimbal angles back to the mount as simulated IMU values. Then the mount will be stabilized on the table. Do the following: .. topic:: Verifying proper functionality of SensorHandler and SOMAG mount #. In SensorHandler click Settings / Advanced Options. .. image:: ../../pics/navigator/systemintegration/NG_SH_somag1.png #. On the top some tabs appear: .. image:: ../../pics/navigator/systemintegration/NG_SH_somag2.png #. Select the tab *Test2*. .. image:: ../../pics/navigator/systemintegration/NG_SH_somag3.png #. Enable the option to send the gimbal values back to the gimbal as IMU values. .. image:: ../../pics/navigator/systemintegration/NG_SH_somag4.png #. Fly a line in simulation mode. The mount should be stabilized now, confirming the accurate communication between the mount and SensorHandler. Setting up ITRES sensor handling -------------------------------- This chapter explains how to connect an ITRES sensor to SensorHandler. .. topic:: Installation of ITRES sensor in SensorHandler #. Attach ITRES sensor to one of SensorHandler's buttons. Right click on the next free button in the sensor list to add ITRES sensor to one of the free buttons. .. image:: ../../pics/navigator/systemintegration/NG_Itres1.png :width: 200 #. In the popup menu select camera/ITRES. .. image:: ../../pics/navigator/systemintegration/NG_Itres2.png #. The ITRTES sensor interface is now visible. .. image:: ../../pics/navigator/systemintegration/NG_Itres3.png :width: 200 #. Click on the Ethernet button to define the connection to ITRES. .. image:: ../../pics/navigator/systemintegration/NG_Itres4.png #. In the next free list box select ITRES and set the IP address and port. .. image:: ../../pics/navigator/systemintegration/NG_Itres5.png #. Click on ITRES button. .. image:: ../../pics/navigator/systemintegration/NG_Itres6.png #. In ITRES window click on the **Settings** button. .. image:: ../../pics/navigator/systemintegration/NG_Itres7.png #. Define the following values: * how many seconds before the line of flight the sensor starts * how many seconds after the line of flight the sensor stops. .. image:: ../../pics/navigator/systemintegration/NG_Itres8.png #. | **Starting ITRES sensor for production** | At system start up click on the red button on the right side. After successfully connecting, all lights turn green. .. image:: ../../pics/navigator/systemintegration/NG_Itres9.png :width: 200 Setting up Robincop sensor handling ----------------------------------- .. image:: ../../pics/navigator/systemintegration/NG_Robincop.png .. list-table:: :class: unbordered-table :widths: 10 90 :header-rows: 0 * - .. image:: ../../pics/navigator/settings/NG_settings_number1.png :width: 22 - As the airplane is aligned to the flight line and passed the defined time, an *Acquire dark frame* command is sent to the system. * - .. image:: ../../pics/navigator/settings/NG_settings_number2.png :width: 22 - As the airplane passes this time marker, Navigator will be informed that the airplane approaches the first point. This command is not used right now. * - .. image:: ../../pics/navigator/settings/NG_settings_number3.png :width: 22 - As the airplane passes this time marker, the start logging command will be sent to the system. * - .. image:: ../../pics/navigator/settings/NG_settings_number4.png :width: 22 - As the airplane passes this time marker, an *Acquire dark frame* command will be sent to the system followed by a *stop logging* command. * - .. image:: ../../pics/navigator/settings/NG_settings_number5.png :width: 22 - When the airplane leaves the corridor (before it reached the end of the line) and does not enter within the defined time then a *stop logging* command will be sent to the system.