HandControlBase.h

Go to the documentation of this file.

/*
 * This file is part of ArmarX.
 *
 * ArmarX is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 * ArmarX is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 *
 * @package    ...
 * @author     Jianfeng Gao ( jianfeng dot gao at kit dot edu )
 * @date       2024
 * @copyright  http://www.gnu.org/licenses/gpl-2.0.txt
 *             GNU General Public License
 */
 
#pragma once
 
#include <VirtualRobot/Robot.h>
#include <VirtualRobot/RobotNodeSet.h>
#include <VirtualRobot/VirtualRobot.h>
 
#include <ArmarXCore/util/CPPUtility/TripleBuffer.h>
 
#include <RobotAPI/components/units/RobotUnit/ControlTargets/ControlTarget1DoFActuator.h>
 
#include <armarx/control/common/control_law/aron/HandStatus.aron.generated.h>
#include <armarx/control/common/device.h>
 
namespace armarx::control::njoint_controller::core
{
 
    namespace law = armarx::control::common::control_law;
 
    /**
    * @defgroup Library-HandControlBase HandControlBase
    * @ingroup Library-RobotUnit-NJointControllers
    * A description of the library HandControlBase.
    *
    * @class HandControlBase
    * @ingroup Library-HandControlBase
    * @brief Brief description of class HandControlBase.
    *
    * Detailed description of class HandControlBase.
    */
    class HandControlBase
    {
 
    public:
        using HandConfig = law::arondto::HandStatus;
        using HandConfigDict = std::map<std::string, HandConfig>;
 
        struct HandData
        {
            /// names
            std::string kinematicChainName;
            std::vector<std::string> jointNames;
            size_t nJoints;
 
            /// devices
            common::SensorDevicesForNJointTorqueController sensorDevices;
            std::vector<ControlTarget1DoFActuatorPosition*> targets;
 
            class RTStatus : public HandConfig
            {
            public:
                double deltaT = 0.0;
            };
 
            Eigen::VectorXf jointLimMin;
            Eigen::VectorXf jointLimMax;
 
            HandConfig targetRT;
            HandConfig targetNonRT;
            RTStatus rts;
 
            TripleBuffer<HandConfig> bufferNonRTToRT;
            TripleBuffer<RTStatus> bufferRTToNonRT;
            TripleBuffer<HandConfig> bufferUserToNonRT;
            TripleBuffer<HandConfig> bufferRTToUser;
 
            void validate();
            void setTarget();
 
            HandData(const VirtualRobot::RobotNodeSetPtr& robotNodeSet, const HandConfig& cfg);
            void rtPreActivate();
        };
 
        using HandPtr = std::unique_ptr<HandData>;
 
        HandControlBase(const VirtualRobot::RobotPtr& rtRobot, const HandConfigDict& cfg);
        ~HandControlBase(){};
 
 
        void appendDevice(const std::string& handNodeSet,
                          const SensorValueBase* sv,
                          ControlTargetBase* ct,
                          const std::string& jointName);
 
    public:
        void nonRTSetTarget();
        void setTargets();
        void updateRTStatus(const double deltaT);
        void nonRTUpdateStatus();
        void updateConfig(const HandConfigDict& cfg);
        void getConfig(HandConfigDict& cfgToUpdate);
        void reinitBuffer(HandConfigDict& cfgToUpdate);
        void rtPreActivate();
        void rtPostDeactivate();
 
    public:
        std::map<std::string, HandPtr> hands;
    };
 
    using HandControlPtr = std::shared_ptr<HandControlBase>;
} // namespace armarx::control::njoint_controller::core