update

Author: simonbyrne

README.md

@@ -10,7 +10,10 @@ SenseHat.jl requires the Raspbian `sense-hat` package:
 
 ## LED matrix
 
-The main interface is the `led_matrix()` function, which creates an 8×8 array of RGB values (from [ColorTypes.jl](https://github.com/JuliaGraphics/ColorTypes.jl)) which is memory-mapped to the frame buffer of the LED matrix.
+The main interface is the `led_matrix()` function, which creates an 8×8 array of RGB
+values (from [ColorTypes.jl](https://github.com/JuliaGraphics/ColorTypes.jl)) which is
+memory-mapped to the frame buffer of the LED matrix. `led_clear()` is a convenience
+function for resetting the LED matrix to black.
 
     using SenseHat
     using ColorTypes
@@ -19,26 +22,31 @@ The main interface is the `led_matrix()` function, which creates an 8×8 ar
 
     LED[:] = SenseHat.JULIA_LOGO
     sleep(3)
-    LED[:] = RGB(0,0,0)
+    led_clear()
 
 ## Joystick
 
-In the `Stick` module there is `readstick()` which will block until the joystick is manipulated, returning a `StickEvent`:
+In the `Stick` module there is `readstick()` which will block until the joystick is
+manipulated, returning a `StickEvent`:
 
     using SenseHat
 
     e = readstick()
 
-For asynchronous use, `sticktask()` will create a `Task` for producing `StickEvent`s, e.g.
+For querying within a loop, `sticktask()` will create a `Task` that produces `StickEvent`s. Use
+with `@schedule` for asynchronous use, e.g.
 
     using SenseHat
 
     @schedule for e in sticktask()
         println(e)
     end
 
-will create a new task that prints the event, then and add it to the scheduler. See the help for `StickEvent` and `sticktask` for more details.
+will create a new task that prints the event, then and add it to the scheduler. See the
+help for `StickEvent` and `sticktask` for more details.
 
 ## Sensors
 
-Coming soon: in the meantime, you can use the [python library](https://pythonhosted.org/sense-hat/) via [PyCall.jl](https://github.com/JuliaPy/PyCall.jl).
+`humidity()`, `temperature()` and `pressure()` will read values from the corresponding sensors.
+
+The inertial measurement unit (IMU) is not yet supported, but is coming soon. In the meantime, you can use the [python library](https://pythonhosted.org/sense-hat/) via [PyCall.jl](https://github.com/JuliaPy/PyCall.jl).

src/SenseHat.jl

@@ -1,7 +1,7 @@
 __precompile__()
 module SenseHat
 
-export led_matrix, RGB565,
+export led_matrix, RGB565, led_clear,
     Stick, StickEvent, sticktask, readstick,
     pressure, temperature, humidity
 

src/led.jl

@@ -2,7 +2,7 @@ module LED
 
 import ..ioctl
 
-export led_matrix, RGB565
+export led_matrix, RGB565, led_clear
 
 using ColorTypes, FixedPointNumbers
 
@@ -18,7 +18,7 @@ function _led_fb_device()
         end
     catch e
     end
-    error("Sense Hat not found.")
+    error("Sense Hat device not found.")
 end
 
 const LED_FB_DEVICE_PATH = _led_fb_device()
@@ -127,30 +127,9 @@ end
 setgamma(table::AbstractVector) = setgamma(convert(Vector{U5}, table))
 
 
-
-
-"""
-    led_display(X)
-
-Display an image `X` on the SenseHat LED matrix.
-
-`X` should be an 8×8 matrix of colors (see the ColorTypes.jl package).
-
-See also:
-* `rotl90`, `rotr90` and `rot180` for rotating the image.
-* `flipdim` for reflecting the image.
-* `led_clear` for clearing the LED matrix.
-"""
 function led_display(X)
     Base.depwarn("`led_display(X)` has been deprecated, use `led_matrix()[:] = X` instead.", :led_display)
-    size(X) == (8,8) || throw(DimensionMismatch("Can only display 8x8 images"))
-    open(LED_FB_DEVICE, "w") do fb
-        for j = 1:8
-            for i = 1:8
-                write(fb, convert(RGB565, X[i,j]).data)
-            end
-        end
-    end
+    led_matrix()[:] = X
 end
 
 """
@@ -159,14 +138,7 @@ end
 Sets the SenseHat LED matrix to all black.
 """
 function led_clear()
-    Base.depwarn("`led_clear()` has been deprecated, use `led_matrix()[:] = SenseHat.RGB565(0,0,0)` instead.", :led_display)
-    open(LED_FB_DEVICE, "w") do fb
-        for j = 1:8
-            for i = 1:8
-                write(fb, UInt16(0))
-            end
-        end
-    end
+    led_matrix()[:] = SenseHat.RGB565(0,0,0)
 end
 
 end # module

src/led_extra.jl

@@ -14,5 +14,5 @@ const JULIA_LOGO = begin
      z R R G G P P z;
      R r r R P p p P;
      R r r R P p p P;
-     z R R z z P P z] |> rotl90 |> X -> flipdim(X,1)
+     z R R z z P P z]' # transpose to correct orientation
 end

test/led.jl

@@ -7,4 +7,4 @@ const LED = led_matrix()
 
 LED[:] = SenseHat.JULIA_LOGO
 sleep(3)
-LED[:] = RGB(0,0,0)
+led_clear()