mirror of https://github.com/gnss-sdr/gnss-sdr
137 lines
6.0 KiB
Plaintext
137 lines
6.0 KiB
Plaintext
/*!
|
|
* \file README.txt
|
|
* \brief How to add a block to the Simulink Library repository of Matlab,
|
|
* how to use the "gnss_sdr_tcp_connector_tracking_start.m" script and how
|
|
* to replace the tracking block of the library.
|
|
*
|
|
* \author David Pubill, 2012. dpubill(at)cttc.es
|
|
*
|
|
* -------------------------------------------------------------------------
|
|
*
|
|
* Copyright (C) 2010-2012 (see AUTHORS file for a list of contributors)
|
|
*
|
|
* GNSS-SDR is a software defined Global Navigation
|
|
* Satellite Systems receiver
|
|
*
|
|
* This file is part of GNSS-SDR.
|
|
*
|
|
* GNSS-SDR is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* at your option) any later version.
|
|
*
|
|
* GNSS-SDR is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with GNSS-SDR. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* -------------------------------------------------------------------------
|
|
*/
|
|
|
|
|
|
IMPORTANT: Please, to use this tracking check the configuration file called
|
|
'gnss-sdr_tcp_connector_tracking.conf'. There are two major changes:
|
|
1.- Choose the [GPS_L1_CA_TCP_CONNECTOR_Tracking] tracking algorithm.
|
|
2.- Choose a tcp port for channel 0 (e.g. Tracking.port_ch0=2060;)
|
|
|
|
|
|
A) HOW TO add a block to the Simulink Library repository of your Matlab installation
|
|
---------------------------------------------------------------------------------
|
|
(These steps should be followed only the first time)
|
|
|
|
1.- Copy the content of this folder to a folder accessible from Simulink.
|
|
|
|
2.- In the Matlab Command Window type:
|
|
>> simulink;
|
|
to open the Simulink Library Browser.
|
|
|
|
3.- Right-click on the Simulink/User-Defined Functions of the Simulink
|
|
Library menu, and click on "Open User-Defined Functions library"
|
|
(Window_1)
|
|
|
|
4.- Open the library model 'gnss_sdr_tcp_connector_tracking_lib.mdl'
|
|
(Window_2)
|
|
|
|
5.- If this is not the first time there should be an existing 'gnss-sdr'
|
|
block in the 'User-Defined Functions' window that should be deleted
|
|
before drag and drop the new 'gnss_sdr' block (which includes 3 blocks:
|
|
- 'gnss_sdr_tcp_connector_tracking_rx' block
|
|
- 'gnss_sdr_tcp_connector_tracking' block
|
|
- 'gnss_sdr_tcp_connector_tracking_tx' block)
|
|
from Window_2 to Window_1. A new message should appear: "This library
|
|
is locked. The action performed requires it to be unlocked". Then,
|
|
click on the "Unlock" button (the block will be copied) and close
|
|
Window_2.
|
|
|
|
6.- Right-click on the 'gnss-sdr' block and click on "Link Options -->
|
|
Disable link", repeat the action but now clicking on "Link Options -->
|
|
Break link". This action disables and breaks the link with the
|
|
original library model.
|
|
|
|
7.- On Window_1 save the "simulink/User-Defined Functions" library.
|
|
To do that go to "File > Save". Then, close Window_1.
|
|
|
|
8.- From "Simulink Library Browser" window, press F5 to refresh and generate
|
|
the new Simulink Library repository (it may take a few seconds). This
|
|
completes the installation of the custom Simulink block.
|
|
|
|
|
|
B) HOW TO use the "gnss_sdr_tcp_connector_tracking_start.m" script:
|
|
----------------------------------------------------------------
|
|
|
|
----------------------- ------------------ -----------------------
|
|
| | | | | |
|
|
| gnss_sdr_tcp_ | | gnss_sdr_tcp_ | | gnss_sdr_tcp_ |
|
|
| connector_tracking_ | --> | connector_ | --> | connector_tracking_ |
|
|
| rx | | tracking | | tx |
|
|
| | | | | |
|
|
----------------------- ------------------ -----------------------
|
|
|
|
The 'gnss_sdr_tcp_connector_tracking_start.m' is the script that builds and
|
|
configures a simulink model for interacting with the GNSS-SDR platform
|
|
through a TCP communication. 'User parameters' can be modified but, by
|
|
default, these are the values assigned:
|
|
|
|
%User parameters
|
|
host = '84.88.61.86'; %Remote IP address (GNSS-SDR computer IP)
|
|
port = 2070; %Remote port (GNSS-SDR computer port for Ch0)
|
|
num_vars_rx = 9; %Number of variables expected from GNSS-SDR
|
|
num_vars_tx = 4; %Number of variable to be transmitted to GNSS-SDR
|
|
timeout = '40'; %Timeout in seconds
|
|
|
|
'host', 'port' and 'timeout' parameters configure both
|
|
'gnss_sdr_tcp_connector_tracking_rx' and 'gnss_sdr_tcp_connector_tracking_tx'
|
|
blocks. The 'port' parameter sets the base port number for the first
|
|
channel (ch0). Each of the subsequent channels increases their port by one
|
|
unit (e.g. ch0_port=2070, ch1_port=2071,...).
|
|
|
|
Also the name of the tracking block can be modified. It must match with
|
|
the Simulink model name:
|
|
|
|
%Name of the tracking block, it must match the Simulink model name
|
|
tracking_block_name = 'gnss_sdr_tcp_connector_tracking';
|
|
|
|
To run the script just type in the Matlab Command window the following:
|
|
|
|
>>gnss_sdr_tcp_connector_tracking_start(N);
|
|
|
|
where N must match the number of channels configured in the GNSS-SDR
|
|
platform.
|
|
|
|
|
|
C) HOW TO replace the tracking block of the library
|
|
------------------------------------------------
|
|
|
|
1.- Open the library model 'gnss_sdr_tcp_connector_tracking_lib.mdl'
|
|
2.- Unlock the library. Click on "Edit > Unlock Library".
|
|
3.- Open the "gnss-sdr" block and change the "gnss_sdr_tcp_connector_tracking"
|
|
block by another one. If the name is different it must be updated in
|
|
the "gnss_sdr_tcp_connector_parallel_tracking_start.m" code (see
|
|
section B)
|
|
4.- Save the new library.
|
|
5.- Go to section A and follow the instructions.
|
|
|