
     ____ __     ____   ___    ____ __         (((((()
    | |_  \ \  /   ) ) | |  ) | |_  \ \  /  \(@)- /
    |_|__  \_\/  __)_) |_|_/  |_|__  \_\/   /(@)- \
                                               ((())))
    ___         __________________________________
    ___ VERSION __________________________________

    ev3dev-c    0.9b3
                2016-09-01

    kernel      4.4.17-14-ev3dev-ev3
    ___             ______________________________
    ___ WHAT IS IT? ______________________________

    ev3dev-c is a C library for LEGO Mindstorms EV3 Debian
    (http://www.ev3dev.org/) which wraps an access to the EV3 hardware.

    The library also supports a remote access to the EV3 brick over UDP.
    So, if you set up WLAN on the brick you will be able to drive
    the EV3 hardware from your computer, e.g. under Windows.

    Python (see "python/ev3dev" folder), Ruby (see "ruby" folder) and
    Perl (see "perl" folder) libraries are automatically generated from
    C library using SWIG tool.

    Use pip or easy_install to install ev3dev-c Python package, e.g.

        sudo pip install --pre ev3dev-c

    ev3dev-c is currently in a beta stage, therefore you have to use
    the key "--pre".

    The package contains the following binary modules:
    _ev3.pyd    – for a remote access, under Windows (x86);
    _ev3.so     – for LEGO Mindstorms EV3 Debian.

    You have to install "python-dev", "ruby-dev" and "libperl-dev"
    packages to build the corresponding library.

    ___       ____________________________________
    ___ F A Q ____________________________________

    * * *  What are unusual ".yu" files for?

    ev3dev-c is written using yupp C preprocessor, but don't panic,
    generated source files in C also included.

    * * *  How can I see some examples?

    The comprehensive example based on coroutines:

        http://in4lio.github.io/ev3dev-c/drive_8c-example.html

    The example of using "brick" simplified library:

        http://in4lio.github.io/ev3dev-c/remote_8c-example.html

    There are a few more examples on C in

        https://github.com/in4lio/ev3dev-c/blob/master/eg/

    light    – LEDs blinking example
    sensor   – TOUCH and COLOR sensors example
    tacho    – TACHO motor running for 5 sec
    port     – Using EV3 ports
    dc       – Using DC motor
    rcx_led  – Using RCX LED
    servo    – SERVO motor example

    > cd eg/light/
    > make
    > debug/light
    or
    > debug\mingw\light.exe

    Similar examples on Python could be found in "python/ev3dev/eg".
    Examples on Ruby are placed in "ruby/eg", on Perl in "perl/eg".

    * * *  How to drive the EV3 hardware remotely?

    https://github.com/in4lio/ev3dev-c/tree/master/source/ev3/ev3_link/

    * * *  How to make and install the static library?

    > cd source/ev3/
    > make
    > make install

    ___          _________________________________
    ___ GET HELP _________________________________

    Docs generated by Doxygen can be found on

        http://in4lio.github.io/ev3dev-c/

    ___     ______________________________________
    ___ GIT ______________________________________

    Enter in the following on your command-line to clone the library
    repository:

        git clone https://github.com/in4lio/ev3dev-c.git

    ___         __________________________________
    ___ CONTACT __________________________________

    Please feel free to contact me at in4lio@gmail.com if you have
    any questions about the library.

    ___         __________________________________
    ___ LICENSE __________________________________

    Please see the file called "LICENSE".
