{"id":2019,"date":"2017-02-10T10:23:27","date_gmt":"2017-02-10T10:23:27","guid":{"rendered":"http:\/\/www.daveakerman.com\/?p=2019"},"modified":"2017-02-10T10:26:26","modified_gmt":"2017-02-10T10:26:26","slug":"bbc-microbit-balloon-tracker","status":"publish","type":"post","link":"http:\/\/www.daveakerman.com\/?p=2019","title":{"rendered":"BBC Microbit Balloon Tracker"},"content":{"rendered":"

I’ve been meaning to do this for a while, and a short gap between projects gave me some time to try.<\/p>\n

The Microbit is (yet another) educational SBC, sitting somewhere between the Codebug and a Raspberry Pi. \u00a0Its processor has plenty enough flash memory and RAM to run a basic tracker (but more on that later), plus it has accelerometer and compass chips.<\/p>\n

\"\"<\/p>\n

Importantly, the Microbit has SPI and I2C busses plus a serial port, all brought out to the edge connector on the bottom. Rather than solder directly to the pads, I bought an edge connector and teeny prototyping board:<\/p>\n

\"\"<\/p>\n

I also bought a battery holder with cable and plug to suit the micro JST connector on the Microbit.<\/p>\n

Balloon Tracker Hardware<\/h2>\n

To make a balloon tracker, we also need to connect a suitable GPS (by which I mean, one that still sends positions when at high altitudes) and an ISM band radio transmitter. \u00a0I chose a UBlox module from Uputronics<\/a>:<\/p>\n

<\/p>\n

Usefully, this design includes an I2C port as well as the usual serial port. \u00a0Since the Microbit serial port is normally used by the debug connection to a PC, software development becomes more difficult if we use that serial port for the GPS, so I2C makes life much much easier.<\/p>\n

Now for the radio. \u00a0The most popular HAB option is the NTX2B radio transmitter, but that also needs a serial port, so instead I opted for a LoRa transceiver from Uputronics<\/a>:<\/p>\n

<\/p>\n

This has an SPI interface, so the serial port remains free for debug purposes.<\/p>\n

The first job was to get the devices wired together. \u00a0There’s not much space on this prototyping board, and it can be useful to keep the GPS away from the other devices anyway (less interference), so I put the GPS and radio on wire tails:<\/p>\n

\"\"<\/p>\n

GPS Software<\/h2>\n

There are several options for writing code for the Microbit, and I opted for MicroPython as I’ve been writing a lot pf Python lately, using the Mu editor\/downloader. \u00a0I started with some simple code to grab the NMEA data stream from the GPS, and this took just minutes to get going:<\/p>\n

I then ported my Pi Python GPS NMEA parser (which meant, just changing the code to use \u00a0the Microbit I2C library rather than the Pi serial port). \u00a0You can see my test program here<\/a> (but please don’t use that for a flight, as it was written for car use and therefore doesn’t put the GPS into flight mode!).<\/p>\n

LoRa Radio Software<\/h2>\n

I also have LoRa Python code from another project, so after testing that the device was connected OK (a few commands typed into the Microbit REPL interpreter), I ported that over. \u00a0The changes were for the SPI library, plus I had to remove all the LoRa register\/value definitions as they made the program source too large; the source is compiled on the device, so the compiler has a rather limited RAM workspace. \u00a0You can see the resulting test program here<\/a>.<\/p>\n

To receive LoRa transmissions, you need another LoRa device as a receiver, plus suitable software. \u00a0I used my C LoRa Gateway<\/a> code for the receiver:<\/p>\n

<\/p>\n

Balloon Tracker Program<\/h2>\n

So far so easy, and the end goal seemed close; once you have GPS and radio modules working, then you just need a small amount of extra code to format the GPS data as a string, adding a prefix (“$$” and the payload ID) and suffix (“*” then CRC then a line-feed), and then transmit the result over radio.<\/p>\n

However, as soon as I combined the GPS and LoRa code, the result wouldn’t even compile. \u00a0Remember that compilation happens on the Microbit, and my code was too large for that process:<\/p>\n

<\/p>\n

Fortunately it wasn’t much too larger, so I removed some code that wasn’t strictly necessary (mainly, the code that switches off unused GPS NMEA sentences) and soon the compiler was happy.<\/p>\n

The resulting code however was not happy. \u00a0Once the compiler has finished, the resulting bytecode is loaded into the Microbit’s RAM, which is shares with any data used by the program (variables, stack, temporary work areas). \u00a0The nature of Python is that memory gets allocated all the time, and freed up when necessary (i.e. when there’s little free memory available), and my program would run for a short while before crashing with an “out of memory” error when it tried to allocate more memory than was available. \u00a0This it working before it crashed:<\/p>\n

<\/p>\n

So, I had to reduce the memory footprint. \u00a0I’m used to doing that in C on microcontrollers, but MicroPython needs different techniques. \u00a0For example, C on a micro usually sits in flash memory, which often is less of a limit than is the working data in RAM, so you can sometimes rewrite the code to use less RAM without worrying that the new code uses more code memory. \u00a0Not so for MicroPython, where everything shares RAM. \u00a0So some things I tried actually made the situation (checked by calling gc.free_ram() in the main loop) worse. \u00a0So, for the most part, I managed to increase free RAM by removing code that I didn’t need. \u00a0Having done so, the program was stable though free memory went up and down cyclically as memory was allocated each loop and then eventually freed up.<\/p>\n

Some easy improvements came from removing the code to display GPS satellite count on the LEDs, and specifically importing only the required modules instead of the whole Microbit library. \u00a0The most relevant part of the code turned out to be the part that builds up an NMEA sentence. \u00a0In C you simply allocate enough memory for the longest sentence you need to parse, then place incoming bytes into that memory using a pointer or index, checking of course for buffer overruns. \u00a0In Python, strings are immutable so you can’t do this, and the temptation then is to do “string = string + new_character”. \u00a0Of course, the Python interpreter then allocates memory for the resulting string, marking the old string as “no longer in use” so it can be freed up sometime later. \u00a0It’s pretty easy to end up with lots of unused memory waiting to be freed. \u00a0For now, my NMEA code explicitly frees up memory as each new byte comes in. \u00a0I did briefly change the code to using bytearrays, which are close to what I would do in C, but free memory reduced slightly (I assume the source took more space) so I went back to the original code. \u00a0Longer term, I’ll ditch NMEA and write code to use the UBX binary protocol instead.<\/p>\n

The code has been running continuously now for over 12 hours, and the free-memory figure is solid (measured at the same point each time round the main loop). \u00a0I do need to add the flight-mode code, but that’s small and\u00a0shouldn’t<\/em> cause an issue :-). \u00a0If all is well then I hope to fly this (weather-permitting of course) on Sunday.<\/p>\n

Finally, here’s the result of receiving the telemetry on a Python LoRa gateway program that I’ve been working on lately:<\/p>\n

\"\"<\/p>\n","protected":false},"excerpt":{"rendered":"

I’ve been meaning to do this for a while, and a short gap between projects gave me some time to try. The Microbit is (yet another) educational SBC, sitting somewhere between the Codebug and a Raspberry Pi. \u00a0Its processor has plenty enough flash memory and RAM to run a basic […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[4],"tags":[],"_links":{"self":[{"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/posts\/2019"}],"collection":[{"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2019"}],"version-history":[{"count":5,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/posts\/2019\/revisions"}],"predecessor-version":[{"id":2029,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=\/wp\/v2\/posts\/2019\/revisions\/2029"}],"wp:attachment":[{"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2019"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2019"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.daveakerman.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2019"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}