.. _mobile_app: .. |br| raw:: html
.. index:: single: Mobile App Mobile App ========== The mobile app runs on **Android, Windows 10, Linux and Mac OS-X** |br| Via :doc:`../downloads/downloads` use the adu_client_android or inside the procmt_experimental_64bit. |br| .. note:: Note that for means of power saving the ADU-08e / ADU-08e-2C will deactivate the WiFi after 15 minutes if no device has been connected. You can reactivate WiFi with help of the power button or front panel .. caution:: When you reboot the system also **completely close the app, really close!** in order to enforce that the ADU configuration is re-read completely when re-connecting. |br| .. caution:: There are some Restrictions_in_Programming_ and on the ADU-07e some additional Limitations_ADU-07e_ New May 2020 ----------------- Grid raster 64s for RR, 60s for AMT/MT with virtual sample rates down to 4s only, 1s raster for arbitrary start times |br| Load previously stored joblist from the ADU and run them. The enables you to use your personal style or containing subjobs. |br| *First make the E-field spacing, site settings (in case), press write in order to make changes persistent* |br| **BEFORE** *loading the list* **change** *the start time, load the list and ... off you go* |br| Short video intro -------------------- (click video to full screen) .. raw:: html
|br| Programming a Job -------------------- (click video to full screen) Several pre-programmed job list are available. The name indicates which frequencies will be used, and their duration. This is the easiest way to record MT data. |br| .. raw:: html
|br| Finalize a Job -------------------- (click video to full screen) The pre-programmed job list will run for 10 days. |br| Coming back to the station you stop the recording and while downloading you submit the high frequency jobs (only) again. |br| .. raw:: html
|br| Special Jobs -------------------- (click video to full screen) Eject the SD card on ADU-08e, format SD card, copy to USB device |br| .. raw:: html
|br| Connecting to the ADU-08e System ----------------------------------- .. |info| image:: /media/symbols/info.svg .. csv-table:: :widths: 15, 80 :delim: ; |info| ; **Information** If you want to connect from a mobile device via WiFi, |br| you need to activate the WiFi on ADU-08e system via the Front-panel display, first. |br| Afterwards, connect to the WiFi of the ADU-08e from your mobile device. |br| No username or password is needed. After having started the App, it is not connected to the ADU-08e system yet. .. image:: /media/app/App_Main_NotConnected.png :width: 30% :align: center Click on the „CON" button to open the „Connect To ADU" tab. On that tab enter the target IP address of the ADU-08e system inside the „ADU IP" box and click on the „Connect" button. .. image:: /media/app/App_Main_NotConnected.png :width: 30% :align: center Now, the App is connected to the ADU-08e system and the main tab shows the actual status of the ADU-08e. .. image:: /media/app/App_ConWindows.png :width: 30% :align: center Main Tab -------- Once you are connected to the ADU-08e you should check the actual status of the ADU-08e system. For this purpose the „Main Tab" contains the following information: .. image:: /media/app/App_Main_Connected.png :width: 30% :align: center Date/Time: Shows the actual Date/Time of the ADU-08e system - e.g. UTC .. image:: /media/app/date_time.png :width: 30% :align: center .. _app_time_to_next_job: Time To Next Job ---------------- This element shows the remaining time until the start of the next job or idle. .. |App_Joblist_NoJobs| image:: /media/app/App_Joblist_NoJobs.png .. |App_Joblist_NextJob| image:: /media/app/App_Joblist_NextJob.png .. csv-table:: :widths: 50, 50 |App_Joblist_NoJobs|, No jobs are scheduled; system idle |App_Joblist_NextJob| , Shows "starttime of next job". |br| A job is sheduled on the ADU-08e system and will be started at 11:00:00 Additionally, clicking on this button will open the :ref:`"job list" tab ` Current running job ----------------------- .. |App_StopJob_NoJob| image:: /media/app/App_StopJob_NoJob.png .. |App_StopJob_JobRunning| image:: /media/app/App_StopJob_JobRunning.png .. csv-table:: :widths: 50, 50 |App_StopJob_NoJob| , No jobs are running; system is **idle** |App_StopJob_JobRunning| , A job is running at 65536Hz. |br| job was started on 2017-04-06 10:56:00 Additionally, clicking on this button will open the "stop job" tab ref: :ref:`Stopping Jobs ` GPS Status ---------- This element shows the current status of the synchronization to GPS of the ADU-08e system. .. |App_Button_GPS_Green| image:: /media/app/App_Button_GPS_Green.png .. |App_Button_GPS_Yellow| image:: /media/app/App_Button_GPS_Yellow.png .. |App_Button_GPS_Red| image:: /media/app/App_Button_GPS_Red.png .. csv-table:: :widths: 20, 80 :delim: ; |App_Button_GPS_Green| ; The ADU-08e system is fully synchronized to GPS |br| All Jobs that will be started will be 100% synchronous to GPS time |br| Applies to Status G4Fix |App_Button_GPS_Yellow| ; GPS has Full Sync, but ADU-08e system is not yet synced to GPS time |App_Button_GPS_Red| ; The ADU-08e system is NOT fully synced to GPS time Additionally, clicking on this button will open the "GPS" tab :ref:`"GPS Status" ` Battery Status --------------- This element shows the current battery status. .. |App_Button_Batt_Green| image:: /media/app/App_Button_Batt_Green.png .. |App_Button_Batt_Yellow| image:: /media/app/App_Button_Batt_Yellow.png .. |App_Button_Batt_Red| image:: /media/app/App_Button_Batt_Red.png .. csv-table:: :widths: 20, 80 :delim: ; |App_Button_Batt_Green| ; Battery is "GOOD" and fully charged |App_Button_Batt_Yellow| ; Battery is "FAIR" |br| The system can continue operation. In case you plan to run it for a long time change the battery to a fresh one |App_Button_Batt_Red| ; Battery is "LOW" |br| Change the battery soon because system may stop soon. All data is saved up to then and the system will be shut down, eventually Additionally, clicking on this button will open the :ref:`"Battery" tab` Self Test Status ------------------- This element shows the self-test results status. .. |App_Button_Selftest_Green| image:: /media/app/App_Button_Selftest_Green.png .. |App_Button_Selftest_Yellow| image:: /media/app/App_Button_Selftest_Yellow.png .. |App_Button_Selftest_Red| image:: /media/app/App_Button_Selftest_Red.png .. csv-table:: :widths: 20, 80 :delim: ; |App_Button_Selftest_Green| ; Self-test Result is "OK" |br| All self-test steps have been executed successfully |App_Button_Selftest_Yellow| ; Self-test Result is "Warning" |br| Before starting jobs, please check the detailed self-test results |br| ADU-08e system may work correctly, e.g. only DC offset is very high |App_Button_Selftest_Red| ; Self-test Result is "Critical" |br| Definitely check the detailed self-test results before starting jobs |br| Some parameters are out of range or some of the hardware components (e.g. sensors) have severe problems Additionally, clicking on this button will open the :ref:`"Self-test Results" tab ` Status Buttons ------------------- If, after the Self-test has finished, the Status buttons show the following colors: .. csv-table:: :widths: 15, 15, 15, 55 :delim: ; |App_Button_GPS_Green| ; |App_Button_Batt_Green| ; |App_Button_Selftest_Green| ; All Status Buttons show Green |br| Directly continue with :ref:`Configuration ` |App_Button_GPS_Yellow| ; |App_Button_Batt_Green| ; |App_Button_Selftest_Green| ; GPS Status is yellow, but all other status buttons show green |br| Wait / and or check the cable, when turns to green, continue with :ref:`Configuration ` |App_Button_GPS_Red| ; |App_Button_Batt_Green| ; |App_Button_Selftest_Green| ; GPS Status is yellow or red, but all other status buttons show green |br| .. as above |br| however: in most cases GPS should be yellow after after selftest already |App_Button_GPS_Green| ; |App_Button_Batt_Yellow| ; |App_Button_Selftest_Green| ; Battery status is yellow, but all other status buttons show green |br| System will work for some hours. |App_Button_GPS_Green| ; |App_Button_Batt_Red| ; |App_Button_Selftest_Green| ; Battery Status is red, but all other status buttons show Green |br| Definitely exchange batteries against fresh ones. ADU-08e system will shut down soon! |App_Button_GPS_Green| ; |App_Button_Batt_Green| ; |App_Button_Selftest_Yellow| ; Self-test result is yellow, but all other status buttons show green |br| Check the "Self-test Results" Tab :ref:`Checking Self-Test Results` |br| Yellow can also in case E/H signals are very high or the conctact resistivity is poor. |App_Button_GPS_Green| ; |App_Button_Batt_Green| ; |App_Button_Selftest_Red| ; Self-test result is red, but all other status buttons show green |br| System will **fail** When STR is red additionally make a database dump via the WEB interface, zip, and send to in case you can't solve the problem. .. |caution| image:: /media/symbols/ISO7000-0434.svg .. csv-table:: :widths: 20, 80 :delim: ; |caution| ; **Caution** |br| Starting Jobs even though the Self-test Result is Red will result in bad or useless data! .. csv-table:: :widths: 20, 80 :delim: ; |caution| ; **Caution** |br| **Starting Jobs even though the GPS is yellow or read will lead to non synced data!!** .. _app_Configuration: Configuration -------------- .. |App_Button_GPS_Config| image:: /media/app/App_Button_GPS_Config.png .. csv-table:: :widths: 20, 80 :delim: ; |App_Button_GPS_Config| ; Opens the configuration dialog Setting up E-Field Spacing --------------------------- The E-Filed will be configured on the "Configuration" Tab. It is reached by clicking on the "CFG" button on the "Main Tab". .. image:: /media/app/App_Config_Sensors.png :width: 30% :align: center This tab shows the currently used E-Field spacing (along with the currently configured H-Field Sensors - Type and Serial). |br| Clicking on the single buttons will execute the following actions: .. |App_Config_Sensors_1| image:: /media/app/App_Config_Sensors_1.png .. |App_Config_Sensors_2| image:: /media/app/App_Config_Sensors_2.png .. |App_Config_Sensors_3| image:: /media/app/App_Config_Sensors_3.png .. csv-table:: :widths: 50, 50 :delim: ; |App_Config_Sensors_1| ; Shows the E-field spacing for Ex in meters (North-South dipole) |br| Clicking on the button will open the "E-Field" configuration tab for Ex |App_Config_Sensors_2| ; Shows the E-field spacing for Ey in meters (East-West dipole) |br| Clicking on the button will open the "E-Field" configuration tab for Ey |App_Config_Sensors_3| ; Shows the Sensor Type and Serial for Hx |br| Clicking on the button will open the "H-Field" configuration tab for Hx ... same for Hy and Hz, when buttons pressed you go to :ref:`Configure H Field ` To configure the E-Field spacing for channels Ex or Ey, click on the according buttons to open the "Ex/Ey Channel" Tab: .. image:: /media/app/App_Config_EField.png :width: 30% :align: center The single input elements can be used to configure the dipole length (North-South for Ex and East-West for Ey) .. csv-table:: :widths: 20, 80 :delim: ; |caution| ; **Caution** |br| Entering wrong values for the E-Field Spacing will result in wrongly shifted resistivity curves. |br| A dipole length smaller than the real one will result in down-shifted resistivity curves |br| A dipole length bigger than the real one will result in up-shifted resistivity curves. .. _app_configure_h_field_sensors: Configure H-Field Sensors --------------------------------- The H-Field sensor types are configured on the "Hx", "Hy" and "Hz" Channel configuration Tabs. They are entered from the :ref:`Config Button ` |br| The coil type and serial number shown are the values from the auto detection. .. image:: /media/app/App_Config_HField.png :width: 30% :align: center .. csv-table:: :widths: 20, 80 :delim: ; |info| ; **Information** |br| In case of usage of E-Type sensors (like MFS-06e, MFS-07e, SHFT-02e and FGS-03e) |br| the sensor type and serial number is determined from the sensors during boot-up of the ADU-08e system automatically. |br| Hence, there is no need to manually enter those parameters. In case you do not use series E-Type sensors you need to enter the sensor type and serial number manually. If you have a E-Type sensor connect and you do not have sensor type and serial number shown, something is defective and your recording may fail! This is done as follows: .. |App_Config_HField_1| image:: /media/app/App_Config_HField_1.png .. |App_Config_HField_2| image:: /media/app/App_Config_HField_2.png .. csv-table:: :widths: 50, 50 :delim: ; |App_Config_HField_1| ; Click on "Manual" Button and enter Serial Number |App_Config_HField_2| |br| Select the sensortype that is currently connected .. csv-table:: :widths: 20, 80 :delim: ; |caution| ; Caution! |br| Choosing the wrong sensor type and serial number may result in incorrect resistivity results |br| as in this case the wrong sensor transfer function is applied to the data during data processing. Clicking on the "AUTO" button will configure the sensor type and serial values back to the ones that have been read from the connected Sensors during boot-up of the ADU-08e system again. .. index:: single: Mobile App; Site Config Setting up Site Config ----------------------- The "Site Config" Tab is used to enter site specific information that will be stored along with the measurement data inside the "meas-doc" XML file and the ATS files. You reach it from the main menu by pressing :ref:`CFG` and then SiteCFG at the bottom. .. image:: /media/app/App_SiteConfig.png :width: 50% :align: center .. csv-table:: :widths: 20, 80 :delim: ; |info| ; **Information** |br| it is not mandatory to enter Site Config data before starting your jobs. The recording will be done correctly, |br| even without any Site Config information. Nevertheless, it may help later on to find / identify the data or trace down data quality problems. It is also required for ISO 900X complient certified institutes. Start of a Single Job ----------------------- A single job can be started from the "Job List" Tab. It is opened by clicking on the :ref:`"Job List" ` button on the main tab. .. image:: /media/app/App_Joblist.png :width: 50% :align: center By default no jobs are scheduled on the ADU-08e system (indicated by "L" - List on "Edit" Button of the jobs L : on local phone/computer, ADU : on the ADU). A single Job can be started by: .. |App_Joblist_1| image:: /media/app/App_Joblist_1.png .. |App_Joblist_2| image:: /media/app/App_Joblist_2.png .. csv-table:: :widths: 50, 50 :delim: ; |App_Joblist_1| ; Clicking on the "Add" Button |br| This will add another job to the job-list, using the current configuration. |App_Joblist_2| ; Clicking on the "Edit" Button of the job itself |br| This will open the "Edit Job" tab to edit the job parameters (see below) If clicked on the "Edit" button you may enter the Jobs parameters on the "Edit Job" Tab: .. image:: /media/app/App_EditJob_1.png :width: 50% :align: center .. image:: /media/app/App_EditJob_2.png :width: 50% :align: center The single input elements are used as follows: .. |App_EditJob_1_1| image:: /media/app/App_EditJob_1_1.png .. |App_EditJob_1_2| image:: /media/app/App_EditJob_1_2.png .. |App_EditJob_1_3| image:: /media/app/App_EditJob_1_3.png .. |App_EditJob_1_4| image:: /media/app/App_EditJob_1_4.png .. csv-table:: :widths: 50, 50 :delim: ; |App_EditJob_1_1| ; Enter Start/Time of the Job |App_EditJob_1_2| ; Enter Duration (Length) of the job in seconds. |br| Stop Date/Time will be computed automatically |App_EditJob_1_3| ; As an alternative, enter Stop Date/Time of the Job. |br| Duration will be computed automatically |App_EditJob_1_4| ; Enter Sample Frequency of Job Finally, the changes need to be saved by clicking on the "Save" button. By clicking the Save button you will automatically get back to the "Job List" tab. Still the job is not yet submitted to the ADU-08e system: .. |App_EditJob_edit_1| image:: /media/app/App_EditJob_edit_1.png .. |App_EditJob_edit_2| image:: /media/app/App_EditJob_edit_2.png .. |App_EditJob_edit_3| image:: /media/app/App_EditJob_edit_3.png .. csv-table:: :widths: 50, 50 :delim: ; |App_EditJob_edit_1| ; Job was edited, but is still not scheduled on ADU-08e (see "L" on "Edit" Button). |App_EditJob_edit_2| ; Clicking on the "Submit" button will transmit the Job to the ADU-08e |App_EditJob_edit_3| ; Now, the job is scheduled on the ADU-08e system (see "ADU" on "Edit" button) |br| and will be started once its start-time is reached The other buttons execute the following actions: .. |App_EditJob_button_1| image:: /media/app/App_EditJob_button_1.png .. |App_EditJob_button_2| image:: /media/app/App_EditJob_button_2.png .. |App_EditJob_button_3| image:: /media/app/App_EditJob_button_3.png .. index:: single: Mobile App; Job List .. _app_starting_complete_joblist: Starting a Complete Job-list ----------------------------- Clicking on the "Load List" button on the "Job List" Tab will open the "Load Job List" Tab that can be used to start a complete, already pre-defined job-list: .. image:: /media/app/App_LoadJoblist.png :width: 50% :align: center You just need to do the following: .. |App_LoadJoblist_1| image:: /media/app/App_LoadJoblist_1.png .. |App_LoadJoblist_2| image:: /media/app/App_LoadJoblist_2.png .. csv-table:: :widths: 50, 50 :delim: ; |App_LoadJoblist_1| ; Enter Start Date/Time of the job-list |br| The Start-Time of the first job of the job-list will be scheduled on the Time defined here |App_LoadJoblist_2| ; Select the job-list to be started After having selected the job-list to be started you will automatically get back on the "Job List" Tab with all the jobs of the selected jobs being listed: .. image:: /media/app/App_job_list_1.png :width: 50% :align: center Again, the jobs are not scheduled on the ADU-08e system yet. To transmit the job-list to the ADU-08e system you need to click on the "Submit" button on the bottom of this tab. Afterwards the jobs of the job-list are transferred to the ADU-08e system and will be started once the start-times are reached: .. image:: /media/app/App_job_list_2.png :width: 50% :align: center The single Job-list Templates consist of the following Jobs: .. csv-table:: :widths: 50, 50 :delim: ; Name ; Use Case Long Test ; Used for long test run on a new site Overnight-06e ; Full recording schedule to acquire data in ALL frequency bands, using MFS-06e sensors Overnight-07e ; Full recording schedule to acquire data in ALL frequency bands, using MFS-07e sensors Short Test ; Short Site test Direct-Mode ; Short test job-list for direct ADC input w/o preamps In most job lists the last job is the LF job. You may want to *edit* the last job and adjust the duration to your needs. .. _app_stopping_jobs: Stopping Jobs -------------- The "Stop Jobs" tab shows information about the jobs currently running: .. image:: /media/app/App_StopJob.png :width: 50% :align: center The single elements have the following functionality: .. |App_StopJob_1| image:: /media/app/App_StopJob_1.png .. |App_StopJob_2| image:: /media/app/App_StopJob_2.png .. |App_StopJob_3| image:: /media/app/App_StopJob_3.png .. |App_StopJob_4| image:: /media/app/App_StopJob_4.png .. csv-table:: :widths: 50, 50 :delim: ; |App_StopJob_1| ; Shows the start-time of the next scheduled job on the ADU-08e system |App_StopJob_2| ; Shows information about the job currently running |br| Clicking on the "Stop" button will stop the job on the ADU-08e system |App_StopJob_3| ; Shows the remaining time of the currently active job in |br| Days Hours:Minutes:Seconds |App_StopJob_4| ; Clicking on this button will remove all scheduled jobs from the ADU-08e system |br| Note that this will NOT stop the currently running job. .. _app_gps_status: .. index:: single: Mobile App; GPS Status Checking GPS Status ------------------- On the "GPS" Tab you may check the current status of the GPS: .. image:: /media/app/App_GPS.png :width: 50% :align: center .. csv-table:: :widths: 20, 80 :delim: ; |info| ; Note that the number of satellites reported for the single GNS (such as GPS, Galileo and Glonass) |br| does only represent the maximum amount of satellites that are possibly in view. |br| To see the number of currently tracked satellites (all satellites systems) see the "Num Sats" entry .. _app_battery_status: Checking the Battery Status ------------------------------- On the "Battery" Tab you may check the detailed battery status for battery voltage and Battery Current that is currently drawn from battery inputs BATT-1 and BATT-2: .. image:: /media/app/App_Battery.png :width: 50% :align: center .. csv-table:: :widths: 20, 80 :delim: ; |info| ; Information |br| If exchanging batteries during a running job, exchange the battery from which the lowest current is drawn at first |br| Additionally, you may connect a third battery temporarily to the "AUX" battery socket on the front-panel |br| In the exampe above, you first exchange BAT 1 Hence that the drop down in voltage is not linear! If the voltage drops down from 13.5V to 12.5V in 6 hours, another 6 hours later the Voltage is maybe 10V only (so lees two instead of less one in the same time). .. index:: single: Mobile App; Selftest Results .. _app_Checking_Self_test_Results: Checking Self-Test Results --------------------------- On this tab you may check the detailed self-test results for each one of the channels: .. image:: /media/app/App_SelftestResults.png :width: 50% :align: center For each channel the results and the according limit values are shown. Values that are out of range are marked in red color .. csv-table:: :widths: 20, 80 :delim: ; |info| ; Information |br| Note that according to the active self-test mode not all self-test steps are executed to save time during boot |br| Therefore some of the values may be 0 |br| In case of self-test results being yellow or green, check the "Message" field |br| of the channels result list to find out, what is wrong Format SD Card with ext4 -------------------------- The ext4 file system is the Linux native file system. It is more reliable compared to the stone age FAT32 and vFat. |br| We recommend always to use ext4 together with the SD card or external USB drives (except for short runs). |br| (You do *not need* to press EJ-SD card - this is done automatically)! The maximum size for the internal card is 32 GB. Go to CFG -> CLR-SD; make sure that is moment **your are NOT connected via samba and access the ADU's network drive**. .. raw:: html
Insert and Eject SD card ------------------------------ You can eject and insert the SD card without powering off the ADU. |br| This can be desirable when downloading huge data sets or for CSAMT where you have one card for each station with. |br| A joblist can be put in advance on the card and the ADU starts to run after booting. .. _Restrictions_in_Programming: .. index:: single: Mobile App; Restrictions Restrictions ----------------------------- The App is made for *simple and safe* programming of the system for 3/4 of all cases. |br| You can not select boards or chopper manually, program cyclic or subjobs. Also the App strongly relies on a "freshly" booted ADU with sensors auto-detected and selftest carried out. |br| The user may edit the E-Field spacing and site configuration, load a joblist and safely record his MT site. After **detect sensors** (which may takes about 10s in the background) please disconnect & connect the app again; the hardware configuration is only read during login. (I have not programmed a "reload" button). |br| The hardware configuration is the REAL detected configuration; not the channel configuration - which is your self-made configuration. The App relies on the e-series sensors and reads the hwconfig only. Temporarily you can change the sensors and press "Write" - to keep alive your configuration until next boot. It contradicts with the philosophy of the App to use non-detected configurations. .. index:: single: Mobile App; Limitations on ADU-07e .. _Limitations_ADU-07e: Limitations on ADU-07e ----------------------------- The App is written for the ADU-08e; we have writen some wrappers to make the App functioning with the ADU-07e. The ADU-07e uses eventually the big "IN2" to connector. |br| In this case the Apps maps the IN2 magnetic channels down to the standard connectors. A dual sensor setup (coils and fluxgate/SHFT) at the same time can not be operated by the App.