... | ... | @@ -6,7 +6,7 @@ Software for the [DPP2 LoRa Comboard](https://gitlab.ethz.ch/tec/public/dpp/dpp/ |
|
|
The flora software consists of the following components:
|
|
|
* **Flora Library**: The [`flora-lib`](https://gitlab.ethz.ch/tec/public/flora/flora-lib) (C code) is a library of software components shared by multiple projects (flora apps). It contains radio drivers, protocol implementations, utilities, etc.
|
|
|
* **Flora Apps**: Projects based on the `flora-lib`. See list below for details.
|
|
|
* **SX1262 Python Library**: The `sx1262` Python library implements a model of the SX1262 radio chip. For example it allows to calculate the time-on-air (ToA) for LoRa or FSK transmissions.
|
|
|
* **SX1262 Python Library**: The [`sx1262`](https://gitlab.ethz.ch/tec/public/flora/sx1262) Python library implements a model of the SX1262 radio chip. For example it allows to calculate the time-on-air (ToA) for LoRa or FSK transmissions.
|
|
|
|
|
|
|
|
|
### Flora Apps
|
... | ... | @@ -122,13 +122,13 @@ Flora modulations as defined in `radio_constants.c`: |
|
|
### SX1262 Time-on-Air (ToA)
|
|
|
Calculation of the time-on-air (ToA) of a packet is not straight-forward since the duration depends on many parameters and conditions. Options to determine the ToA:
|
|
|
* Formula for calculating the ToA of LoRa packets is given in the [SX1262 datasheet](https://www.semtech.com/products/wireless-rf/lora-core/sx1262).
|
|
|
* `flora-lib` (C code) provides the following methods:
|
|
|
* [`flora-lib`](https://gitlab.ethz.ch/tec/public/flora/flora-lib) (C code) provides the following methods:
|
|
|
* `gloria_get_toa()`: uses current modulation setting of gloria_interface, output in us
|
|
|
* `gloria_get_toa_sl()`: uses provided modulation index, output in us
|
|
|
* `radio_get_toa()`: uses provided modulation index, output in us
|
|
|
* `radio_get_toa_hs()`: uses provided modulation index, output hs_timer ticks
|
|
|
* `radio_get_toa_arb()`: arbitrary radio config, output in us
|
|
|
* `sx1262` Python library: <!--- FIXME: add link once sx1262 lib is public -->
|
|
|
* [`sx1262`](https://gitlab.ethz.ch/tec/public/flora/sx1262) (Python library):
|
|
|
* for flora modulations according to `radio_constants.c`: use `flora_toa(modIdx, phyPlLen)`
|
|
|
* for arbitrary radio settings: use the `LoraConfig` and `FskConfig` classes
|
|
|
|
... | ... | @@ -198,6 +198,11 @@ value = fl.readSymbolValue(elfPath, symbName, signed=False) |
|
|
fl.writeSymbolValue(elfPathPatched, symbName, symbReplace, signed=False)
|
|
|
```
|
|
|
|
|
|
### DPP Guides
|
|
|
[Guides in DPP wiki](https://gitlab.ethz.ch/tec/public/dpp/dpp/-/wikis/home#how-to) contain further infos about:
|
|
|
* Access serial output (UART) of the DPP2 ComBoard (on DevBoard)
|
|
|
* A guide to low-power modes
|
|
|
|
|
|
### FAQ
|
|
|
|
|
|
#### What does 'Flora' mean?
|
... | ... | |