Spreadsheet for LoRa airtime calculation

Just now, I wanted to do some bandwidth calculations for LoRa, but I couldn’t find any easy to use tables with examples or online calculators (and didn’t want to download some Windows-only LoRa Calculator tool). So I took the formula from an application note from Semtech and put it into a spreadsheet, which seems to work fine.

Spreadsheet is replaced by The Things Network’s Airtime Calculator:
See: https://www.thethingsnetwork.org/airtime-calculator/

12 Likes

@matthijs Thanks for this.

Something I’m trying to do with the lora calculator with LoRaWAN.
Assume that payload is the encrypted?
If so how are getting the encrypted payload length?
Also I thought Explicit header needs to be on?

Very nice!

One remark to prevent confusion: the payload size in your spreadsheet is the LoRa payload, so including LoraWAN header. A user should add 13 bytes to his own payload to get the correct numbers.

@thomas I think usually at least 13 [ MHDR (1) + DevAddr (4) + FCtrl (1) + FCnt (2) + Fport(1) + MIC(4) ] in a packet with no options
@iikaw they payload size is independent from the encryption.

@w4e ok but the payload is encrypted before transmission therefore will affect “time on air” no?

The number of bits stay the same - so I would say no effect on airtime.

1 Like

@w4e thanks hadn’t I hadn’t realised that.

Thanks, 13 it is.

Thanks for the additions, I’ve added some clarifications to the sheet.

im not an expert, but shouldn’t Preamble, PHDR, CRC be included as well?

The preamble is taken into account (you specify the number of preamble symbols in the sheet). The PHDR and (header) CRC are included if you specify “disable header” as 0 in the sheet. The payload CRC is part of the payload.

I guess not, but: is there any option in The Things Network to skip the LoRaWAN headers?

Like in a pet finder use case, one cannot send coordinates too often, due to the 1% duty cycle and 30 seconds/day Fair Access Policy. But even sending an empty “alive” message (for which a Class A node could then receive some specific reply to start sending coordinates) would take 1.16 seconds on SF12, for just the 13 bytes of the LoRaWAN header, hence would be limited to 26 empty packets a day…

Also location by triangulation would need some data to be sent. And some say moving nodes should always use SF12, though others have different experiences.

I’ve adjusted this nice sheet a bit, to split application payload and LoRaWAN headers, to show the results of all spread factors, and to include the maximum number of messages to adhere to the TTN Fair Access Policy.

Good to see how the number of symbols decreases when the connection quality drops (assuming that is correct…), and how it only partly depends on the application payload. And scary how on low data rates the TTN Fair Access Policy is really limiting.

@matthijs, if you like these changes then maybe copy them into your sheet, to keep the existing URL? I can then delete this very post.

See https://docs.google.com/spreadsheets/d/1QvcKsGeTTPpr9icj4XkKXq4r2zTc2j0gsHLrnplzM3I/edit?usp=sharing

I had a short discussion with @htdvisser about some constants in the air time calculations used in ttntool. He suggested @Thomas might know more, so here goes:

  1. LoRaWAN might have a fixed coding rate of 1? (So, CR=1.) I cannot find that in the specification. Even more: it does mention it explicitly for transmission of Class B beacons, so I doubt it’s also fixed for other operations?

  2. As LoRaWAN includes its own header, the explicit LoRa header might not be needed? (So, H=1.) That would indeed need a fixed coding rate to start with (which otherwise would be set in the LoRa header). But it would also need some way to determine the payload length (which is in the LoRa header, but not in the LoRaWAN header). I think the LoRaWAN specification claims the LoRa header is always included though:

    3.1 Uplink Messages
    […]
    Uplink messages use the LoRa radio packet explicit mode in which the LoRa physical header (PHDR) plus a header CRC (PHDR_CRC) are included.

  3. The LoRa Modem Design Guide on which @matthijs based his nice sheet, states:

    To avoid issues surrounding drift of the crystal reference oscillator due to either temperature change or motion, the low data rate optimization bit is used. Specifically for 125 kHz bandwidth and SF = 11 and 12, this adds a small overhead to increase robustness to reference frequency variations over the timescale of the LoRa packet.

    Does anyone know if this is automatically enabled by the chipset or the LoRaWAN stack, for SF11 and SF12? In ttntool this is currently indeed the case:

     dataRateOptimization := 0
     if int(spreadingFactor) >= 11 {
         dataRateOptimization = 1
     }

Arjan,

Thanks for caring about these details!

It is not fixed.

LoRaWAN does use the explicit header indeed.

The LoRaWAN stack handles this, for example an excerpt from the LMiC:

if ((sf == SF11 || sf == SF12) && getBw(LMIC.rps) == BW125) { mc1 |= SX1272_MC1_LOW_DATA_RATE_OPTIMIZE; }

1 Like

Okay, I’ve changed my copy of the sheet to auto-enable low data rate correction for SF11…12, and to also make clear that SF6 is not used in LoRaWAN. So basically LoRaWAN users only need to adjust the value for application payload to see the results.

(@matthijs, if you ever copy those changes in your sheet at the original URL then let me know, so I can delete these posts.)

@matthijs @arjanvanb
First of all, thank you very much for the sheet! Very useful for indication!

I have a question about payload comment in the sheet.
‘For LoRaWAN: maximum 55 for low data rates (SF12), up to about 222 bytes for best conditions (SF7).’

In the LoRaWAN spec (7.1.6 EU863-870 Maximum payload size) DR0 - DR2 have a maximum payload of 51 bytes (absence of Fopt)
Would this be a maximum of 51 for SF12 (DR0) according to this table, or am I missing something? Could you please elaborate?

Thank you!

@bvanderpol, that comment is something I added to the original sheet, and took from the FAQ.

The numbers were added to the FAQ after another discussion. But reading it again, that discussion is clear about the maximum, and indeed also mentions 55 but does not explicitly state that’s the minimum. So maybe the minimum in the FAQ is indeed wrong. (I also think the figures are slightly different for different regions? I’m not sure though.)

Very nice sheet, incredibly helpful!

I am still not quite sure how to calculate the header and payload sizes though. I am using a Waspmote to send frames containing sensor data. The frame is converted into a hexadecimal array—which is the required format by the LoRaWAN.sendUnconfirmed(...) function—by using the following util function:

char sendableString[frame.length*2 + 1];
Utils.hex2str(frame.buffer, sendableString, frame.length);

Here’s some output from a transmission:

Frame Length: 105
Frame (STR): <=>€#012345678#0123456789#0#BAT:42#IN_TEMP:17.00#GP_TC:-26.774#GP_HUM:25.70#GP_CO:25.918#GP_CO2:304.826#
Sendable string: 3c3d3e3f062330313233343536373823303132333435363738392330234241543a343223494e5f54454d503a31372e30302347505f54433a2d32362e3737342347505f48554d3a32352e37302347505f434f3a32352e3931382347505f434f323a3330342e38323623
strlen(sendableString): 210
sizeof(sendableString): 211
ADR: 1
DataRate: 5 (= SF7BW125)
Radio frequency: 869525000
Radio spreading factor: sf12
Radio bandwidth: 125
Radio coding rate: 4/5
Radio preamble length: 8

The corresponding TheThingsNetwork data field is:

PD0+gAYjNDAzMzE1ODQwI1dNMDIwMzIyMjIjMCNCQVQ6NDIjSU5fVEVNUDoxNy4wMCNHUF9UQzotMjYuNzc0I0dQX0hVTToyNS43MCNHUF9DTzoyNS45MTgjR1BfQ08yOjMwNC44MjYj

htdvisser’s ttntool calculated the air time to be 174.3ms, which working backwards in the spreadsheet suggests a payload of 87-90 bytes (if the header is 13 bytes).

So my question is simply: how do I know my payload and header sizes without working backwards based on air time calculated?

Note that there are some minor bugs there as mentioned above, for which I promised a pull request which I still did not create… Not sure how much that affects the result though.

As far as I know, the headers are always 13 bytes (as explained above), and the payload is just a number of bytes too, so 105 in your example. So in matthijs’ original sheet that’s 118 in total; in my version it’s 105 and 13.

By the way: Don’t. Send. Text. Don’t. Send. Text. It will eat your maximum air time with no good reason. Also, it seems #BAT:42# is a counter value? Then note that the headers already have a counter. [see responses below]

1 Like