an Internet of Things innovation int the way we shop. It provides trolley tracking information and big data analytics. In our first release we produced a prototype model that can track trolley bay quantities and store this data offsite or locally in a mongoDB.
####Android APK
Virus check (check the sha256 against this to ensure validity)
###Other Information
MongoDB Testing Database Login Information (only use this db for testing)
- Python 2.7
- PIP (python package manager)
- PyMongo
- MongoDB Shell or access to port 19746
- Android w/NFC running api 21 (Lolipop) or above
For offsite database
Make sure that this code block isn't commented out and the one after is (by default, this is enabled)
uri = "mongodb://greg:[email protected]:19746/trolleysystem" client = MongoClient(uri)
(Do this in /src/server/server.py, /src/server/init-bay.py, /src/web-app/viewer.py)
For local network database (requires mongodb shell)
Make sure that this code block isn't commented out and the one before it is
client = MongoClient()
(Do this in /src/server/server.py, /src/server/init-bay.py, /src/web-app/viewer.py)
in /src/server/ip.txt, change the value to the local value of your workstations ip.
Basic commands to find local ip in cmd/terminal:
- ipconfig (Windows)
- ifconfig (MacOSX/Linux)
at this stage in the project the nfc tag scanner only works with an Android phone with its api above 21 (Lollipop). Prior to 21, nfc scanners were handled differently to modern versions. For this reason, we have opted to support newer phones over older ones. If you do not have an android phone that is above api 21, please use /src/server/server-test-input.py however this is not fully supported
Download the latest build of the apk at:
After installing open the application and go to the "Read a Tag" button
Main Menu of Bay (fig. 2.1)
Enter in the servers IP address in the ip field and decide on a port for the port field (you will be prompted for a port when excecuting the server, use the same value)
Read a Tag Menu of Bay (fig. 2.2)
Nex step is to scan in any nfc tag (e.g. opal card, self written, etc)
After the tag has been successfully read, press send. A toast message will appear explaining that a message attempted to send. It will not however be caught as the server has not been started and the trolley bay has not been created in the mongodb.
Navigate to the server folder (/src/server/...) and open a cmd/terminal that supports python. Run the python script and check for any errors (if errors occur, check that you have met all of the requirements).
It will prompt you to enter a port number, use the same port as the one configured on your android (bay)
Here is an image of the python scripts output in action
Server Script (fig. 3.3)
Next you will need to initiate bays (this step is the same for local and offsite). To initate the bays open a second cmd/terminal window in the same folder and run /src/server/init-bays.py. Once open it will prompt you for a port (same as previous). It will then ask you to enter in bay names, it won't end until the user quits the script with ctrl + C (Windows/Linux) or cmd + C (MacOSX).
if this step fails ensure that the ip is configured in /src/server/ip.txt and you are using a valid local port on your network
###Step 4. Testing the system
Ensure that all devices have been setup with the correct IPs and ports and they are all on the same network using a valid port address
On the Android (bay) scan a tag and press send, on the python server script it should say "Recieved(...)" and the line after should read "Update trolley ... in bay ...".
Navigate to the folder /src/web-app/viewer.py and run the script (ensure that you have configured it to be either offsite or local)
a windows like this should pop up
Trolley Bay Count (fig. 4.1)
Optional Step. If you are running the mongodb locally, you can view the changes to the local db as you go. Below are a few relevant command for viewing the data in the database commands for mongo
| Command | Description |
|---|---|
| mongod | Runs mongodb daemon |
| mongo | Opens mongodb shell |
| show dbs | lists accessible dbs |
| use ### | Sets the open db to ### |
| show collections | Lists the names of the collections in your active db |
| db.###.find() | Lists all record in collection ### of the active db |
| db.dropDatabase() | Deletes the existing database |
Example MongoDB Output (fig opt.1)
- Python GUI
- Add troley bay config capabilities to android
- Web app interface
| Command | Syntax |
|---|---|
| Add bay | INIT>bay |
| Trolley | TRIO>bay#trolley |