lora-mote-emulator 1.1.0

PYPI

• Use pip to install lora-mote-emulator:

  pip install lora-mote-emulator

MANUALLY

• Use pip to install pipenv:

  pip install pipenv

• Clone this repo into a directory:

  git clone https://github.com/houluy/lora-mote-emulator.git

• Use pipenv to create a virtual Python environment and install all the dependencies:

  pipenv install

• Build the project:

  python -m build

Here, if there is not Python 3.6 in your system, a warning will occur, and no package will be installed. It is perfect to install Python 3.6 from source. Otherwise, remove the Pipfile.lock and redo the above command.

• Enter the virtual environment by pipenv shell

• Run mote -h to see the help message

OTAA

• Modify device infomation in device.json copied. An example:

  {
      "Device": {
          "JoinEUI": "0000000000000000",
          "DevEUI": "0000000000000000"
      },
      "RootKeys": {
          "AppKey": "00000000000000000000000000000000",
          "NwkKey": "00000000000000000000000000000000"
      }
  }

NOTE: If you want to emulate LoRaWAN 1.0 device, first set JoinEUI equal to AppEUI and set NwkKey equal to AppKey.

ABP

• Modify device activation information in abp.json. An example:

  {
      "deveui": "0000000000000000",
      "joineui": "0000000000000000",
      "devaddr": "00000000",
      "appkey": "00000000000000000000000000000000",
      "nwkkey": "00000000000000000000000000000000",
      "nwksenckey": "00000000000000000000000000000000",
      "snwksintkey": "00000000000000000000000000000000",
      "fnwksintkey": "00000000000000000000000000000000",
      "appskey": "00000000000000000000000000000000",
      "fcntup": 0,
      "version": "1.1"
  }

• Currently, five kinds of message is supported: pull data, join request, rejoin request, confirmed (or unconfirmed) data up (with or without FOpts) and MAC Commands in FRMPayload field:

NOTE: Always remember to mote pull to keep the gateway alive in server.

mote info
mote pull
mote abp
mote join [-n]
mote rejoin 'rejointyp' (0, 1, 2)
mote app 'message' (uplink message, will be encoded by UTF-8) [-auf]
mote mac 'command' (MAC Commands in FRMPayload field)

Here is the example step of interaction with ChirpStack:

mote pull
mote join -n
mote app helloworld -f 0302
mote main.py mac 0302