lorawan

Módulo Lorawan NS-3

Este é um módulo NS-3 que pode ser usado para executar simulações de uma rede de Lorawan.

Links rápidos:

• Visão geral do modelo de simulação

• Documentação da API

Começando

Pré -requisitos

Para executar simulações usando este módulo, você primeiro precisa instalar o NS-3. Se você estiver no Ubuntu/Debian/Mint, poderá instalar os pacotes mínimos necessários da seguinte forma:

sudo apt install g++ python3 cmake ninja-build git ccache

Caso contrário, consulte diretamente a seção Pré-requisitos da página de instalação NS-3.

Nota: Embora o pacote ccache não seja estritamente necessário, ele é altamente recomendado. Pode aumentar significativamente os tempos de compilação futuros, economizando dezenas de minutos, embora com um custo de espaço em disco mais alto de aproximadamente 5 GB. Esse uso de espaço em disco pode ser reduzido através de uma configuração.

Então, você precisa:

1. Clone a principal base de código NS-3,
2. Clonar este repositório dentro do diretório src nela e
3. Confira a versão NS-3 atual suportada por este módulo.

Para instalar este módulo com a última confirmação, você pode usar o seguinte comando all-in-one:

git clone https://gitlab.com/nsnam/ns-3-dev.git && cd ns-3-dev &&
git clone https://github.com/signetlabdei/lorawan src/lorawan &&
tag= $( < src/lorawan/NS3-VERSION ) && tag= ${tag # release } && git checkout $tag -b $tag

Nota : Ao alternar para qualquer confirmação anterior, incluindo a versão mais recente , sempre verifique também o NS-3 para a versão correta (arquivo de NS3-VERSION na raiz deste repositório) suportado nesse momento.

Compilação

O NS-3 adota uma filosofia orientada ao desenvolvimento. Antes de executar qualquer coisa, você precisará compilar o código NS-3. Você tem duas opções:

1. Compilar o NS-3 como um todo: disponibilize todos os módulos de simulação, configurando e construindo o seguinte (verifique se você está na pasta ns-3-dev !):

   ./ns3 configure --enable-tests --enable-examples &&
   ./ns3 build

2. Concentre -se exclusivamente no módulo Lorawan: para acelerar o processo de compilação, pois pode levar mais de 30/40 minutos em hardware lento, altere a configuração da seguinte forma:

   ./ns3 clean &&
   ./ns3 configure --enable-tests --enable-examples --enable-modules lorawan &&
   ./ns3 build

   A primeira linha garante que você comece a partir de um estado de construção limpo.

Por fim, verifique se os testes funcionam sem problemas com:

./test.py

Se o roteiro relatar que todos os testes passaram, você estará pronto para ir.

Se alguns testes falharem ou falharem, considere apresentar um problema.

Exemplos de uso

O módulo inclui os seguintes exemplos:

• simple-network-example
• complete-network-example
• network-server-example
• adr-example
• aloha-throughput
• frame-counter-update
• lora-energy-model-example
• parallel-reception-example

Os exemplos podem ser executados através do comando ./ns3 run example-name (consulte ./ns3 run --help para obter mais opções).

Documentação

• Visão geral do modelo de simulação: uma descrição dos modelos fundamentais deste módulo (arquivo de origem localizado em doc/lorawan.rst ).
• Documentação da API: Documentação de todas as classes, funções de membro e variáveis ​​geradas a partir de comentários doxygen no código -fonte.

Outras fontes úteis de documentação:

• Tutorial NS-3: comece aqui se você é novo no NS-3!
• Manual NS-3: Visão geral das ferramentas e abstrações fundamentais no NS-3.
• A especificação de Lorawan pode ser baixada no site da Lora Alliance.

Obtendo ajuda

Para discutir e obter ajuda sobre como usar este módulo, você pode abrir um problema aqui.

Contribuindo

Consulte as diretrizes de contribuição para obter informações sobre como contribuir para este módulo.

Autores

• Davide Magrin
• Martina Capuzzo
• Stefano Romagnolo
• Michele Luvisotto

Licença

Este software é licenciado nos termos do GNU GPLV2 (a mesma licença usada pelo NS-3). Consulte o arquivo License.md para obter mais detalhes.

Agradecimentos e publicações relevantes

A versão inicial deste código foi desenvolvida como parte da tese de mestrado na Universidade de Padova, sob a supervisão do Prof. Lorenzo Vangelista, Michele Zorzi e com a ajuda de Marco Centenaro.

Publicações:

• D. Magrin, M. Capuzzo e A. Zanella, "Um estudo completo do desempenho de Lorawan sob diferentes configurações de parâmetros", no IEEE Internet of Things Journal. 2019. Link.
• M. Capuzzo, D. Magrin e A. Zanella, "confirmou o tráfego em Lorawan: armadilhas e contramedidas", 17ª Workshop anual de rede ad hoc do Mediterrâneo (Med-Hoc-Net), Capri, 2018. Link.
• D. Magrin, M. Centenaro e L. Vangelista, "Avaliação de desempenho das redes Lora em um cenário da cidade inteligente", 2017 IEEE International Conference on Communications (ICC), Paris, 2017. Link.
• Performances no nível da rede de um sistema LORA (tese de mestrado). Link.