{"id":220,"date":"2017-09-27T17:14:59","date_gmt":"2017-09-27T16:14:59","guid":{"rendered":"https:\/\/computenodes.net\/?p=220"},"modified":"2025-01-17T16:04:18","modified_gmt":"2025-01-17T16:04:18","slug":"mapping-lorawan-coverage-in-southampton","status":"publish","type":"post","link":"https:\/\/computenodes.net\/2017\/09\/27\/mapping-lorawan-coverage-in-southampton\/","title":{"rendered":"Mapping LoRaWAN coverage in Southampton"},"content":{"rendered":"<p>Having setup some LoRaWAN base stations to provide coverage of the Southampton area we wanted to see if there are any black spots without coverage, and therefore where new basestations should be deployed. We are also looking to do more work with positioning of LoRaWAN devices so need transmissions from known locations. Rather than developing our own mapping system we decided to build upon <a href=\"http:\/\/ttnmapper.org\/\" target=\"_blank\" rel=\"noopener\">TTN Mapper<\/a> developed by JP Meijers. This can be achieved using a simple node and an application running on your phone to provide the GPS location. We chose not to use this as it requires setting up an app, whereas having a standalone device is much easier to pass between people.<\/p>\n<h1>Hardware<\/h1>\n<p>Having decided upon a standalone hardware based solution it was a matter of chosing which hardware to use. For another project we are using pycom devices; the <a href=\"https:\/\/pycom.io\/product\/lopy\/\" target=\"_blank\" rel=\"noopener\">LoPy <\/a>in particular. This provides a LoRaWAN package in a convenient form factor which is programmed using Python. They also provide an expansion board the <a href=\"https:\/\/pycom.io\/hardware\/pytrack-specs\/\">Pytrack <\/a> which adds GPS connectivity to the board.<\/p>\n<p>Having decided on the hardware we could then work out which of the other peripherals that the expansion board had to use. It was decided it would also be interesting to log GPS co-ordinates locally on the devices so that these could be compared to the data received at the base stations to identify gaps in coverage.<\/p>\n<p>To build the hardware we used the following parts<\/p>\n<h2>Parts list<\/h2>\n<ul>\n<li><a href=\"https:\/\/pycom.io\/product\/lopy\/\" target=\"_blank\" rel=\"noopener\">LoPy <\/a><\/li>\n<li><a href=\"https:\/\/pycom.io\/product\/pytrack\/\" target=\"_blank\" rel=\"noopener\">Pytrack <\/a><\/li>\n<li><a href=\"https:\/\/pycom.io\/product\/lora-antenna-kit\/\" target=\"_blank\" rel=\"noopener\">LoRaWAN antenna kit<\/a><\/li>\n<li><a href=\"https:\/\/pycom.io\/product\/ip67-case\/\" target=\"_blank\" rel=\"noopener\">Pytrack case<\/a><\/li>\n<li><a href=\"http:\/\/uk.rs-online.com\/web\/p\/lithium-rechargeable-battery-packs\/1251266\/\" target=\"_blank\" rel=\"noopener\">Battery<\/a><\/li>\n<li><a href=\"http:\/\/uk.rs-online.com\/web\/p\/toggle-switches\/7346971\/\" target=\"_blank\" rel=\"noopener\">Switch<\/a> (Any SPST switch is suitable)<\/li>\n<li><a href=\"http:\/\/uk.rs-online.com\/web\/p\/pcb-connector-housings\/8201466\/\" target=\"_blank\" rel=\"noopener\">JST connector for pytrack<\/a><\/li>\n<li><a href=\"http:\/\/uk.rs-online.com\/web\/p\/industrial-automation-cable-assemblies\/8201419\/\" target=\"_blank\" rel=\"noopener\">Contacts for pytrack JST connector<\/a><\/li>\n<li><a href=\"http:\/\/uk.rs-online.com\/web\/p\/pcb-headers\/8201554\/\" target=\"_blank\" rel=\"noopener\">Connector for battery<\/a> (depends on battery used)<\/li>\n<\/ul>\n<p>The battery is connected to via the switch to the pytrack PCB. This means the board can be turned on\/off without having to open the case. The case still has to be opened to charge the battery as there is currently no external USB connector. There is also currently no way of viewing the debug LED when the case is closed. The battery and PCB are secured in place using velcro.<\/p>\n<figure id=\"attachment_228\" aria-describedby=\"caption-attachment-228\" style=\"width: 1024px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"size-large wp-image-228\" src=\"https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20-1024x576.jpg\" alt=\"Pytrack node\" width=\"1024\" height=\"576\" srcset=\"https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20-1024x576.jpg 1024w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20-300x169.jpg 300w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20-768x432.jpg 768w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20-1140x641.jpg 1140w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/2017-09-27-16.16.20.jpg 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption id=\"caption-attachment-228\" class=\"wp-caption-text\">Pytrack node<\/figcaption><\/figure>\n<h1>Software<\/h1>\n<p>The easiest way for the data to be imported into TTN mapper is to use one of their standard formats. They accept simple ascii but recommend a more efficient binary encoding of the data. In order to check you have encoded the data correctly you can add a custom payload to the things network. This is provided in the comments in a git repo available at <a href=\"https:\/\/github.com\/jpmeijers\/RN2483-Arduino-Library\/blob\/master\/examples\/TheThingsUno-GPSshield-TTN-Mapper-binary\/TheThingsUno-GPSshield-TTN-Mapper-binary.ino\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/jpmeijers\/RN2483-Arduino-Library\/blob\/master\/examples\/TheThingsUno-GPSshield-TTN-Mapper-binary\/TheThingsUno-GPSshield-TTN-Mapper-binary.ino<\/a>, but also reproduced below.<\/p>\n<pre class=\"brush: jscript; title: Payload decoder; notranslate\" title=\"Payload decoder\">\r\n\r\nfunction Decoder(bytes, port) {\r\n  var decoded = {};\r\n  decoded.lat = ((bytes&#x5B;0]&lt;&lt;16)&gt;&gt;&gt;0) + ((bytes&#x5B;1]&lt;&lt;8)&gt;&gt;&gt;0) + bytes&#x5B;2];\r\n  decoded.lat = (decoded.lat \/ 16777215.0 * 180) - 90;\r\n  decoded.lon = ((bytes&#x5B;3]&lt;&lt;16)&gt;&gt;&gt;0) + ((bytes&#x5B;4]&lt;&lt;8)&gt;&gt;&gt;0) + bytes&#x5B;5];\r\n  decoded.lon = (decoded.lon \/ 16777215.0 * 360) - 180;\r\n  var altValue = ((bytes&#x5B;6]&lt;&lt;8)&gt;&gt;&gt;0) + bytes&#x5B;7];\r\n  var sign = bytes&#x5B;6] &amp; (1 &lt;&lt; 7);\r\n  if(sign){\r\n    decoded.alt = 0xFFFF0000 | altValue;\r\n  }else{\r\n    decoded.alt = altValue;\r\n  }\r\n  decoded.hdop = bytes&#x5B;8] \/ 10.0;\r\n  return decoded;\r\n}\r\n<\/pre>\n<p>Using this decoder has two advantages, you can see that the data you are sending makes sense and you verify that it is in the correct format to be understood by TTN Mapper.<\/p>\n<figure id=\"attachment_238\" aria-describedby=\"caption-attachment-238\" style=\"width: 290px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-238\" src=\"https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/ttn-payload.png\" alt=\"Example decoded payload containing lat, lon, alt and hdop\" width=\"290\" height=\"279\" \/><figcaption id=\"caption-attachment-238\" class=\"wp-caption-text\">Example decoded payload from a device<\/figcaption><\/figure>\n<p>The software for this is available from <a href=\"https:\/\/github.com\/computenodes\/pycom-gps-logger\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/computenodes\/pycom-gps-logger<\/a>. It forms two parts, a part to run on the device. This was programmed using <a href=\"https:\/\/code.visualstudio.com\/\" target=\"_blank\" rel=\"noopener\">Visual Studio Code<\/a> with the Pymakr plugin. Setup instructions are available from the <a href=\"https:\/\/docs.pycom.io\/chapter\/pymakr\/installation\/vscode.html\" target=\"_blank\" rel=\"noopener\">pycom docs<\/a>. Any details that are device specific are stored in config.py a default version is given in the repo and below. The correct details should be put in for your device.<\/p>\n<pre class=\"brush: python; title: Device configuration; notranslate\" title=\"Device configuration\">\r\nAPP_KEY = &quot;&quot; #Application key from the things network\r\nAPP_EUI = &quot;&quot;                 #The EUI for the app\r\nJOIN_TIMEOUT = 0                             #passed to the LoRaWAN join function\r\nGPS_TIMEOUT = 30                             #How long to wait for a GPS reading per attempt\r\nPOST_MESSAGE_SLEEP = 60 #How long to wait between messages - affects GPS sample rate when connected\r\nGPS_READ_INTERVAL = 10  #How often to read the GPS if not on the LoRaWAN network\r\n<\/pre>\n<p>TTN mapper relies on getting latitude, longitude, altitude and HDOP. The default library that pycom provide for the pytrack only provides the latitude and the longitude, as the rest of the data is not provided in the particular NMEA string that they are parsing. However, consulting the datasheet for the GPS module showed that the module also produces<\/p>\n<pre>GPGGA<\/pre>\n<p>NMEA strings which do contain the required information. The provided library was therefore modified to include an additional function which provides the required information. This will be tested a bit more comprehensively before submitting a pull request to add this to the core library.<\/p>\n<p>Once you have given the required details to TTN Mapper as per the <a href=\"http:\/\/ttnmapper.org\/faq.php\" target=\"_blank\" rel=\"noopener\">FAQ<\/a> you should see a purple marker appear which represents your mobile device, with coverage details being added to the map periodically. An example is shown below.<\/p>\n<figure id=\"attachment_234\" aria-describedby=\"caption-attachment-234\" style=\"width: 859px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-234\" src=\"https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/ttn-map.png\" alt=\"\" width=\"859\" height=\"566\" srcset=\"https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/ttn-map.png 859w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/ttn-map-300x198.png 300w, https:\/\/computenodes.net\/wp-content\/uploads\/2017\/09\/ttn-map-768x506.png 768w\" sizes=\"auto, (max-width: 859px) 100vw, 859px\" \/><figcaption id=\"caption-attachment-234\" class=\"wp-caption-text\">TTN Mapper screenshot showing some base stations (Blue) and 2 mobile nodes (Purple)<\/figcaption><\/figure>\n<p>As well as submitting the data to TTN mapper we wanted to keep a record of the positions from the device for a forthcoming project in which we would need the raw data to compare again. In order to do this we have a python application which subscribes to an MQTT stream from the application and logs data into a monogodb store.<\/p>\n<pre class=\"brush: jscript; title: Stored position details; notranslate\" title=\"Stored position details\">\r\n{\r\n        &quot;_id&quot; : ObjectId(&quot;59c641d6c7a447dd52f8ba75&quot;),\r\n        &quot;hdop&quot; : 1,\r\n        &quot;timestamp&quot; : &quot;2017-09-23 11:13:26&quot;,\r\n        &quot;lon&quot; : -1.39849,\r\n        &quot;alt&quot; : 70,\r\n        &quot;gateways&quot; : &#x5B;\r\n                {\r\n                        &quot;rssi&quot; : -96,\r\n                        &quot;snr&quot; : -1,\r\n                        &quot;gw_id&quot; : &quot;eui-b827ebfffee36ef8&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -102,\r\n                        &quot;snr&quot; : 9,\r\n                        &quot;gw_id&quot; : &quot;eui-7276fffffe0102df&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -72,\r\n                        &quot;snr&quot; : 9.8,\r\n                        &quot;gw_id&quot; : &quot;eui-b827ebfffeac4b12&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -104,\r\n                        &quot;snr&quot; : 9,\r\n                        &quot;gw_id&quot; : &quot;eui-7276fffffe0103f0&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -106,\r\n                        &quot;snr&quot; : 7,\r\n                        &quot;gw_id&quot; : &quot;eui-7276fffffe0103f0&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -122,\r\n                        &quot;snr&quot; : -7,\r\n                        &quot;gw_id&quot; : &quot;eui-7276fffffe0103ec&quot;\r\n                },\r\n                {\r\n                        &quot;rssi&quot; : -99,\r\n                        &quot;snr&quot; : 8,\r\n                        &quot;gw_id&quot; : &quot;eui-7276fffffe0103ec&quot;\r\n                }\r\n        ],\r\n        &quot;lat&quot; : 50.93727,\r\n        &quot;serial&quot; : &quot;70B3D5499247643E&quot;,\r\n        &quot;sf&quot; : &quot;SF7BW125&quot;\r\n}\r\n<\/pre>\n<p>Creating a GPS position logger for the LoRaWAN network has been an interesting task, and it has been very easy to iterate and add functionality. It is a very simple project to complete and it can be interesting seeing which base-stations are able to receive your signals.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Having setup some LoRaWAN base stations to provide coverage of the Southampton area we wanted to see if there are any black spots without coverage, and therefore where new basestations should be deployed. We are also looking to do more work with positioning of LoRaWAN devices so need transmissions from known locations. Rather than developing<br \/><a href=\"https:\/\/computenodes.net\/2017\/09\/27\/mapping-lorawan-coverage-in-southampton\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Mapping LoRaWAN coverage in Southampton<\/span> <\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9,2,11],"tags":[],"class_list":["post-220","post","type-post","status-publish","format-standard","hentry","category-gps","category-lorawan","category-pycom","col-1"],"_links":{"self":[{"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/posts\/220","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/comments?post=220"}],"version-history":[{"count":17,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/posts\/220\/revisions"}],"predecessor-version":[{"id":245,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/posts\/220\/revisions\/245"}],"wp:attachment":[{"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/media?parent=220"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/categories?post=220"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/computenodes.net\/wp-json\/wp\/v2\/tags?post=220"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}