... | ... | @@ -2,35 +2,36 @@ |
|
|
|
|
|
## Software
|
|
|
|
|
|
The code for the communication board can be found in `/code`. The code for the application board we used during the [evaluation of STeC](https://gitlab.ethz.ch/tec/public/stec/stec-wiki/-/wikis/home#conference-publications) is available on request.
|
|
|
- The code for the **communication board** can be found in [`/code`](https://gitlab.ethz.ch/tec/public/stec/stec-code).
|
|
|
- The code for the specific **application board** we used during the [evaluation of STeC](https://gitlab.ethz.ch/tec/public/stec/stec-wiki/-/wikis/home#conference-publications) is available on request.
|
|
|
|
|
|
### Get started
|
|
|
1. Clone the code repository (including submodules):
|
|
|
`git clone --recursive https://gitlab.ethz.ch/tec/public/stec/stec-code`
|
|
|
2. Follow the instructions in the [Flora Wiki](https://gitlab.ethz.ch/tec/public/flora/wiki/-/wikis/home#clone-compile-run) to compile and flash the code using the STMCubeIDE.
|
|
|
3. Clone the script repository to schedule tests and inspect the data:
|
|
|
`git clone --recursive https://gitlab.ethz.ch/tec/public/stec/stec-scripts`
|
|
|
3. Clone the script repository to schedule tests and inspect the data:
|
|
|
`git clone https://gitlab.ethz.ch/tec/public/stec/stec-scripts`
|
|
|
|
|
|
|
|
|
### Run Tests on FlockLab 2
|
|
|
* We provide scripts to run tests on the [FlockLab 2 testbed](https://www.flocklab.ethz.ch/).
|
|
|
* Shell script: `/code/Scripts/run_flocklab_test.sh`
|
|
|
* Python script: `/scripts/analysis/bin/stec-flocklab.py`
|
|
|
* Shell script: [`/code/Scripts/run_flocklab_test.sh`](https://gitlab.ethz.ch/tec/public/stec/stec-code/-/blob/master/Scripts/run_flocklab_test.sh)
|
|
|
* Python script: [`/scripts/analysis/bin/stec-flocklab.py`](https://gitlab.ethz.ch/tec/public/stec/stec-scripts/-/blob/master/analysis/bin/stec-flocklab.py)
|
|
|
|
|
|
|
|
|
### Software Development
|
|
|
|
|
|
### STM32CubeIDE
|
|
|
* The project has been created and edited using the [**STM32CubeIDE**](https://www.st.com/en/development-tools/stm32cubeide.html) (combination of former _Atollic TrueStudio_ and _STM32CubeMX_)
|
|
|
* Based on eclipse
|
|
|
* Main config of IDE project is stored in `.cproject` file
|
|
|
* Config of architecture (GPIOs etc.) are stored in `.ioc` file.
|
|
|
* The project has been created and edited using the [**STM32CubeIDE**](https://www.st.com/en/development-tools/stm32cubeide.html) (itself a combination of former _Atollic TrueStudio_ and _STM32CubeMX_)
|
|
|
* The IDE is based on eclipse
|
|
|
* The main config file of the IDE project is stored in the [`.cproject`](https://gitlab.ethz.ch/tec/public/stec/stec-code/-/blob/master/.cproject) file
|
|
|
* The architecture configurations (GPIOs etc.) are stored in the [`*.ioc`](https://gitlab.ethz.ch/tec/public/stec/stec-code/-/blob/master/comboard_stec.ioc) file.
|
|
|
|
|
|
|
|
|
## Hardware
|
|
|
* [Communication board](https://gitlab.ethz.ch/tec/public/dpp/dpp/blob/master/hardware/dpp2_sx1262/DPP2_ComBoard_SX1262_LoRa.pdf)
|
|
|
* [Application board](https://pub.tik.ee.ethz.ch/students/2017-HS/MA-2017-25.pdf)
|
|
|
|
|
|
More detailed schematics and layouts are available on request.
|
|
|
|
|
|
## FAQ
|
|
|
|
... | ... | @@ -38,10 +39,10 @@ The code for the communication board can be found in `/code`. The code for the a |
|
|
The name _STeC_ is an abbreviation of "**S**patial and **Te**mporal **C**orrelation", thereby stressing the novel design paradigm that the protocol is leveraging. Furthermore, the protocol has been designed by [TEC](https://tec.ee.ethz.ch/), the Computer Engineering Group at ETH Zurich.
|
|
|
|
|
|
### Where can I get the sensor data?
|
|
|
All data from our outdoor deployment is available through the [PermaSense GSN website](http://data.permasense.ch/data.html#data). The easiest way to access and download it is through our scripts (e.g. `scripts/analysis/data_management/data_manager.py`).
|
|
|
All data from our outdoor deployment is available through the [PermaSense GSN website](http://data.permasense.ch/data.html#data). The easiest way to access and download it is through our scripts (e.g. [`scripts/analysis/data_management/data_manager.py`](https://gitlab.ethz.ch/tec/public/stec/stec-scripts/-/blob/master/analysis/data_management/data_manager.py)).
|
|
|
|
|
|
### Can I see STeC in action?
|
|
|
We have a deployment currently running at [Dirruhorn, Switzerland](https://map.geo.admin.ch/?lang=en&topic=ech&bgLayer=ch.swisstopo.pixelkarte-farbe&layers=ch.swisstopo.zeitreihen,ch.bav.haltestellen-oev,ch.swisstopo.swisstlm3d-wanderwege,ch.astra.wanderland-sperrungen_umleitungen&layers_opacity=1,1,0.8,0.8&layers_visibility=false,true,false,false&layers_timestamp=18641231,,,&E=2632951.41&N=1107234.69&zoom=6). Use the monitoring scripts (e.g. `scripts/analysis/notebooks/stec_monitoring_7d.ipynb`) to get the most up-to-date version or run the script directly online by clicking [here](). Raw sensor data can always be inspected in real-time using the [PermaSense GSN website](http://data.permasense.ch/topology.html#topology).
|
|
|
We have a deployment currently running at [Dirruhorn, Switzerland](https://map.geo.admin.ch/?lang=en&topic=ech&bgLayer=ch.swisstopo.pixelkarte-farbe&layers=ch.swisstopo.zeitreihen,ch.bav.haltestellen-oev,ch.swisstopo.swisstlm3d-wanderwege,ch.astra.wanderland-sperrungen_umleitungen&layers_opacity=1,1,0.8,0.8&layers_visibility=false,true,false,false&layers_timestamp=18641231,,,&E=2632951.41&N=1107234.69&zoom=6). Use the monitoring scripts (e.g. [`scripts/analysis/notebooks/stec_monitoring_7d.ipynb`](https://gitlab.ethz.ch/tec/public/stec/stec-scripts/-/blob/master/analysis/notebooks/stec_monitoring_7d.ipynb)) to get the most up-to-date version or run the script [directly online](). Raw sensor data can always be inspected in real-time and downloaded using the [PermaSense GSN website](http://data.permasense.ch/topology.html#topology).
|
|
|
|
|
|
|
|
|
## Publications
|
... | ... | @@ -81,7 +82,7 @@ We have a deployment currently running at [Dirruhorn, Switzerland](https://map.g |
|
|
|
|
|
|
|
|
## Contact Information
|
|
|
Please contact us if you have feedback, proposals, bug reports, etc.
|
|
|
Please contact us if you have feedback, proposals, bug reports, etc. :
|
|
|
|
|
|
[Andreas Biri](https://tec.ee.ethz.ch/the-group/people/person-detail.html?persid=187635)
|
|
|
PhD Student
|
... | ... | |