Difference between revisions of "Project:Spacensus"

From London Hackspace Wiki
Jump to: navigation, search
Line 25: Line 25:
     Entrances: 401
     Entrances: 401
     Exits:    337
     Exits:    337
   Actions completed:
   Actions completed:
     Entrances: 173
     Entrances: 173
Line 37: Line 37:
     Entrances: 144
     Entrances: 144
     Exits:    125
     Exits:    125
====Recent modifications====
====Recent modifications====
* Milled [http://www.flickr.com/photos/travelbot/5571860429/in/pool-londonhackspace new bracket] for sensors.
* Milled [http://www.flickr.com/photos/travelbot/5571860429/in/pool-londonhackspace new bracket] for sensors.

Revision as of 16:53, 14 July 2011


Members Elliot
QR code
In situe

Part of the London Hackspace graphs and visualisations project.


We were donated two Laser Diode Retroreflective Sensors which I now use to monitor space occupancy. The sensors look across the main doorway. The beams are staggered so that direction (arriving, leaving) can be determined by the order in which the beams are broken. They are mounted at waist height.

The sensors are hooked-up to an Arduino via some optocouplers. The Arduino is connected to a PC so that the count can be queried over a network.

The occupancy level is charted on cacti.



  • I added a fair bit of code to log the various states of the system to try and determine why it over counts.
  • Writing to the serial port takes time I had to place the logging code carefully so as not to interfere with the critical timing of beam break detection.
  • I now have a log file to analyse which includes a good amount of traffic from a Tuesday evening.
  • Summary stats from the log file:
 Beam breaks:
   Outer:     655
   Inner:     694
 Actions initiated:
   Entrances: 401
   Exits:     337
 Actions completed:
   Entrances: 173
   Exits:     129
 Actions never completed - timed out - noise:
   Entrances: 84
   Exits:     83
 Actions not counted because they were fast/slow:
   Entrances: 144
   Exits:     125

Recent modifications

  • Milled new bracket for sensors.
  • Graphical display with graph showing the days occupancy
  • Detection code now completely interrupt driven
  • Beams are now polarized
  • Beams are now very close together
  • Prism reflector

How it works


These sensors emit a low power visible laser. They detect the beam reflection - if the reflection is obscured then we can surmise that a person is in the way. The sensors were manufactured in 1996 and use a Class II laser rated at 3mW (peak), 2kHz 2% duty cycle, with a wavelength of 655-670nm (datasheet). The model number is: Q45BB6LL

A good signal can be obtained at 1.5m by using a reflector made of aluminium tape but alignment is critical. Prism reflectors are far more forgiving.

State machine

The detection aspects of spacensus use an interrupt driven state machine. Anything that isn't time critical stuff happens in a run-loop.

Spacensus state machine diagram.png


The code is available on GitHub - please be kind it's my first Arduino project and I know the code is filth.


Changing the count manually

  • Press the black increment (+) or decrement (-) buttons on the main unit.

Disabling/Enabling the laser beams

Sometimes you might want to turn off the lasers - perhaps if there are children in the space. Note that no people detection can take place with the lasers off, so please remember to turn them back on.

  • If you need to turn off the laser sensors then press and hold both buttons for ~5 seconds
  • Repeat above step to enable them.

Silencing the alarm

If the sensors are blocked for more than 15 seconds then an alarm will sound. If you can't remove the blockage you can turn off the sound to prevent irritation.

  • Disable the beams as described in the section above.

Powering off

  1. Remove the USB cable from the side of the unit.
  2. Remove the 12VDC jack from the side of the unit.
  3. Check the beams are no longer emitted and that no sensor indicators are illuminated.


The current mounting location has the lasers In close proximity in the middle of the entrance way. To avoid issues with occlusion of beams by coats etc, the coat hooks have been moved to the next wall along, with the lab coats. This arrangement greatly simplifies the detection of the true direction of someone entering/leaving the space. Detection works reasonably well.

Safety signs

Positioned above sensors.
External door warning.


Q: This will probably get caught out by clusters of people: --


  • We only need an approximate count
  • The doorway is narrow so it's unlikely that the steps of more than one individual will overlap.
  • Most of the time people won't arrive in clusters

Q: Can we detect some other event such as the door opening after a prolonged lights-out period to force the count to zero? --


  • Yes, using the door/lights data for reset would be good if we get large amounts of drift - but I don't plan to just yet
  • This might fail if people spend the night there. AIUI this happens rarely enough that we may not care about the inaccuracy.
  • We could also use some kind of probabilistic model with the 'door-open' and 'bell' data

Q: Why didn't you use an ethernet shield?

A: There was already a networked PC in the vicinity.