{"id":9219,"date":"2024-12-10T23:07:40","date_gmt":"2024-12-10T23:07:40","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=9219"},"modified":"2024-12-12T00:28:54","modified_gmt":"2024-12-12T00:28:54","slug":"controlling-antenna-message-rates-with-pfat","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/controlling-antenna-message-rates-with-pfat\/","title":{"rendered":"Controlling Antenna Message rates with PFAT"},"content":{"rendered":"<p>This article describes limiting how often a Base Station data stream sends its precise antenna location message (MT1005 or MT1006) using the <strong>PFAT<\/strong> Translate controls, specifically the <strong>ECEF Adjustment<\/strong> dialog.\u00a0 See this article for details on the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-translate-settings-uses\/\" target=\"_blank\" rel=\"noopener\">PFAT Translate controls<\/a> in general.<\/p>\n<p style=\"padding-left: 40px;\">The\u00a0<strong>P.F.A.T.&#x2122;<\/strong>\u00a0control system provides several innovative ways to control the messages present in every data stream.\u00a0 The\u00a0<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/introducing-pfat\/\">PFAT features<\/a>\u00a0are available in the\u00a0<span style=\"color: #993300;\"><em><strong>Pro<\/strong><\/em><\/span>, and\u00a0<span style=\"color: #993300;\"><em><strong>Basic<\/strong><\/em><\/span>, editions of\u00a0<span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>.\u00a0<span style=\"color: #993300;\"><em><strong>Lite<\/strong><\/em><\/span>\u00a0copies of\u00a0<span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>\u00a0share the same code base, but many of these innovative features are disabled in the freely available\u00a0<em><span style=\"color: #993300;\"><strong>Lite<\/strong><\/span>\u00a0<\/em>edition.<\/p>\n<h2 id=\"what-is-the-need\">What is the need?<\/h2>\n<p>An ideal base station data stream should sent either its MT1005 or a MT1006 message once every 5 to 15 seconds.\u00a0 Sending more often is wasteful of over-the-air bandwidth (but does no other harm). And sending at slower rates requires every new <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP Client<\/a> user to wait until that message is received to begin using the data stream.\u00a0 Normally this rate is configured at the base station along with various other message types (i.e the legacy or MSM style observational messages). And when done this way at the base there is no need to use the <strong>PFAT<\/strong> controls to correct things.<\/p>\n<p>However, some base station tools do not allow controlling the sending rate, often sending the message at the same 1Hz rate of the observation messages. [Wasteful bit not harmful]\u00a0 Other base station tools allow sending <em>both<\/em> MT1005 and MT1006 which can confuse many GNSS devices. [Only one or the other should be sent, see the note at the bottom of the page if this applies to your case.]\u00a0 Still others base can be mis-configured to send send multiple copies of the same message when only one is needed regardless of the sending rate.\u00a0 [This last event, while not technically <em>illegal<\/em> as per the current RTCM3 standards, is clearly wrong and can confuse some GNSS receiver devices and prevent ambiguity fixing.]<\/p>\n<p>To repeat; this is ideally corrected at the base station side.\u00a0 \u00a0But when this is not possible (for example when you have access to the base station data stream but can not control the setup) then the these steps can be used to limit the sending rate that will be sent on to your connected users (the NTRIP Client devices).<\/p>\n<h2>Limiting MT1005\u00a0 \/MT1006 Sending Rates<\/h2>\n<p>The controls need are found in lower part of the <em><strong>Translate ECEF values<\/strong><\/em> dialog (first added in <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Rev <strong>3.17<\/strong>) that allows you to set a maximum sending rate for this message.\u00a0 \u00a0This can be used regardless (or along <em>with<\/em>) any ECEF translation you may wish to add the message (see <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-adjusting-base-station-common-reference-frame\/\" target=\"_blank\" rel=\"noopener\">this article<\/a> for details on how to shift the Base Station ECEF values to a difference frame of reference).<\/p>\n<p style=\"text-align: center;\"><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-9224 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17.png\" alt=\"\" width=\"660\" height=\"560\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17.png 660w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17-300x255.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17-50x42.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17-600x509.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialog_R3_17-320x272.png 320w\" sizes=\"auto, (max-width: 660px) 100vw, 660px\" \/><\/a><\/p>\n<p>To bring up this dialog on an active data stream proceed as follows.\u00a0 Right click on the stream in question (the stream must be parsed and contains RTCM3 message content) and select the menu item <strong>P.F.A.T.<\/strong> and the sub-menu <strong>Translate&#8230;<\/strong>\u00a0 \u00a0The master<strong> <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-translate-settings-uses\/\" target=\"_blank\" rel=\"noopener\">Translate dialog<\/a><\/strong> will appear.\u00a0 Select the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/translating-base-station-details\/\" target=\"_blank\" rel=\"noopener\"><strong>ECEF Adjustment<\/strong><\/a> line and press <strong>Setup<\/strong> and the below dialog will appear (with the values for the Base Station you have selected).<\/p>\n<p style=\"text-align: center;\"><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-9223 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17.png\" alt=\"\" width=\"800\" height=\"240\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17.png 800w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17-300x90.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17-768x230.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17-50x15.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17-600x180.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/ECEFdialogMsgRates_R3_17-320x96.png 320w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" \/><\/a><\/p>\n<p>In the section marked <strong>Maximum Message Sending Rate<\/strong> change the radio button from <strong><em>On Arrival<\/em><\/strong> (which is the default behavior, every message is sent on when it arrives) to be <strong>No More than Once every<\/strong>.\u00a0 Then select a time in seconds from the combo box.\u00a0 The default is no more then once every <strong>5 seconds<\/strong> but you can select a time as long as once every 60 seconds.<\/p>\n<p>With this setting, every time a new precise antenna position message is sent by the base, it is compared to the time stamp of the last message. And only if sufficient time has elapsed is it sent on to the connected users (NTRIP Client devices).<\/p>\n<p>That is all there is to it.\u00a0 You do not need to change the ECEC of Lat-Long values in this dialog but may do so if needed.\u00a0 To ensure that this change is used, be sure to check the <strong>New Values<\/strong> checkbox before you press <strong>Save.\u00a0 <\/strong>If you get a warning about a large offset (which presumably you do not want), just press <strong>Reset Offset<\/strong> (you will also see the new offset go zero mm) and then press <strong>Save<\/strong>.\u00a0 In the master Translate Dialog you must also check the <strong>Enable<\/strong> checkbox to turn this feature on and then press <strong>Ok<\/strong> to install the settings.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<hr \/>\n<h3>Advice on Bases sending <strong>both<\/strong> MT1005 and MT1006<\/h3>\n<p>Basically such a base is mis-configured and should send only one or the other. To fix it, you simply set a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-filter-dialog-controls\/\"><strong>PFAT Filter<\/strong><\/a> to remove the message you do not want. See <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-filter-settings-and-uses\/\" target=\"_blank\" rel=\"noopener\">this article<\/a> for details of how to do this.<\/p>\n<p>But which message do you need to remove?\u00a0\u00a0The only different between these two message is the presence of an antenna height offset value in MT1006.\u00a0 Use the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/using-the-rtcm3-decoder-dialog\/\" target=\"_blank\" rel=\"noopener\"><strong>RTCM message viewer<\/strong><\/a> to easily see the details of each.\u00a0 If the Antenna offset value is zero, you can keep the MT1005 message. If that value <strong>not<\/strong> zero, you need to keep the MT1006 message.<\/p>\n<p><strong><span style=\"color: #008000;\"><em>Aside #1<\/em><\/span><\/strong>: When the precise location is determined with tools like <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/post-processing-your-measurements-by-opus-and-others\/\" target=\"_blank\" rel=\"noopener\">OPUS<\/a>, any antenna offset is &#8220;baked into&#8221; the final value of X,Y,Z\u00a0 (lat-long). So there is no antenna offset to send, so use MT1005.\u00a0 Although you may need to send the antenna model that was used (or send <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/setting-advnullantenna\/\" target=\"_blank\" rel=\"noopener\">ADVNULLANTENNA<\/a>) in a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-mt1008-rtcm-messages\/\" target=\"_blank\" rel=\"noopener\">MT1008 message<\/a> as well.<\/p>\n<p><strong><span style=\"color: #008000;\"><em>Aside #2<\/em><\/span><\/strong>: Some base stations are a bit stupid and only send MT1006 (and not MT1005) even when the value of the antenna offset is zero.\u00a0 This wastes a couple of bytes, but is otherwise harmless.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article describes limiting how often a Base Station data stream sends its precise antenna location message (MT1005 or MT1006) using the PFAT Translate controls, specifically the ECEF Adjustment dialog.\u00a0 See this article for details on the PFAT Translate controls in general. The\u00a0P.F.A.T.&#x2122;\u00a0control system provides several innovative ways to control [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"closed","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":[334],"ht-kb-tag":[403,441,381],"class_list":["post-9219","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-advanced-topics","ht_kb_tag-ecec","ht_kb_tag-mt1005","ht_kb_tag-pfat"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/9219","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=9219"}],"version-history":[{"count":5,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/9219\/revisions"}],"predecessor-version":[{"id":9227,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/9219\/revisions\/9227"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=9219"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=9219"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=9219"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}