{"id":358,"date":"2021-03-01T14:55:00","date_gmt":"2021-03-01T14:55:00","guid":{"rendered":"https:\/\/www.maibornwolff.de\/en\/?post_type=know-how&#038;p=358"},"modified":"2022-08-04T09:39:43","modified_gmt":"2022-08-04T07:39:43","slug":"talk-coap-me-iot-over-bluetooth-low-energy","status":"publish","type":"know-how","link":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/","title":{"rendered":"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy"},"content":{"rendered":"<div class=\"wp-block-cover is-light\"><span aria-hidden=\"true\" class=\"wp-block-cover__background has-white-background-color has-background-dim-100 has-background-dim\"><\/span><div class=\"wp-block-cover__inner-container is-layout-flow wp-block-cover-is-layout-flow\">\n<div style=\"height:150px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns are-vertically-aligned-center is-layout-flex wp-container-core-columns-is-layout-1 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\"><div class=\"wp-block-post-date\"><time datetime=\"2021-03-01T14:55:00+01:00\">March 1, 2021<\/time><\/div><\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<div class=\"wp-block-group author-box is-layout-flow wp-block-group-is-layout-flow\">\n<figure class=\"wp-block-image alignleft size-full is-resized is-style-rounded\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/MatthiasNk.jpg\" alt=\"\" class=\"wp-image-1954\" width=\"50\" height=\"50\"><\/figure>\n\n\n\n<p class=\"has-sm-font-size\">Matthias Nefzger<\/p>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"yoast-reading-time__wrapper\"><span class=\"yoast-reading-time__icon\"><svg aria-hidden=\"true\" focusable=\"false\" data-icon=\"clock\" width=\"20\" height=\"20\" fill=\"none\" stroke=\"currentColor\" style=\"display:inline-block;vertical-align:-0.1em\" role=\"img\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewbox=\"0 0 24 24\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z\"><\/path><\/svg><\/span><span class=\"yoast-reading-time__spacer\" style=\"display:inline-block;width:1em\"><\/span><span class=\"yoast-reading-time__descriptive-text\">Estimated reading time: <\/span><span class=\"yoast-reading-time__reading-time\">10<\/span><span class=\"yoast-reading-time__time-unit\"> minutes<\/span><\/p>\n<\/div>\n<\/div>\n\n\n\n<div class=\"maibornwolff-post-main-term\">\n    Techblog<\/div>\n\n\n<h1 class=\"has-text-align-center wp-block-post-title\">Talk CoAP to me \u2013 IoT over Bluetooth Low Energy<\/h1>\n\n<div class=\"wp-block-post-excerpt\"><p class=\"wp-block-post-excerpt__excerpt\">In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much&hellip; <\/p><\/div>\n\n<div class=\"wp-block-maibornwolff-terms-list \">\n    <div class=\"wp-block-buttons\">\n                    <div class=\"wp-block-button is-style-outline\">\n                                    <span class=\"wp-block-button__link\">Techblog<\/span>\n                            <\/div>\n            <\/div>\n<\/div>\n\n\n\n<div style=\"height:120px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-maibornwolff-scroll-down\"><a href=\"#\"><span class=\"icon arrow-down-icon\"><\/span><\/a><\/div>\n<\/div><\/div><div style=\"height:180px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div><figure class=\"wp-block-image alignfull size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"461\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879-1024x461.jpeg\" alt=\"\" class=\"wp-image-2044\" srcset=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879-1024x461.jpeg 1024w, https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879-300x135.jpeg 300w, https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879-768x346.jpeg 768w, https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879-1536x691.jpeg 1536w, https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg 2000w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div><div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-2 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:40%\">\n<div class=\"wp-block-maibornwolff-sticky-container\">\n<h4 class=\"wp-block-heading\" id=\"h-\"><\/h4>\n\n\n<div class=\"wp-block-maibornwolff-table-of-contents\">\n    <ol>\n                    <li>\n                <a href=\"#h-the-constrained-application-protocol\">\n                    The Constrained Application Protocol                <\/a>\n            <\/li>\n                    <li>\n                <a href=\"#h-coap-over-bluetooth-low-energy-ble\">\n                    CoAP over Bluetooth Low Energy (BLE)                <\/a>\n            <\/li>\n                    <li>\n                <a href=\"#h-putting-it-together\">\n                    Putting it together                <\/a>\n            <\/li>\n                    <li>\n                <a href=\"#h-references\">\n                    References                <\/a>\n            <\/li>\n            <\/ol>\n<\/div>\n\n\n<div class=\"wp-block-maibornwolff-share\">\n    <p>Share<\/p>\n    <ul>\n                <li>\n            <a href=\"mailto:?body=https%3A%2F%2Fwww.maibornwolff.de%2Fen%2Fknow-how%2Ftalk-coap-me-iot-over-bluetooth-low-energy%2F\"\n               title=\"Share via link\"\n               target=\"_blank\"\n            >\n                <span class=\"icon link-icon\"><\/span>\n            <\/a>\n        <\/li>\n                <li>\n            <a href=\"https:\/\/twitter.com\/intent\/tweet?url=https%3A%2F%2Fwww.maibornwolff.de%2Fen%2Fknow-how%2Ftalk-coap-me-iot-over-bluetooth-low-energy%2F\"\n               title=\"Share via twitter\"\n               target=\"_blank\"\n            >\n                <span class=\"icon twitter-icon\"><\/span>\n            <\/a>\n        <\/li>\n                <li>\n            <a href=\"https:\/\/www.xing.com\/spi\/shares\/new?url=https%3A%2F%2Fwww.maibornwolff.de%2Fen%2Fknow-how%2Ftalk-coap-me-iot-over-bluetooth-low-energy%2F\"\n               title=\"Share via xing\"\n               target=\"_blank\"\n            >\n                <span class=\"icon xing-icon\"><\/span>\n            <\/a>\n        <\/li>\n                <li>\n            <a href=\"https:\/\/linkedin.com\/sharing\/share-offsite\/?url=https%3A%2F%2Fwww.maibornwolff.de%2Fen%2Fknow-how%2Ftalk-coap-me-iot-over-bluetooth-low-energy%2F\"\n               title=\"Share via linkedin\"\n               target=\"_blank\"\n            >\n                <span class=\"icon linkedin-icon\"><\/span>\n            <\/a>\n        <\/li>\n                <li>\n            <a href=\"https:\/\/facebook.com\/sharer\/sharer.php?u=https%3A%2F%2Fwww.maibornwolff.de%2Fen%2Fknow-how%2Ftalk-coap-me-iot-over-bluetooth-low-energy%2F\"\n               title=\"Share via facebook\"\n               target=\"_blank\"\n            >\n                <span class=\"icon facebook-icon\"><\/span>\n            <\/a>\n        <\/li>\n            <\/ul>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:60%\">\n<p>In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind. To implement the setup of our Android app, we had to find solutions for problems such as a limited packet size of BLE and limitations when working with streams of data. I will outline our approach in the first part of this article and then provide some actual examples of the implementation for CoAP over BLE.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture1.png\" alt=\"\" class=\"wp-image-2474\" title=\"IoT over Bluetooth Low Energy with CoAP\"><\/figure>\n\n\n\n<p>A sensor is connected to a gateway application over Bluetooth Low Energy<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-the-constrained-application-protocol\">The Constrained Application Protocol<\/h2>\n\n\n\n<p>Before diving into the details of the Android implementation, let us first get an understanding of the Constrained Application Protocol.<\/p>\n\n\n\n<p>In 2014, the IETF published RFC 7252 describing a communication protocol made for the Internet of things:<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>&ldquo;The Constrained Application Protocol (CoAP) is a specialized web transfer protocol for use with constrained nodes and constrained networks in the Internet of Things. The protocol is designed for machine-to-machine (M2M) applications such as smart energy and building automation.&rdquo;<\/p><\/blockquote>\n\n\n\n<p>The overarching design paradigm for CoAP is simplicity. It was designed to run on devices with very little computing power (it can be implemented on sensors with as little as 10KiB of RAM). Most implementations of CoAP use UDP as a transport protocol as it adds only a small overhead (compared to e.g. TCP).<\/p>\n\n\n\n<p>The basic concept of CoAP is very similar to the well know and widely used REST over HTTP model. Similar to REST, a CoAP client can access resources on a CoAP server using methods such as GET, POST, PUT or DELETE. As such, CoAP can be easily mapped to HTTP and vice-versa.<\/p>\n\n\n\n<p>For a more detailed look on the specification of CoAP, I recommend checking out the following resources:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><a href=\"https:\/\/coap.technology\/\" target=\"_blank\" rel=\"noreferrer noopener\">coap.technology\/<\/a><\/li><li><a href=\"https:\/\/tools.ietf.org\/html\/rfc7252\" target=\"_blank\" rel=\"noreferrer noopener\">tools.ietf.org\/html\/rfc7252<\/a><\/li><li><a href=\"https:\/\/www.droidcon.com\/media-detail?video=470569808\" target=\"_blank\" rel=\"noreferrer noopener\">Video at droidcon.com<\/a><\/li><\/ul>\n\n\n\n<p>Since the introduction of CoAP, quite a large number of implementations was published for a variety of languages. You can find an overview of popular libraries&nbsp;<a href=\"https:\/\/coap.technology\/impls.html\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture3.png\" alt=\"\" class=\"wp-image-2475\" title=\"Figure 2: CoAP implementations exist for many languages\"><\/figure>\n\n\n\n<p>CoAP implementations exist for many languages<\/p>\n\n\n\n<p>The large majority of these implementations have one thing in common: they implement the CoAP as a protocol on top of UDP (and in some cases, TCP).<\/p>\n\n\n\n<p>This brings us to the main topic of this article &ndash; we want to communicate with a sensor (= a CoAP server) over Bluetooth Low Energy. What changes in comparison to a usage over UDP?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-coap-over-bluetooth-low-energy-ble\">CoAP over Bluetooth Low Energy (BLE)<\/h2>\n\n\n\n<p>In order to understand the difficulties of adapting CoAP to Bluetooth, one must understand some of the basics of Bluetooth Low Energy.<\/p>\n\n\n\n<p>Two important terms when working with Bluetooth Low Energy are ATT and GATT. ATT, the Attribute Protocol, is a very low-level mechanism that defines how to transfer a unit of data. A unit of data is called an Attribute. On top of ATT, an additional layer of abstraction is defined, called GATT, the Generic Attribute Profile. GATT introduces the concepts of Profiles, Services and Characteristics that are well known to any developer who has worked with BLE. Typically, a BLE client discovers the services of a BLE server and then reads from or writes to specific characteristics.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture4.png\" alt=\"\" class=\"wp-image-2477\" title=\"CoAP Figure 3: GATT defines Profiles, Services, and Characteristics\"><\/figure>\n\n\n\n<p>GATT defines Profiles, Services, and Characteristics<\/p>\n\n\n\n<p>The BLE standard defines many profiles for common use cases, such as a Heart Rate Profile tailored to fitness sensors.<\/p>\n\n\n\n<p>With these concepts in mind, we can have a detailed look at the two challenges we faced while implementing CoAP over BLE.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Challenge #1 &ndash; Packet Size<\/h4>\n\n\n\n<p>As mentioned in the intro to CoAP, the RFC specification is focused on CoAP over UDP. For example, this becomes apparent in the section specifying the payload length: &ldquo;The payload data extends from after the marker to the end of the UDP datagram&rdquo; [<a href=\"https:\/\/www.maibornwolff.de\/en\/blog\/talk-coap-me-iot-over-bluetooth-low-energy#1\">1<\/a>]. Looking at the specification of UDP, we quickly discover that one UDP packet can have a size of up to 65535 bytes. On the other hand, the maximum size of an ATT packet (and thus of the data unit behind GATT) is 512 bytes. Even more, in Android the ATT packet size (called MTU) is by default set to 23 bytes.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture5.png\" alt=\"\" class=\"wp-image-2478\" title=\"Figure 4: UDP packets can be much larger than GATT packets\"><\/figure>\n\n\n\n<p>UDP packets can be much larger than GATT packets<\/p>\n\n\n\n<p>What are the consequences of these size limits? If we wanted to send or receive a CoAP message with a payload greater than 512 bytes, we&rsquo;d have to manually split up the message and take care of the transmission of multiple parts.<\/p>\n\n\n\n<p>Other open questions come to mind: How can we map CoAP requests to GATT characteristics? How to structure the GATT services? Is there one characteristic for each CoAP endpoint?<\/p>\n\n\n\n<p>Luckily, there is a solution that circumvents these questions: Instead of implementing a complex application-side logic, we use a special kind of GATT Service called UART Service. This service emulates a serial interface and offers two characteristics, one for reading and on for writing (Rx and Tx). These two characteristics can be used to transfer a stream of data without size restrictions. When writing to the server&rsquo;s receiving characteristic Rx, our CoAP message is automatically split (by Android) into small packets with a payload of 20 bytes. The CoAP server can simply read from the received stream of small packets and reconstruct a complete CoAP message.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture6.png\" alt=\"\" class=\"wp-image-2479\" title=\"Figure 5: The UART service works like a stream of small chunks\"><\/figure>\n\n\n\n<p>The UART service works like a stream of small chunks<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Challenge #2 &ndash; Delimiting packets in a stream<\/h4>\n\n\n\n<p>By using the stream-like serial interface of the UART service, we avoid a lot of work on application-side logic. However, with this decision, a new challenge appears: How can the receiver of the stream reconstruct the containing CoAP messages? After all, we send small chunks of messages on a stream of bytes, so one layer below the actual abstraction of CoAP.<\/p>\n\n\n\n<p>The answer is as simple as it is old: We apply the &ldquo;Serial Line Internet Protocol&rdquo; (or SLIP) before writing the resulting bytes to the UART stream. SLIP was published in RFC 1055 [<a href=\"#2\">2<\/a>] in 1988 as an easy and lightweight way of encapsulating IP packets. The algorithm is extremely simple: appending a special END byte (0xC0) to each message allows the receiver to separate incoming bytes by searching for the occurrence of this special byte. Three other bytes are used to escape the END byte if it occurs in the regular payload. Thus, SLIP can be summarized as follows:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Append the special &#8220;END&#8221; byte to each message<\/li><li>If the END byte occurs in the data to be sent, the two-byte sequence ESC and ESC_END is sent instead<\/li><li>If the ESC byte occurs in the data, the two-byte sequence ESC and ESC_ESC is sent<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture7-1024x243.png\" alt=\"\" class=\"wp-image-2480\" title=\"Figure 6: A special END byte delimits single messages\"><\/figure>\n\n\n\n<p>A special END byte delimits single messages<\/p>\n\n\n\n<p>This algorithm is an easy and fast-to-implement way of separating our CoAP messages in a stream of bytes.<\/p>\n\n\n\n<pre class=\"wp-block-code is-style-light-theme has-light-light-grey-background-color has-background\"><code>fun encode(data: ByteArray): ByteArray {\n\n    val encoded = ByteArrayOutputStream()\n\n \n\n    data.forEach { byte -&gt;\n\n        when (byte.toInt()) {\n\n            0xC0 -&gt; {\n\n                encoded.write(0xDB)\n\n                encoded.write(0xDC)\n\n            }\n\n            0xDB -&gt; {\n\n                encoded.write(0xDB)\n\n                encoded.write(0xDD)\n\n            }\n\n            else -&gt; encoded.write(byte.toInt())\n\n        }\n\n    }\n\n \n\n    encoded.write(0xC0)\n\n    return encoded.toByteArray()\n\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-putting-it-together\">Putting it together<\/h2>\n\n\n\n<p>Let&rsquo;s take a look at how the described steps and pieces fall into place.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/2022\/06\/picture8-1024x574.png\" alt=\"\" class=\"wp-image-2482\" title=\"Figure 7: CoAP over Bluetooth Low Energy\"><\/figure>\n\n\n\n<p>CoAP over Bluetooth Low Energy, separated into a CoAP layer and a BLE layer<\/p>\n\n\n\n<p>First off, we decided to use a UART service implementation to send and receive bytes between the two devices. This circumvents the question of how to map CoAP endpoints to specific BLE characteristics and allows us to send CoAP messages of arbitrary size. In order to delimit single CoAP messages in the UART stream, we apply the SLIP algorithm which appends a special END byte to each message.<\/p>\n\n\n\n<p>From the perspective of the Android app, each message thus goes through the same steps: First, a CoAP request message is constructed with the required headers, options, payload, and token. The token is saved in conjunction with a&nbsp;<code>RequestType<\/code>&nbsp;in order to know how to parse the payload of incoming CoAP messages.<\/p>\n\n\n\n<pre class=\"wp-block-code has-light-light-grey-background-color has-background\"><code>\/** CoAP layer - construct token and CoAP message **\/\nfun requestTemperature() {\n&nbsp; &nbsp; val token = generateToken()\n&nbsp; &nbsp; sendCoapRequest(\n&nbsp; &nbsp; &nbsp; &nbsp; coapMessageFactory.createGetRequest(\"device\/temperature\", token)\n&nbsp; &nbsp; )\n&nbsp; &nbsp; pendingRequests[token] = RequestType.TEMPERATURE\n}\n<\/code><\/pre>\n\n\n\n<p>The CoAP message object is then converted to a Byte Array, which is encoded by the SLIP algorithm. The resulting Byte Array is written to the UART Rx characteristic of the remote device. Android takes care of splitting the message into smaller chunks.<\/p>\n\n\n\n<pre class=\"wp-block-code has-light-light-grey-background-color has-background\"><code>\/** BLE layer - encode and write message **\/\nfun sendCoapRequest(coapMessage: CoapMessage) {\n&nbsp; &nbsp; coapMessage.toByteArray()?.let { rawData-&gt;\n&nbsp; &nbsp; &nbsp; &nbsp; val encodedMessage = slipAdapter.encode(rawData)\n&nbsp; &nbsp; &nbsp; &nbsp; writeCharacteristic(uartRxCharacteristic, encodedMessage)\n&nbsp; &nbsp; }\n}\n<\/code><\/pre>\n\n\n\n<p>When receiving new data, small chunks of bytes arrive in our app at the subscriber for the Tx characteristic of the remote device (in&nbsp;<code>onReceive()<\/code>). The new data is appended to an internal buffer. With each new update, the SLIP algorithm searches for the occurrence of the END byte in this buffer and splits the stream into complete messages. As a last step, we clear the completed messages from the buffer and keep only the remaining, still incomplete bytes.<\/p>\n\n\n\n<pre class=\"wp-block-code has-light-light-grey-background-color has-background\"><code>\/** BLE layer - receive and decode bytes **\/\n\nvar buffer = ByteArray(0)\n\nfun onReceive(newData: ByteArray?) {\n\n    newData?.let { data -&gt;\n\n        buffer += data\n\n        val decoded: DecodeResult = slipAdapter.decode(buffer)\n\n        scope.launch {\n\n            decoded.messages.forEach { m -&gt;\n\n                responseChannel.send(m)\n\n            }\n\n        }\n\n        buffer = buffer.copyOfRange(result.endIndex + 1, buffer.size)\n\n    }\n\n}<\/code><\/pre>\n\n\n\n<p>Each complete message is parsed as a CoAP message. The app then checks the received CoAP token to determine if the received message is an expected response. If this check succeeds, the payload is further processed by the business components of the app (in&nbsp;<code>handleExpectedMessage()<\/code>).<\/p>\n\n\n\n<pre class=\"wp-block-code has-light-light-grey-background-color has-background\"><code>\/** CoAP layer - parse and handle CoAP message **\/\nfun handleMessage(data: ByteArray) {\n&nbsp; &nbsp; val coapMessage = coapMessageFactory.fromByteArray(data)\n&nbsp; &nbsp; coapMessage?.let { message -&gt;\n&nbsp; &nbsp; &nbsp; &nbsp; val token = message.token\n&nbsp; &nbsp; &nbsp; &nbsp; val requestType = pendingRequests[token]\n&nbsp; &nbsp; &nbsp; &nbsp; return if (requestType == null) {\n&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; handleUnexpectedMessage(message)\n&nbsp; &nbsp; &nbsp; &nbsp; } else {\n&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; handleExpectedMessage(requestType, message, token)\n&nbsp; &nbsp; &nbsp; &nbsp; }\n&nbsp; &nbsp; } ?: logger.error(\"Unable to parse CoAP message\")\n}\n<\/code><\/pre>\n\n\n\n<p>Since our initial implementation of CoAP over BLE a few months ago, the solution has proven to be easy to maintain and extend.<\/p>\n\n\n\n<p>Although developers initially need to learn how to work with CoAP, this is quickly accomplished due to the similarity to REST over HTTP. In my opinion, relying on an established standard protocol such as CoAP has many advantages over rolling your own BLE communication protocol.<\/p>\n\n\n\n<p>Have you worked with CoAP? What are your thoughts and what were your challenges?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-references\">References<\/h2>\n\n\n\n<p><a>[1]<\/a>&nbsp;<a href=\"https:\/\/tools.ietf.org\/html\/rfc7252#section-3\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/tools.ietf.org\/html\/rfc7252#section-3<\/a><\/p>\n\n\n\n<p id=\"2\"><a>[2]<\/a>&nbsp;<a href=\"https:\/\/tools.ietf.org\/html\/rfc1055\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/tools.ietf.org\/html\/rfc1055<\/a><\/p>\n\n\n\n<div style=\"height:130px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<hr class=\"wp-block-separator has-text-color has-lightest-grey-color has-alpha-channel-opacity has-lightest-grey-background-color has-background is-style-wide\">\n\n\n\n<div style=\"height:110px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-about-the-author\">About the author<\/h3>\n\n\n\n<div class=\"wp-block-group author-bio-box is-layout-flow wp-block-group-is-layout-flow\">\n<div class=\"wp-block-group author-box is-layout-flow wp-block-group-is-layout-flow\">\n<figure class=\"wp-block-image size-full is-resized is-style-rounded\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/MatthiasNk.jpg\" alt=\"\" class=\"wp-image-1954\" width=\"78\" height=\"78\"><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-matthias-nefzger\">Matthias Nefzger<\/h4>\n\n\n\n<p>Senior Lead IT Architect <\/p>\n<\/div>\n\n\n\n<p><\/p>\n<\/div>\n\n\n\n<p><\/p>\n<\/div>\n<\/div><div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-1 wp-block-buttons-is-layout-flex\">\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much [&hellip;]<\/p>\n","protected":false},"featured_media":2044,"template":"","meta":{"_trash_the_other_posts":false,"maibornwolff-header-color":"","maibornwolff-header-menu-visibility":"","maibornwolff-footer-display":"","secondary_title":"","footnotes":""},"categories":[23],"tags":[],"main-color":[],"class_list":["post-358","know-how","type-know-how","status-publish","has-post-thumbnail","hentry","category-techblog"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v24.1 (Yoast SEO v24.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Talk CoAP to me \u2013 IoT over Bluetooth Low Energy | MaibornWolff<\/title>\n<meta name=\"description\" content=\"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy\" \/>\n<meta property=\"og:description\" content=\"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/\" \/>\n<meta property=\"og:site_name\" content=\"MaibornWolff\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-04T07:39:43+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg\" \/>\n\t<meta property=\"og:image:width\" content=\"2000\" \/>\n\t<meta property=\"og:image:height\" content=\"900\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/\",\"url\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/\",\"name\":\"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy | MaibornWolff\",\"isPartOf\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg\",\"datePublished\":\"2021-03-01T14:55:00+00:00\",\"dateModified\":\"2022-08-04T07:39:43+00:00\",\"description\":\"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage\",\"url\":\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg\",\"contentUrl\":\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg\",\"width\":2000,\"height\":900},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.maibornwolff.de\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#website\",\"url\":\"https:\/\/www.maibornwolff.de\/en\/\",\"name\":\"MaibornWolff\",\"description\":\"people. code. commitment.\",\"publisher\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.maibornwolff.de\/en\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#organization\",\"name\":\"MaibornWolff\",\"url\":\"https:\/\/www.maibornwolff.de\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/12\/maibornwolff-logo-white.svg\",\"contentUrl\":\"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/12\/maibornwolff-logo-white.svg\",\"width\":182,\"height\":91,\"caption\":\"MaibornWolff\"},\"image\":{\"@id\":\"https:\/\/www.maibornwolff.de\/en\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy | MaibornWolff","description":"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/","og_locale":"en_US","og_type":"article","og_title":"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy","og_description":"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.","og_url":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/","og_site_name":"MaibornWolff","article_modified_time":"2022-08-04T07:39:43+00:00","og_image":[{"width":2000,"height":900,"url":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/","url":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/","name":"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy | MaibornWolff","isPartOf":{"@id":"https:\/\/www.maibornwolff.de\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage"},"image":{"@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage"},"thumbnailUrl":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg","datePublished":"2021-03-01T14:55:00+00:00","dateModified":"2022-08-04T07:39:43+00:00","description":"In this article, I will describe the setup of an Android app and a sensor with a focus on the Bluetooth communication between the two devices. We chose to use the Constrained Application Protocol (CoAP) as the communication protocol. CoAP was designed to be a perfect match for IoT use-cases as it has a much smaller overhead in comparison to other protocols such as HTTP. However, CoAP was not designed with Bluetooth Low Energy (BLE) in mind.","breadcrumb":{"@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#primaryimage","url":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg","contentUrl":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/07\/270537879.jpeg","width":2000,"height":900},{"@type":"BreadcrumbList","@id":"https:\/\/www.maibornwolff.de\/en\/know-how\/talk-coap-me-iot-over-bluetooth-low-energy\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.maibornwolff.de\/en\/"},{"@type":"ListItem","position":2,"name":"Talk CoAP to me \u2013 IoT over Bluetooth Low Energy"}]},{"@type":"WebSite","@id":"https:\/\/www.maibornwolff.de\/en\/#website","url":"https:\/\/www.maibornwolff.de\/en\/","name":"MaibornWolff","description":"people. code. commitment.","publisher":{"@id":"https:\/\/www.maibornwolff.de\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.maibornwolff.de\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.maibornwolff.de\/en\/#organization","name":"MaibornWolff","url":"https:\/\/www.maibornwolff.de\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.maibornwolff.de\/en\/#\/schema\/logo\/image\/","url":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/12\/maibornwolff-logo-white.svg","contentUrl":"https:\/\/www.maibornwolff.de\/wp-content\/uploads\/sites\/2\/2022\/12\/maibornwolff-logo-white.svg","width":182,"height":91,"caption":"MaibornWolff"},"image":{"@id":"https:\/\/www.maibornwolff.de\/en\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/know-how\/358","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/know-how"}],"about":[{"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/types\/know-how"}],"version-history":[{"count":7,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/know-how\/358\/revisions"}],"predecessor-version":[{"id":2798,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/know-how\/358\/revisions\/2798"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/media\/2044"}],"wp:attachment":[{"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/media?parent=358"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/categories?post=358"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/tags?post=358"},{"taxonomy":"main-color","embeddable":true,"href":"https:\/\/www.maibornwolff.de\/en\/wp-json\/wp\/v2\/main-color?post=358"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}