source: code/trunk/src/ois/linux/LinuxJoyStickEvents.cpp @ 2692

/*
The zlib/libpng License

Copyright (c) 2005-2007 Phillip Castaneda (pjcast -- www.wreckedgames.com)

This software is provided 'as-is', without any express or implied warranty. In no event will
the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial
applications, and to alter it and redistribute it freely, subject to the following
restrictions:

    1. The origin of this software must not be misrepresented; you must not claim that
                you wrote the original software. If you use this software in a product,
                an acknowledgment in the product documentation would be appreciated but is
                not required.

    2. Altered source versions must be plainly marked as such, and must not be
                misrepresented as being the original software.

    3. This notice may not be removed or altered from any source distribution.
*/
#include "OISConfig.h"

#include "linux/LinuxJoyStickEvents.h"
#include "linux/LinuxInputManager.h"
#include "linux/LinuxForceFeedback.h"
#include "linux/EventHelpers.h"

#include "OISEvents.h"
#include "OISException.h"

#include <fcntl.h>        //Needed to Open a file descriptor
#include <cassert>      
#include <linux/input.h>


#include <sstream>

using namespace OIS;

//#define OIS_LINUX_JOY_DEBUG

#ifdef OIS_LINUX_JOY_DEBUG
# include <iostream>
  using namespace std;
#endif

//-------------------------------------------------------------------//
LinuxJoyStick::LinuxJoyStick(InputManager* creator, bool buffered, const JoyStickInfo& js)
        : JoyStick(js.vendor, buffered, js.devId, creator)
{
        mJoyStick = js.joyFileD;

        mState.mAxes.clear();
        mState.mAxes.resize(js.axes);
        mState.mButtons.clear();
        mState.mButtons.resize(js.buttons);

        mPOVs = js.hats;

        mButtonMap = js.button_map;
        mAxisMap = js.axis_map;
        mRanges = js.axis_range;

        ff_effect = 0;
}

//-------------------------------------------------------------------//
LinuxJoyStick::~LinuxJoyStick()
{
        EventUtils::removeForceFeedback( &ff_effect );
}

//-------------------------------------------------------------------//
void LinuxJoyStick::_initialize()
{
        //Clear old joy state
        mState.mAxes.resize(mAxisMap.size());
        mState.clear();

        //This will create and new us a force feedback structure if it exists
        EventUtils::enumerateForceFeedback( mJoyStick, &ff_effect );

        if( mJoyStick == -1 )
                OIS_EXCEPT(E_InputDeviceNonExistant, "LinuxJoyStick::_initialize() >> JoyStick Not Found!");
}

//-------------------------------------------------------------------//
void LinuxJoyStick::capture()
{
        static const short POV_MASK[8] = {0,0,1,1,2,2,3,3};

        //Used to determine if an axis has been changed and needs an event
        bool axisMoved[32] = {false, false, false, false, false, false, false, false, false, false, false, false, false,
                                                  false, false, false, false, false, false, false, false, false, false, false, false, false,
                                                  false, false, false, false, false, false};

        //We are in non blocking mode - we just read once, and try to fill up buffer
        input_event js[JOY_BUFFERSIZE];
        int ret = read(mJoyStick, &js, sizeof(struct input_event) * JOY_BUFFERSIZE);
        if( ret <= 0 )
                return;

        //Determine how many whole events re read up
        ret /= sizeof(struct input_event);
        for(int i = 0; i < ret; ++i)
        {
                switch(js[i].type)
                {
                case EV_KEY:  //Button
                {
                        int button = mButtonMap[js[i].code];

                        #ifdef OIS_LINUX_JOY_DEBUG
                          std::cout << "\nButton Code: " << js[i].code << ", OIS Value: " << button << std::endl;
                        #endif

                        //Check to see whether push or released event...
                        if(js[i].value)
                        {
                                mState.mButtons[button] = true;
                                if( mBuffered && mListener )
                                        if(!mListener->buttonPressed(JoyStickEvent(this,mState), button)) return;
                        }
                        else
                        {
                                mState.mButtons[button] = false;
                                if( mBuffered && mListener )
                                        if(!mListener->buttonReleased(JoyStickEvent(this,mState), button)) return;
                        }
                        break;
                }
                case EV_ABS:  //Absoulte Axis
                {
                        //A Stick (BrakeDefine is the highest possible Axis)
                        if( js[i].code <= ABS_BRAKE )
                        {
                                int axis = mAxisMap[js[i].code];
                                assert( axis < 32 && "Too many axes, not supported. Report this to OIS forums!" );
                                
                                axisMoved[axis] = true;

                                //check for rescaling:
                                if( mRanges[axis].min == JoyStick::MIN_AXIS && mRanges[axis].max != JoyStick::MAX_AXIS )
                                {       //Scale is perfect
                                        mState.mAxes[axis].abs = js[i].value;
                                }
                                else
                                {       //Rescale
                                        float proportion = (float)(js[i].value-mRanges[axis].max)/(float)(mRanges[axis].min-mRanges[axis].max);
                                        mState.mAxes[axis].abs = (int)(32767.0f - (65535.0f * proportion));
                                }
                        }
                        else if( js[i].code <= ABS_HAT3Y ) //A POV - Max four POVs allowed
                        {
                                //Normalise the POV to between 0-7
                                //Even is X Axis, Odd is Y Axis
                                unsigned char LinuxPovNumber = js[i].code - 16;
                                short OIS_POVIndex = POV_MASK[LinuxPovNumber];

                                //Handle X Axis first (Even) (left right)
                                if((LinuxPovNumber & 0x0001) == 0)
                                {
                                        //Why do this? Because, we use a bit field, and when this axis is east,
                                        //it can't possibly be west too. So clear out the two X axes, then refil
                                        //it in with the new direction bit.
                                        //Clear the East/West Bit Flags first
                                        mState.mPOV[OIS_POVIndex].direction &= 0x11110011;
                                        if( js[i].value == -1 ) //Left
                                                mState.mPOV[OIS_POVIndex].direction |= Pov::West;
                                        else if( js[i].value == 1 ) //Right
                                                mState.mPOV[OIS_POVIndex].direction |= Pov::East;
                                }
                                //Handle Y Axis (Odd) (up down)
                                else
                                {
                                        //Clear the North/South Bit Flags first
                                        mState.mPOV[OIS_POVIndex].direction &= 0x11111100;
                                        if( js[i].value == -1 ) //Up
                                                mState.mPOV[OIS_POVIndex].direction |= Pov::North;
                                        else if( js[i].value == 1 ) //Down
                                                mState.mPOV[OIS_POVIndex].direction |= Pov::South;
                                }

                                if( mBuffered && mListener )
                                        if( mListener->povMoved( JoyStickEvent(this,mState), OIS_POVIndex) == false )
                                                return;
                        }
                        break;
                }
                //Relative Axes (Do any joysticks actually have a relative axis?)
                case EV_REL:
                default: break;
                }
        }

        //All axes and POVs are combined into one movement per pair per captured frame
        if( mBuffered && mListener )
        {
                for( int i = 0; i < 32; ++i )
                        if( axisMoved[i] )
                                if( mListener->axisMoved( JoyStickEvent(this,mState), i) == false )
                                        return;
        }
}

//-------------------------------------------------------------------//
void LinuxJoyStick::setBuffered(bool buffered)
{
        if( buffered != mBuffered )
        {
                mBuffered = buffered;
                _initialize();
        }
}

//-------------------------------------------------------------------//
JoyStickInfo LinuxJoyStick::_getJoyInfo()
{
        JoyStickInfo js;

        js.devId = mDevID;
        js.joyFileD = mJoyStick;
        js.vendor = mVendor;
        js.axes = (int)mState.mAxes.size();
        js.buttons = (int)mState.mButtons.size();
        js.hats = mPOVs;
        js.button_map = mButtonMap;
        js.axis_map = mAxisMap;
        js.axis_range = mRanges;

        return js;
}

//-------------------------------------------------------------------//
JoyStickInfoList LinuxJoyStick::_scanJoys()
{
        JoyStickInfoList joys;

        //Search through all of the event devices.. and identify which ones are joysticks
        //xxx move this to InputManager, as it can also scan all other events
        for(int i = 0; i < 64; ++i )
        {
                std::stringstream s;
                s << "/dev/input/event" << i;
                int fd = open( s.str().c_str(), O_RDONLY |O_NONBLOCK );
                if(fd == -1)
                        continue;
                
        #ifdef OIS_LINUX_JOY_DEBUG
          std::cout << "\nOpening " << s.str() << "...";
        #endif
                try
                {
                        JoyStickInfo js;
                        if( EventUtils::isJoyStick(fd, js) )
                        {
                                joys.push_back(js);
                #ifdef OIS_LINUX_JOY_DEBUG
                  std::cout << "\n__Joystick added to list";
                #endif
                        }
                        else
                        {
                #ifdef OIS_LINUX_JOY_DEBUG
                  std::cout << "\n__Not a joystick!!";
                #endif
                                close(fd);
                        }
                }
                catch(...)
                {
            #ifdef OIS_LINUX_JOY_DEBUG
              std::cout << "\nException caught!!";
            #endif
                        close(fd);
                }
        }

        return joys;
}

//-------------------------------------------------------------------//
void LinuxJoyStick::_clearJoys(JoyStickInfoList &joys)
{
        for(JoyStickInfoList::iterator i = joys.begin(); i != joys.end(); ++i)
                close(i->joyFileD);
        joys.clear();
}

//-------------------------------------------------------------------//
Interface* LinuxJoyStick::queryInterface(Interface::IType type)
{
        if( ff_effect && type == Interface::ForceFeedback )
                return ff_effect;

        return 0;
}