Changes between Version 1 and Version 2 of Documentation/hAndroid/OMF


Ignore:
Timestamp:
Oct 18, 2013, 10:22:07 PM (11 years ago)
Author:
ssugrim
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/hAndroid/OMF

    v1 v2  
    1 = OMF on Android =
     1== OMF on Android ==
    22
    3 == 0. Setup device ==
     3 1. Setup device
    44
    55In order to run OMF Resource Controller on an Android device, we need a Ruby interpreter.
     
    1919To install the JRuby interpreter, press Menu and then View > Interpreters. From here you can see all installed interpreters. To add a new one, press Menu and then Add > JRuby. The .apk should automatically download. Install and open it. Press install, and it will download the necessary libraries to start the JRuby interpreter from SL4A.
    2020
    21 == 1. Get OMF source code ==
     21 2. Get OMF source code
    2222
    2323Now we need the OMF source code to run.
     
    3030Copy the root directory that holds omf-common and omf-resctl to sl4a/scripts on the device's SD card. You should now be able to view the OMF files in SL4A.
    3131
    32 == 2. Bootstrap OMF ==
     32 3. Bootstrap OMF
    3333
    3434If you just try to start the resource controller by running omf-resctl/ruby/omf-resctl/nodeAgent.rb, you will run into errors regarding the load path. This is because the resource controller is supposed to be started via omf-resctl/sbin/omf-resctl:
     
    7575This script is in essence a Ruby translation of the shell script above that loads all Ruby dependencies (RESCTL_DIR and COMMON_DIR) to the LOAD_PATH variable before running nodeAgent.rb (NODE_PATH).
    7676
    77 == 3. Load networking drivers ==
     77 4. Load networking drivers
    7878
    7979In order to properly retreve data from the device, you need to use the corresponding driver for the wireless chipsets. nodeAgent does this by running lspci, which does not work on Android.
     
    8989The Intel driver is not completely compatible with the wireless chipsets on the device, but it works.
    9090
    91 == 4. Vendorize Gems ==
     91 5. Vendorize Gems
    9292OMF relies on several gems that we do not have on the SD card.
    9393
     
    136136This is necessary because the native Yaml parser returns a hash with symbols for keys, and RbYAML returns a hash with strings as keys. We recursively copy the data into a new hash and convert the key from a string to symbol.
    137137
    138 == 5. Configure node ==
     138 6. Configure node
    139139Resource Controller should be running now, you need to configure it accordingly.