{"id":7081,"date":"2020-08-06T01:01:15","date_gmt":"2020-08-06T01:01:15","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&p=7081"},"modified":"2020-08-08T16:54:33","modified_gmt":"2020-08-08T16:54:33","slug":"pre-ntrip-client-connections","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pre-ntrip-client-connections\/","title":{"rendered":"Pre-NTRIP Client Connections"},"content":{"rendered":"

SNIP<\/strong><\/span> also supports NTRIP Client<\/a> connections by ‘simple’ GNSS devices that do not implement the NTRIP Protocol<\/a>. Such setups (typically with a dongle device) can make TCP\/IP connections<\/a>, but not NTRIP in either its Rev1 or Rev2 formats.<\/p>\n

Use Case:<\/h2>\n

To support Pre NTRIP Base Stations in a method similar to the RAW TCP\/IP tab<\/a>, SNIP<\/strong><\/span> provides a one-line command to allow any simple GNSS device to a) connect, b) identify which Base Station data stream it needs, and c) provide a username and password for security validation.<\/p>\n

Very often these devices connect by means of a serial port to a simple internet access dongle. The dongle does not know how to speak NTRIP, but it can be programmed to connect to a given IP and port (in this case your SNIP<\/span><\/strong> Caster) and then to send an initial one line command before streaming any subsequent data in both directions.<\/p>\n

When these connections are made, using the message format described below, SNIP<\/strong><\/span>‘s client pre-processing software simply translates the single line command into a full NTRIP request.<\/p>\n

Format:<\/h2>\n

The SNIP<\/strong><\/span> Client Command format follows one of two styles:<\/p>\n

SNIP#<mountPt>^Basic^<base64> <\/span>\u00a0\u00a0\u00a0 – used for closed casters<\/h3>\n

SNIP#<mountPt><\/span> \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0 \u00a0 – used for for open casters<\/h3>\n

Usage Notes:<\/h3>\n
    \n
  1. All text is in ASCII text.<\/li>\n
  2. Spaces are neither used nor allowed. Capitalization matters.<\/li>\n
  3. The command starts with the characters “SNIP#”\u00a0 (all upper case, without quotes)<\/li>\n
  4. The mountPt name must be a legal NTRIP mountPt name (ASCII only, without spaces or special characters) and is sent in clear text. The symbols “<” and “>” are not sent and are used here to delimit the mountPt text.<\/li>\n
  5. The symbol “^”\u00a0 (without quotes) is used as the general delimiter token.<\/li>\n
  6. The command format supports two styles:\u00a0 a connection string using a user name and password, and a connection string with no user name or password present.\u00a0 The first is for use with Closed Casters, the latter is for use with Open Casters.\u00a0 You may of course choose to operate your Caster in either mode.<\/li>\n
  7. The Basic authentication method is used to send a user name and password, just as it is used in the NTRIP standard. Consult the RTCM standard as required.<\/li>\n
  8. The Basic authentication content is encoded in Base64 format, e.g. “UserName:Password” becomes “VXNlck5hbWU6UGFzc3dvcmQ=”.\u00a0 The symbols “<” and “>” are not sent and are used here to delimit the base64 encoded text.<\/li>\n
  9. When the Basic authentication method is used, the mountPt is followed by the “^” token,\u00a0 then the text “Basic,” then a final “^” token, which is then followed by the base64 encoding of the user name and password.<\/li>\n
  10. The line ends with a single <cr><lf>.<\/li>\n
  11. Additional keywords and tokens may be added to this process as future needs warrant.<\/li>\n<\/ol>\n

    It may be necessary with some devices to use short user names and passwords in order to fit the entire command line into limited buffer space (32 and 40 character limits are known to exist on some devices).<\/p>\n

    Worked Example:<\/h2>\n

    Consider a simple GNSS device which needs to connect to “MyBase<\/strong>” with the credentials of user: Andy<\/strong> and the password: Simple<\/strong>.<\/p>\n

    The clear text of the password is then: “Andy:Simple” and this,
    \nwhen encoded in Base64, would be: “QW5keTpTaW1wbGU=”<\/p>\n

    The command line sent by the connecting client device would then be:<\/p>\n

    SNIP#MyBase^Basic^QW5keTpTaW1wbGU=<cr><lf><\/h3>\n

    When SNIP<\/strong><\/span> receives this input as a new client connection, it extracts the keywords and places them into a proper NTRIP Client request using the Rev1 format style (not Rev2<\/a>). The above command line translates into the below:<\/p>\n

                    GET \/MyBase HTTP\/1.0\\r\\n\r\n                User-Agent: NTRIP SNIPtranslatorR1\\r\\n\r\n                Authorization: Basic QW5keTpTaW1wbGU=\\r\\n\r\n                Connection: close\\r\\n\r\n                \\r\\n<\/pre>\n
    From this point onward the processioning flow is the same as for any other Client connection.<\/p>\n
    Summary<\/h2>\n
    The above describes the simple command protocol implemented on SNIP<\/strong><\/span> NTRIP Caster<\/a> to support pre NTRIP Client connections (i.e. rover devices).\u00a0 If such a device can send the initial one line command described above,\u00a0 it can connect to a specific Base Station with a valid user account as if it were a full NTRIP Client.<\/p>\n
    A similar connection ability, using a dedicated port, called RAW TCP\/IP<\/a>, is available for older pre NTRIP Base Stations<\/strong> which cannot connect as NTRIP Server<\/a> devices.\u00a0 This article<\/a> describes its use in more depth.<\/p>\n
    Note: This feature was added as part of the Rev 2-13-00 release.<\/p>\n","protected":false},"excerpt":{"rendered":"
    SNIP also supports NTRIP Client connections by ‘simple’ GNSS devices that do not implement the NTRIP Protocol. Such setups (typically with a dongle device) can make TCP\/IP connections, but not NTRIP in either its Rev1 or Rev2 formats. Use Case: To support Pre NTRIP Base Stations in a method similar […]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[283],"ht-kb-tag":[415,310,313],"class_list":["post-7081","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-managing-user-accounts","ht_kb_tag-client","ht_kb_tag-pre-ntrip","ht_kb_tag-raw"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7081","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=7081"}],"version-history":[{"count":13,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7081\/revisions"}],"predecessor-version":[{"id":7181,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7081\/revisions\/7181"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=7081"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=7081"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=7081"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}