README.md

   1 # Cyclabile, a light augmented bike lane emitter
   2
   3 Cyclabile is an experiment about projecting a moving bike lane on the road: the
   4 lane moves when the bike moves, producing the effect of riding on an actual bike
   5 lane, even when there isn't one.
   6
   7 Dependencies:
   8
   9 * `libam7xxx0.1` - a library to use USB pico-projector based on the am7xxx chip.
  10 * `libturbojpeg0` - a library for fast JPEG encoding
  11 * `liblept5` - a library for image processing, used to calculate a perspective
  12   projection.
  13
  14 ## Limitations
  15
  16 The effectiveness of projecting on the paving instead of signaling the presence
  17 with a traditional light can be argued.
  18
  19 For now the project purpose is more about making a statement (there should be
  20 more bike lanes) than to build an actual product.
  21
  22 ## Instruction
  23
  24 The prototype has been developed on a BeagleBone Black.
  25
  26 A keypad is needed to adjust the perspective projection parameters, see
  27 http://ao2.it/137 for instructions about how a device-tree overlay can be used
  28 for that.
  29
  30 A precise rotary encoder is needed to detect movement at very low speed,
  31 something like the one at https://ao2.it/135 can be used.
  32
  33 The instructions at https://ao2.it/138 show an example of how to build a support
  34 to mount a magnet ring on the front wheel of the bike.
  35
  36 The device-tree overlay at https://git.ao2.it/experiments/bbb-eqep2b-ao2.git/
  37 enables the BBB hardware support for rotary encoders.
  38
  39 To build the project for the BeagleBone Black execute the following command:
  40
  41     $ make NEON=1 EQEP=1
  42
  43 And install the systemd unit to launch the program automatically when the USB
  44 projector gets connected:
  45
  46     $ sudo make enable_service
  47
  48 The software can also be tested on a normal desktop PC, emulating the encoder
  49 with the mouse wheel, with the following command:
  50
  51     $ make && sudo make run
  52
  53
  54 ## Similar projects
  55
  56 ### Safety First
  57
  58 "*Safety First*" is an art installation by Vladimír Turner and Ondřej Mladý very
  59 much in the spirit of Cyclabile.
  60
  61 * <http://sgnlr.com/works/outside/safety-first2011-prague/>
  62 * <http://vimeo.com/23469752>
  63
  64 The difference is that Cyclabile is more portable and more interactive, the bike
  65 lane moves depending on the bike movement while "*Safety First*" used a video
  66 recording in a fixed loop.
  67
  68
  69 ### Bike Projector Headlight
  70
  71 This is more generic, it's used to display info on the road, not specifically
  72 a bike lane.
  73
  74 * <https://makezine.com/bike-projector-heads-down-display-stationary/>
  75 * <http://www.reddit.com/r/technology/comments/1anmip/guy_builds_a_speedometer_built_from_a_raspberry/>
  76 * <http://www.youtube.com/watch?v=Nfk1-XMASrk>
  77
  78
  79 ### Lightlane
  80
  81 A laser bike lane, it projects a static image.
  82
  83 * <https://www.wired.com/2009/02/lightlanes-lase/>