sudden_motion_sensor 1.1.0-universal-darwin

data/Changelog

@@ -0,0 +1,7 @@
+Version 1.1.0 - 2010-04-21
+  * removed deprecated IO calls (Thanks C7!)
+  * removed silly duplicate "def values" in library
+  * changed gemspec platform to be just 'universal-darwin' from 'universal-darwin-9'
+
+Version 1.0.0 - 2010-04-18
+  * Initial Release

data/LICENSE

@@ -0,0 +1,110 @@
+The Don't Be a Dick License (http://github.com/SFEley/candy/blob/master/LICENSE.markdown)
+===========================
+_version 0.1_
+
+**Project:** [Candy](http://github.com/SFEley/candy) v0.2  
+**Author:** Stephen Eley (<sfeley@gmail.com>)
+
+This is a proposed draft of the **Don't Be a Dick** license for open source projects.  The purpose of this license is to permit the broadest feasible scope for reuse and modification of creative work, restricted only by the requirement that one is not a dick about it.
+
+1. Legal Parameters
+-------------------
+For legal purposes, the DBAD license is a superset of the [Apache License, Version 2.0][1] and incorporates all terms, conditions, privileges and limitations therein.  The following text is a binding part of this license for this project:
+
+> Copyright 2010 Stephen Eley
+
+> Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+>   <http://www.apache.org/licenses/LICENSE-2.0>
+
+> Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  
+Nothing in the following text should be construed to inhibit, contradict, or override any part of the Apache License, Version 2.0.  
+
+2. Definitions
+--------------
+The following terms and definitions shall be in effect for the rest of this document.
+
+>  **NOTE:** Singular nouns and pronouns are used throughout this License for 
+  grammatical convenience.  However, any of the terms below _may_ refer to a
+  collective work or group of people.  If this pegs your punctiliousness, you
+  are directed to mentally substitute "Person _or persons_," "Dick _or 
+  dicks,_" etc., throughout this license.  Just don't tell us about it.
+
+### A. Project
+
+A creative work of (software | writing | visual art | music) into which significant time and energy have been invested by people who _are not you,_ and which has been released into the world for the benefit of the general public (_including you._)
+
+The **Project** may include, incorporate, derive from, or be inspired by other works.  The Author, being a Reasonable Person, has made use of such source materials only as permitted by their own licenses or applicable law.  The License you are reading applies only to those portions of the Project which are original and distinct to it.  Source materials may be covered by their own licenses or conditions, and should not be assumed to have coverage under this License.  (However, you are strongly encouraged not to be a dick about them either.)
+
+### B. Author
+
+A person who has invested significant time and energy into the Project licensed herein.  Given the Author's release of the Project to the world under a liberal license, the Author is declared a Reasonable Person (at least within this context) and inherits all attributes, freedoms, and responsibilities thereof.  No other assumptions are made about the Author, nor should you make any.
+
+### C. Reasonable Person
+
+A person who respects the time and energy that have been invested in the Project licensed herein, and acts accordingly.  A Reasonable Person is broadly characterized as one who exercises his or her privilege to use, _not_ use, redistribute, modify, improve, worsen, review, report issues upon, participate in the community of, or ignore the work _without_ placing undue demands upon the Author.  I.e., a Reasonable Person is a constituent of the majority of open source users and the population at large who are not Dicks.
+
+### D. Dick
+
+A person who _does not_ respect the time and energy that have been invested in the Project, and acts to punish such effort by giving others associated with the Project -- including, but not limited to, the Author -- a hard time.  A Dick is nearly always selfish, but not necessarily with deliberate intent; some Dicks are merely thoughtless.  The distinguishing characteristic of a Dick is that he or she places burdens upon Reasonable People, reducing their motivation to engage in open source activities.  This damping effect is a significant detriment to the Project, to open source in general, to the production of new intellectual value in the world -- and, ultimately, to the Dick himself or herself.
+
+>  **NOTE:** Despite its original gender association, the word "Dick" is used herein in a _cultural_ context and not a _genital_ context.  This License has chosen to adopt the term for its linguistic force and psychological impact, and sincerely regrets any inference of sexism.  For purposes of the terms and conditions contained herein, it is understood that both men and women are equally capable of being Dicks.  
+  
+>  (But they shouldn't be.)  
+  
+3. Permissions
+--------------
+
+The following privileges are granted explicitly and exclusively to Reasonable People.  Although the Author acknowledges the practical unfeasibility of barring Dicks from enjoying the same privileges, they are nevertheless asked to refrain from any activity related to the Project _and/or_ to reconsider their behavior and stop being Dicks.
+
+1. You are permitted to use the Project or any component of the Project.
+
+2. You are permitted to redistribute the Project or any component of the Project, by itself or as part of a different work, provided that you give fair and reasonable credit back to the Author.
+
+3. You are permitted to change the Project for your own needs or anyone else's.  You may keep your changes to yourself or submit them back to the Author or the community, as you see fit, provided you are not a Dick about it.
+
+4. You are permitted and encouraged to participate in any community related to the Project, or to create new communities.
+
+5. You are permitted to report issues or problems with the Project, and to request that they be addressed, so long as the request is made in a reasonable fashion.  (This privilege does _not_ oblige the Author to respond.)
+
+6. You are permitted to make money from the Project.  No recompense is owed to the Author unless by separate agreement, although sharing opportunities for mutual benefit is by no means discouraged.
+
+7. You are permitted to discuss the Project in any medium, in any positive or negative spirit, so long as criticism is not libelous nor _ad hominem._  (I.e., don't lie, and keep it about the _work_ and not the _people._)
+
+8. You are permitted to ignore the Project completely and make no use of it whatsoever.  This right is irrevocable and absolute, and extended to Dicks and Reasonable People alike.
+
+4. Limitations
+--------------
+
+The following restrictions are imposed explicitly and exclusively upon Dicks.  These limitations are the inverse of the above privileges and are also tautological, as the prohibited actions are those _definitive_ of Dickhood.
+
+1. You may not impede Reasonable People from exercising their privilege to use, redistribute, change, participate in, profit from, discuss, or ignore the Project.
+
+2. You may not withhold the Author's credit for the Project, nor otherwise present the work of anyone else as your own.
+
+3. You may not hold the Author responsible for any use or abuse of the Project by you or anyone else.
+
+4. You may not troll, flame, nor dumb down any community associated with the Project.
+
+5. Barring separate agreements, you may not _demand_ any time or attention on the part of the Author nor anyone else in the community.  You may not hold the Author personally accountable for any issues you discover nor otherwise spread your own problems to other people.
+
+6. You may not attempt to _compel_ time nor money from the Author nor any other community member by any means, including but not limited to legal action, intimidation, or annoyance.  
+
+7. You may not engage in _ad hominem_ (i.e. personal) attacks or criticism of the Author in the course of criticizing the Project.
+
+8. You may not impede the absolute and irrevocable privilege of the Author and other members of the community to ignore you.  
+
+5. Contact
+----------
+For more information about this Project or the DBAD License, contact the Author at:
+
+* Stephen Eley - <sfeley@gmail.com>
+
+[1]: http://apache.org/licenses/LICENSE-2.0

data/README

@@ -0,0 +1,39 @@
+# sudden-motion-sensor
+
+This gem reads data from the sudden motion sensor inside most Intel-based Macbooks and Macbook Pros and some late model Powerbooks.  Returns the data in a 3-axis array of integers representing orientation along the X and Y axis and relative acceleration along the Z axis.
+
+Big tutorial: http://n4k3d.com/blog/post/4/ruby_and_the_sudden_motion_sensor_tell_your_code_which_way_is_up/
+
+Based in part on code from http://fazibear.blogspot.com/2008/12/process-mac-sudden-motion-sensor-with.html.
+
+More Basic Info: http://en.wikipedia.org/wiki/Sudden_Motion_Sensor
+
+Installation:
+
+  sudo gem install sudden_motion_sensor
+
+Usage:
+
+  require 'rubygems'
+  require 'sudden_motion_sensor'
+
+  100.times do
+    x,y,z = SuddenMotionSensor.values
+    puts "X: #{x}, Y: #{y}, Z: #{z}"
+    sleep 0.1
+  end
+
+That code will print out the X,Y and Z data 100 times.
+
+Data returned may be dependent on the model of Macbook you have and accelerometer part used.  For the 2009 Unibody Macbook 15-inch and data returned will be X and Y as a signed integer from -255 to +255 and Z as an indication of gravity (~262 average at rest).
+
+For X and Y axis, 0 indicated the unit is flat along the plane (either right-side-up or upside-down) and 255/-255 indicates 90-degree inclination.
+
+Methods:
+  
+  Values()
+    Returns (X, Y, Z)
+    Class method that returns an array of 3 signed integers indicating X Y and Z orientation.
+
+
+

data/demo.rb

@@ -0,0 +1,7 @@
+require 'lib/sudden_motion_sensor'
+
+100.times do
+  x,y,z = SuddenMotionSensor.values
+  puts "X: #{x}, Y: #{y}, Z: #{z}"
+  sleep 0.1
+end

data/lib/sudden_motion_sensor.rb

@@ -0,0 +1,82 @@
+require 'rubygems'
+require "inline"  
+
+class SuddenMotionSensor
+  class << self  
+    inline do |builder|  
+      builder.add_compile_flags '-x objective-c', '-framework IOKit'  
+      builder.include "<IOKit/IOKitLib.h>"      
+      builder.c %q{  
+        VALUE values(){  
+  
+          struct data {  
+            signed short x;  
+            signed short y;  
+            signed short z;  
+            char pad[34];  
+          };  
+  
+          kern_return_t result;  
+  
+          mach_port_t masterPort;  
+          IOMasterPort(MACH_PORT_NULL, &masterPort);  
+          CFMutableDictionaryRef matchingDictionary = IOServiceMatching("SMCMotionSensor");  
+            
+          io_iterator_t iterator;  
+          result = IOServiceGetMatchingServices(masterPort, matchingDictionary, &iterator);  
+            
+          if(result != KERN_SUCCESS) {  
+            return rb_str_new2("Error");  
+          }  
+  
+          io_object_t device = IOIteratorNext(iterator);  
+          IOObjectRelease(iterator);  
+          if(device == 0){  
+            return rb_str_new2("Error");  
+          }  
+  
+          io_connect_t dataPort;  
+          result = IOServiceOpen(device, mach_task_self(), 0, &dataPort);  
+          IOObjectRelease(device);  
+  
+          if(result != KERN_SUCCESS) {  
+            return rb_str_new2("Error");  
+          }  
+  
+          IOItemCount structureInputSize;  
+          size_t structureOutputSize;  
+  
+          struct data inputStructure;  
+          struct data outputStructure;  
+          structureInputSize = sizeof(struct data);  
+          structureOutputSize = sizeof(struct data);  
+  
+          memset(&inputStructure, 1, sizeof(inputStructure));  
+          memset(&outputStructure, 0, sizeof(outputStructure));  
+  
+          result = IOConnectCallStructMethod(  
+            (mach_port_t)dataPort,  
+            (uint32_t)5,  
+            (const void*)&inputStructure,
+            structureInputSize,  
+            (void*)&outputStructure,
+            &structureOutputSize
+          );  
+  
+          if(result != KERN_SUCCESS) {  
+            return rb_str_new2("Error");  
+          }  
+  
+          IOServiceClose(dataPort);  
+  
+          VALUE coords = rb_ary_new2(3);  
+          rb_ary_store(coords, 0, INT2FIX(outputStructure.x));  
+          rb_ary_store(coords, 1, INT2FIX(outputStructure.y));  
+          rb_ary_store(coords, 2, INT2FIX(outputStructure.z));  
+  
+        return coords;  
+        }  
+      }  
+    end  
+  end  
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: sudden_motion_sensor
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: universal-darwin
+authors: 
+- Matthew Nielsen
+autorequire: name
+bindir: bin
+cert_chain: []
+
+date: 2010-04-16 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: RubyInline
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 8
+        - 4
+        version: 3.8.4
+  type: :runtime
+  version_requirements: *id001
+description: Read orientation and acceleration data from the Sudden Motion Sensor inside many Apple Macbook and Macbook Pro laptops.
+email: xunker@pyxidis.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- README
+- Changelog
+- LICENSE
+- demo.rb
+- lib/sudden_motion_sensor.rb
+has_rdoc: true
+homepage: http://n4k3d.com/code/sudden_motion_sensor/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Reads data from Macbook Sudden Motion Sensor
+test_files: []
+