NEMO-mqtt 0.3.5

MQTT plugin for NEMO

NEMO MQTT

This plugin for NEMO adds support for MQTT interlocks.

Compatibility:

NEMO >= 5.0.0 ----> NEMO MQTT >= 0.3

NEMO-CE >= 2.0.0 -----> NEMO MQTT >= 0.3

Installation

• Install python module

  pip install NEMO-mqtt[NEMO]
  

• Add NEMO_mqtt to INSTALLED_APPS in settings.py:

  INSTALLED_APPS = [
      '...',
      'NEMO_mqtt', # This needs to be before NEMO
      '...'
      'NEMO',
      '...'
  ]
  

• Run migrations:

  python manage.py migrate
  

Usage

1. Navigate to the Detailed Administration page in the Administration menu.
2. Go to Interlock cards admin page, create a new item with the following parameters:
   • Name: MQTT_0 (you can choose anything else meaningful and unique for each server, e.g. MQTT_0, MQTT_1, etc)
   • Server: localhost
   • Port: 0
   • Category*: MQTT
   • Enabled: tick
3. Go to Mqtt interlock servers admin page and add one item for each server you are willing to use:
   • Under card, select the corresponding interlock card item: MQTT_0:localhost
   • Fill other parameters according to your server authentication requirements.
4. Go to Interlocks admin page and add an interlock:
   • Card: MQTT:localhost
   • Channel: select a non-null unique number.
5. Go to MQTT interlocks admin page and add an MQTT interlock:
   • Interlock: select the previously created interlock
   • Fill the rest according to the parameters required by your interlock to operate
6. Repeat 4 & 5 as needed
7. Use as a normal interlock for doors/tools
8. Enjoy!