WichitaALLBird

Overview

• all python code is python 3 and was tested in ipython3
• testing:

	ipython3
	run serialTest.py
	run tests.py
	choosePort() # getting deprecated

Server (Arduino) Stuff

Uploading

• compile (verify)
• use loadCode.sh and loadAllCode.sh in this repo

Definitions

WichitaALLStrands.json is a key:value setup

• ring: the outer-most is 1 and the inner 3.

• group: left-most (west) is 1 and right-most is 3

• left: ID of any strands adjacent to the left

• right: ID of any strand adjacent to the right (from the direction of the outside looking into the center on circle/groups 1 and 3, and from the inside looking out on circle/group 2).

• keys are strands (not birds)

• strands 0 and 25 are the two centers

• Statuses of strands:

  • 'dark birds': 14
  • 'active': 113
  • 'pending': 5
  • 'no birds': 12
  • 'disabled': 4 # due to malfunction
  • 'broken': 5

Hardware

• 9 Arduinos (aka Servers) numbered 0 through 8
• (Arduino 9 does not exist and represent unassigned/broken strands)
• up to 18 strands on an Arduino numbered 0 through 17

Colors

• 0 Red
• 30 Orange
• 45 Yellow
• 66 Yellow Green
• 86 Green
• 116 Aqua
• 128 light blue
• 166 deep blue
• 218 Purple

Modes

0

• this is the default mode: no sensor motion detected for TRIGGER_LENGTH seconds

1

2

3

4

5

6

7

Sending/receiving from sensors

• sensors are numbered 1-7
• sensors send to redis server running on main (bird) computer
• sensors also receive from redis server for calibration settings
• redis server is password protected
• messaage from sensor example:
  • key:from/<sensor #> value:`{"activity":<T/F>,"areas":[size1,size2,size3], "delta_thresh": 0 to 255, "min_motion:" <# of frames w motion>, min_area: <int x*y>, ip: }
• message to sensor example: - key:to/<sensor #> value:{"delta_thresh": 0 to 255, "min_motion:" <# of frames w motion>, min_area: <int x*y>}

Parameters that can be changed by the main computer:

• min_motion: # of frames of motion before setting motion to be true (higher = less sensitive)
• delta_thresh: sensitivity of the pixels (higher = less sensitive)
• min_area: size of area for motion. Measured in pixels (higher = less sensitive)

Mode Info:

• changeMove: likelihood that move will not change.
  • 1 means it will not change unless it has to.
  • 0 means it will always change for each additional LED added
  • 0.5 means it has 50% chance of changing
• startDirection: list of one or more moves to start -moves allowed
• up
• down
• left
• right
• inner (move to inner ring)
• outer (move to outer ring)

Data

Variables

• active LED is a list of 3: [strand #, index of Y element in strand, T/F active]
• LEDs in sequence include time: [[strand #, index of Y element in strand, T/F active], abs time]
• serverLedLists is an array of arrays with each index to the parent array representing a server ID
  • The child arrays are lists of LEDs to change of the form [<strand #>, , , ]
  • strand #: uint8
  • numOnStrand: uint8
  • color: uint8
  • amplitude: uint8

Sending colors to LEDS

• open serial ports in main thread
• spin off threads, one for each port, and send LEDs
• join threads, rinse and repeat
• this would require the LEDs to be sorted by Arduino in the main thread

Main Code

• main.py is the main program
• each sequence is an instance of a class.
  • there is no threading in the class or instances

Files

• birds_sample.dat: sample JSON file of strand key:value pairs
• databaseExamples: directory exploring Amazon database solution for communication between sensors and main computer
• dtr: reset Arduino using dtr line executable. Usage: dtr <port>
• dtr.c: reset Arduino using dtr line source code
• init.py: empty file so python source code can be imported as module
• lisa.py: code for original prototype
• loadAllCode.sh: load arduino source code into all Arduinos
• loadCode.sh: load arduino source code into 1 Arduino?
• main.py: main python code
• README.md: um...this file. ;)
• resources: directory of images etc. for reference
• rPI_Info.txt: Wi-Fi/Ethernet/MAC address info for every sensor
• serialTest.py: tests focused on low-level communication with Arduinos
• tests.py: tests focused on higher-level logic of bird paths etc.
• WichitaALLStrands.json: JSON file with most current data of strands.

TODO

• add necessary parameters for mode 0
• convert mode 0 to be a json file and code reads the file
• have mode 0 actually work
  • don't worry about switching modes yet

Mode changes

• replace startLed with random generation based on constraints in moves

Incomplete

• no code currently to return to default mode after specified amount of time (commented out in code)

Current Status

16-Nov-2019

• TODO: test if colors of LEDs are really changing
• TODO: try mode change
• TODO: add code mapping Arduino IDs to Serial ports

14-Nov-2019

• sequence appears to generate but is not fully verified
• deleting LEDs doesn't seem to be working correctly
• sequences are never deleted/regenerated
• currently digging in at the update() code where the try/except clause is