net - matheuswhite/bluebees GitHub Wiki

Módulo net

O módulo net é responsável pelo gerenciamento das redes mesh bluetooth da ferramenta. Este módulo possui os seguintes comandos:

Comando new

Este comando cria uma nova rede mesh bluetooth. Este comando é necessário para a criação de aplicações e nós. Existe três argumentos possíveis:

  • nome: Este argumento é passado após a flag --name (ou -n). Seu valor definirá o nome da rede que será criada. Caso uma rede com o mesmo nome já exista, então o comando retornará um erro. Este argumento é obrigatório (caso o argumento template não for especificado)
  • chave: Este argumento é passado após a flag --key (ou -k). Seu valor definirá a chave de rede (NetKey) da rede que será criada. Este argumento é opcional. Se não for especificado, então um valor aleatório será disponibilizado para a chave de rede (NetKey) da rede que será criada. Esse argumento deve ser uma hexstring, contendo 16 bytes. Uma hexstring é um valor hexadecimal no formato de string, sendo que cada par de caracteres representam um byte. O comando retornará um erro, se já existir uma rede com o mesmo valor da chave de rede (NetKey) especificado.
  • template: Este argumento é passado após a flag --template (ou -t). O valor especificado deve ser um arquivo de template, para a criação da rede (veja isto para mais informações sobre arquivo de template). As palavras chave utilizada neste arquivo de template são: name (representando o nome da aplicação) e key (representando a chave de rede). O comando retornará um erro, se:
    • Não existir a palavra-chave name no arquivo especificado;
    • Já existir uma rede com o nome especificado no arquivo;
    • Já existir uma rede com a chave especificada no arquivo.

Se a palavra chave key não for encontrada no arquivo especificado, então uma chave de rede (NetKey) aleatória será disponibilizada. A utilização deste argumento torna o argumento nome não obrigatório.

Alguns exemplos deste comando são mostrados abaixo:

(UNIX)
python3 bluebees.py net new --name rede-test
python3 bluebees.py net new --name rede-test --key 123456789012345678901234567890aa
python3 bluebees.py net new --template rede_template.yml
(Windows)
python bluebees.py net new --name rede-test
python bluebees.py net new --name rede-test --key 123456789012345678901234567890aa
python bluebees.py net new --template rede_template.yml

NOTA: Caso o número máximo de redes, que podem ser criadas, for alcançado, então o comando retornará um erro.

Comando list

Este comando lista o nome das redes mesh bluetooth criadas na ferramenta. Caso não exista nenhuma rede criada na ferramenta, então uma mensagem será mostrada, informando que não existe redes criadas. Este comando não recebe argumentos. Um exemplo do comando é mostrado abaixo:

(UNIX)
python3 bluebees.py net list
(Windows)
python bluebees.py net list

Comando info

Este comando apresenta as informações de uma rede mesh bluetooth criada na ferramenta. O único argumento que este comando recebe é o nome da rede. O nome da rede é passado após a flag --name (ou -n). Se não existir nenhuma rede com o nome especificado, então o comando retornará um erro. As informações apresentadas são:

  • Nome da rede;
  • Chave de rede (NetKey);
  • Índice da chave (NetKey Index);
  • Índex IV (IV Index);
  • Uma lista com o nome das aplicações cadastradas nesta rede;
  • Uma lista com o nome dos nós cadastrados nesta rede.

Um exemplo do comando é mostrado abaixo:

(UNIX)
python3 bluebees.py net info -n rede-test
(Windows)
python bluebees.py net info -n rede-test