README.md

Paxcounter plugin

Paxcounter is a plugin for https://github.com/aapris/DjangoPluginDemo and it handles and stores data sent by paxcounter_readserial.py script.

Quick start

1. Create Python virtual environment, create installation package and install it:

   # Create virtualenv first using python3.6 or newer (in this directory)
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   mv -v dist/ /tmp/  # Remove old installation package, if it exists
   python setup.py sdist
   pip install dist/django-paxcounter-plugin-0.1.tar.gz
   

2. Add "paxcounter" to your INSTALLED_APPS setting like this:

       INSTALLED_APPS = [
           ...
           'paxcounter',
       ]
   

3. Run python manage.py migrate to create Paxcounter models.

4. Run python manage.py runserver to start development server.

5. Create "paxcounter" endpoint in Django admin.

Reading MAC data from serial port

paxcounter_readserial.py --port /dev/tty.SLAB_USBtoUART --url http://127.0.0.1:8000/paxcounter

NOTE: you need slightly modified version of PAXCOUNTER firmware for ESP32, which uses static (not random) salt. In maxsniff.cpp replace

salt = (uint16_t)random(65536);

with

salt = 42;  // Any number between 0 and 65535 

In addition, by default PAXCOUNTER outputs only 32 least significant bits of MAC address. To get all 48 bits you need to add them to debug output in the same file. (Some coding experience is needed.)