Mecademic.py

Go to the documentation of this file.

# Copyright 2017 - RoboDK Software S.L. - http://www.robodk.com/
# 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.

# ----------------------------------------------------
# This file is a POST PROCESSOR for Robot Offline Programming to generate programs 
# for a Mecademic robot with RoboDK
#
# To edit/test this POST PROCESSOR script file:
# Select "Program"->"Add/Edit Post Processor", then select your post or create a new one.
# You can edit this file using any text editor or Python editor. Using a Python editor allows to quickly evaluate a sample program at the end of this file.
# Python should be automatically installed with RoboDK
#
# You can also edit the POST PROCESSOR manually:
#    1- Open the *.py file with Python IDLE (right click -> Edit with IDLE)
#    2- Make the necessary changes
#    3- Run the file to open Python Shell: Run -> Run module (F5 by default)
#    4- The "test_post()" function is called automatically
# Alternatively, you can edit this file using a text editor and run it with Python
#
# To use a POST PROCESSOR file you must place the *.py file in "C:/RoboDK/Posts/"
# To select one POST PROCESSOR for your robot in RoboDK you must follow these steps:
#    1- Open the robot panel (double click a robot)
#    2- Select "Parameters"
#    3- Select "Unlock advanced options"
#    4- Select your post as the file name in the "Robot brand" box
#
# To delete an existing POST PROCESSOR script, simply delete this file (.py file)
#
# ----------------------------------------------------
# More information about RoboDK Post Processors and Offline Programming here:
#     http://www.robodk.com/help#PostProcessor
#     http://www.robodk.com/doc/en/PythonAPI/postprocessor.html
# ----------------------------------------------------


# ----------------------------------------------------
# Import RoboDK tools
from robodk import *
from robolink import *

PATH_PYTHON = ''
#PATH_PYTHON = 'C:/Python34/python'

ROBOT_CLASS = '''
def print_message(message):
    """Force a print output"""
    print(message)
    sys.stdout.flush()
    
def msg_info(robot_msg):
    if robot_msg is None:
        return False, -1, "No communication"        
    problems = False
    msg_id = int(robot_msg[1:5])
    msg_str = robot_msg[7:-2]
    # msg_id = 1000 to 1500 are error codes
    if msg_id < 1500:
        problems = True            
    else:
        # Other error codes
        error_codes = [3001, 3003]
        if msg_id in error_codes:
            problems = True            
    if problems:
        print_message(robot_msg)
    return problems, msg_id, msg_str
    
class MecaRobot:
    """Robot class for programming Mecademic robots"""
    def __init__(self, ip, port):
        import socket
        self.BUFFER_SIZE = 512 # bytes
        self.TIMEOUT = 999999 # seconds
        self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        self.sock.settimeout(self.TIMEOUT)
        print_message('Connecting to robot %s:%i' % (ip, port))
        self.sock.connect((ip, port))
        print_message('Waiting for welcome message...')
        
        # receive welcome message and output to the log
        problems, msg_id, msg_str = msg_info(self.recv_str())
        if problems:
            print_message(msg_str)
            raise Exception(msg_str)
            return
        
        # Reset errors, send activate robot and read confirmation
        self.sock.settimeout(10)
        self.Run('ResetError',sync=True)
        self.Run('ActivateRobot',sync=True)
        self.sock.settimeout(30)
        self.Run('Home',sync=True)

    def send_str(self, msg):
        sent = self.sock.send(bytes(msg+'\\0','ascii'))
        if sent == 0:
            raise RuntimeError("Robot connection broken")

    def recv_str(self):
        bdata = self.sock.recv(self.BUFFER_SIZE)
        if bdata == b'':
            raise RuntimeError("Robot connection broken")
        return bdata.decode('ascii')
        
    def Run(self, cmd, values=None, sync=False):
        if isinstance(values, list):
            if cmd == "Gripper":
                str_send = cmd + '(' + (','.join(format(vi, ".0f") for vi in values)) + ')'
            else:
                str_send = cmd + '(' + (','.join(format(vi, ".6f") for vi in values)) + ')'
        elif values is None:
            str_send = cmd
        else:
            str_send = cmd + '(' + str(values) + ')'
        
        print_message('Running: %s' % str_send)
        
        # send command to robot
        self.send_str(str_send)
        if sync:
            robot_msg = self.recv_str()
            problems, msg_id, msg_str = msg_info(robot_msg)
            print_message('Received: %s' % robot_msg)
            if problems:
                raise Exception(msg_str)          
        return True
        
if __name__ == "__main__":
    """Call Main procedure"""
    # It is important to disconnect the robot if we force to stop the process
    import atexit
    atexit.register(RobotDisconnect)
    
'''


def print_message(message):
    print(message)
    sys.stdout.flush()
    
# ----------------------------------------------------
def pose_2_str(pose):
    """Prints a pose target"""
    [x,y,z,r,p,w] = Pose_2_TxyzRxyz(pose)
    return ('[%.3f, %.3f, %.3f, %.3f, %.3f, %.3f]' % (x,y,z,r*180.0/pi,p*180.0/pi,w*180.0/pi))
    
def joints_2_str(joints):
    """Prints a joint target"""
    str = '['
    for i in range(len(joints)):
        str = str + ('%.6f, ' % joints[i])
    str = str[:-2] + ']'
    return str

# ----------------------------------------------------    
# Object class that handles the robot instructions/syntax
class RobotPost(object):
    """Robot post object"""
    PROG_EXT = 'py'        # set the program extension    
    ROBOT_IP = '192.168.0.100';
    ROBOT_PORT = 10000
    
    # other variables
    ROBOT_POST = ''
    ROBOT_NAME = ''
    PROG_FILES = []    
    
    PROG = ''
    LOG = ''
    TAB = ''
    MAIN_PROG_NAME = None
    nAxes = 6
    Prog_count = 0

    
    def __init__(self, robotpost=None, robotname=None, robot_axes = 6, **kwargs):
        self.ROBOT_POST = robotpost
        self.ROBOT_NAME = robotname
        self.PROG = ''
        self.LOG = ''
        self.nAxes = robot_axes
        
    def ProgStart(self, progname):
        self.Prog_count = self.Prog_count + 1
        self.addline('def %s():' % progname)
        self.TAB = '    '
        if self.MAIN_PROG_NAME is None:
            self.MAIN_PROG_NAME = progname
            self.addline("'''Main procedure'''")
            self.addline('global robot')
            self.addline('RobotConnect()')
        else:
            self.addline('global robot')
        self.addline('print_message("Running program %s...")' % progname)
        
    def ProgFinish(self, progname):
        self.addline('print_message("Program %s Sent")' % progname)
        if self.Prog_count == 1:
            #self.addline('import time')
            #self.addline('time.pause(2)')
            pass
        self.TAB = ''
        self.addline('')        
        
        
    def ProgSave(self, folder, progname, ask_user=False, show_result=False):
        import subprocess
        progname = progname + '.' + self.PROG_EXT
        if ask_user or not DirExists(folder):
            filesave = getSaveFile(folder, progname, 'Save program as...')
            if filesave is not None:
                filesave = filesave.name
            else:
                return
        else:
            filesave = folder + '/' + progname
        
        # retrieve robot IP
        RDK = Robolink()
        robot = RDK.Item(self.ROBOT_NAME, ITEM_TYPE_ROBOT)
        [server_ip, port, remote_path, username, password] = robot.ConnectionParams()            
            
        fid = open(filesave, "w")
        
        fid.write('MECA_IP = "%s"   # IP of the robot\n' % server_ip) #self.ROBOT_IP)
        fid.write('MECA_PORT = %i   # Communication port\n\n' % self.ROBOT_PORT)
        fid.write('import time\n')
        fid.write('import sys\n')        
        fid.write('global robot\n\n')
        fid.write(self.PROG)

        fid.write('def Gripper(set_open=0):\n')
        fid.write('    global robot\n')
        fid.write('    robot.Run("Gripper", [set_open])\n')
        fid.write('\n')        
        fid.write('def RobotConnect():\n')
        fid.write("    '''Establish connection with the robot'''\n")
        fid.write('    global robot\n')
        fid.write('    robot = MecaRobot(MECA_IP, MECA_PORT)\n\n')
        fid.write('def RobotDisconnect():\n')
        fid.write("    '''Establish connection with the robot'''\n")
        fid.write('    global robot\n')
        fid.write('    try:\n')
        fid.write('        if robot.sock != None:\n')        
        fid.write('            robot.sock.close()\n')        
        fid.write('            robot.sock = None\n')
        fid.write('    except Exception as e:\n')
        fid.write('        print_message(str(e))\n')
        fid.write('\n#----------- communication class -------------\n')
        fid.write(ROBOT_CLASS)
        fid.write('    %s()\n' % self.MAIN_PROG_NAME)
        fid.write('    \n')
        fid.write('    print_message("Program sent.\\nWaiting for program to finish...")\n')
        fid.write('    robot.sock.settimeout(1e6)\n')
        fid.write('    \n')
        fid.write('    problems, msg_id, msg_str = msg_info(robot.recv_str())\n')
        fid.write('    while not problems and msg_id != 3012:\n')
        fid.write('        print_message("Working... (" + msg_str + ")")\n')
        fid.write('        problems, msg_id, msg_str = msg_info(robot.recv_str())\n')
        fid.write('    \n')
        fid.write('    print_message("Done. Closing in 2 seconds...")\n')
        fid.write('    time.sleep(2)\n\n')
        fid.write('    \n')
        fid.write('    RobotDisconnect()\n')        
        #fid.write('    # pause execution before closing process (allows users to read last message)\n')
        #fid.write('    time.sleep(2)\n')
        fid.write('\n\n')
        fid.close()
        print('SAVED: %s\n' % filesave)
        self.PROG_FILES = filesave
        #---------------------- show result
        
        #selection_view = mbox('Do you want to view/edit the program or run it on the robot?', 'View', 'Run')            
        selection_view = True
        
        if selection_view and show_result:
            if type(show_result) is str:
                # Open file with provided application
                import subprocess
                p = subprocess.Popen([show_result, filesave])   
            elif type(show_result) is list:
                import subprocess
                p = subprocess.Popen(show_result + [filesave])   
            else:
                # open file with default application
                import os
                os.startfile(filesave)  

            if len(self.LOG) > 0:
                mbox('Program generation LOG:\n\n' + self.LOG)
        
        if not selection_view:
            RDK.ShowMessage('Running program...', False)
            proc = subprocess.Popen(['python', filesave])
            
            # Using the same pipe
            #import io
            #proc = subprocess.Popen(['python', filesave], stdout=subprocess.PIPE)
            #for line in io.TextIOWrapper(proc.stdout, encoding="utf-8"):  # or another encoding
            #    RDK.ShowMessage(line, False)
        
        
    def ProgSendRobot(self, robot_ip, remote_path, ftp_user, ftp_pass):
        """Send a program to the robot using the provided parameters. This method is executed right after ProgSave if we selected the option "Send Program to Robot".
        The connection parameters must be provided in the robot connection menu of RoboDK"""
        import subprocess
        import os
        import sys
        import time
        
        print_message("POPUP: Starting process...")     
        print("Python path " + PATH_PYTHON)
        print("Program file: " + self.PROG_FILES)
        
        # Start process
        cmd_run = self.PROG_FILES # run py file itself
        if PATH_PYTHON != '':
            # if a python path is specified, use it to run the Py file
            cmd_run = [PATH_PYTHON, self.PROG_FILES]
            
        process = subprocess.Popen(cmd_run, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, universal_newlines=True)
        
        # Poll process for new output until finished
        for stdout_line in iter(process.stdout.readline, ""):
            print_message("POPUP: " + stdout_line.strip())
            
        process.stdout.close()
        return_code = process.wait()
        if return_code != 0:
            #raise subprocess.CalledProcessError(return_code, cmd_run)
            pause(2)
        else:
            print_message("POPUP: Done.")
            pause(1)

        #if (return_code == 0):
        #    return
        #else:
        #    #raise ProcessException(command, return_code, output)
        #    pause(2)
        #    return
        
    def MoveJ(self, pose, joints, conf_RLF=None):
        """Add a joint movement"""
        self.addline("robot.Run('MoveJoints', %s)" % joints_2_str(joints))
        
        # A MoveJ in cartesian space would be:
        #if pose is not None:
        #    # self.addline("robot.Run('SetConf', [%i,%i,%i])" % (conf_RLF[0], conf_RLF[1], conf_RLF[2])
        #    self.addline("robot.Run('MovePose', %s)" % pose_2_str(pose))
        
        
    def MoveL(self, pose, joints, conf_RLF=None):
        """Add a linear movement"""
        if pose is None:
            # no linear movement allowed by providing joints
            self.addline("robot.Run('MoveJoints', %s)" % joints_2_str(joints))
        else:
            self.addline("robot.Run('MoveLin', %s)" % pose_2_str(pose))
        
    def MoveC(self, pose1, joints1, pose2, joints2, conf_RLF_1=None, conf_RLF_2=None):
        """Add a circular movement"""
        self.addlog("Cicular moves not supported")
        
    def setFrame(self, pose, frame_id=None, frame_name=None):
        """Change the robot reference frame"""
        self.addline("robot.Run('SetWRF', %s)" % pose_2_str(pose))
        
    def setTool(self, pose, tool_id=None, tool_name=None):
        """Change the robot TCP"""
        self.addline("robot.Run('SetTRF', %s)" % pose_2_str(pose))
        
    def Pause(self, time_ms):
        """Pause the robot program"""
        if time_ms < 0:
            self.addline("robot.Run('Delay', 0, sync=True)")
            self.addline('input("Robot paused. Press Enter to continue...")')
        else:
            #self.addline('time.sleep(%.3f)' % (float(time_ms)*0.001))
            self.addline("robot.Run('Delay', %s)" % (float(time_ms)*0.001))
    
    def setSpeed(self, speed_mms):
        """Changes the robot speed (in mm/s)"""
        self.addline("robot.Run('SetCartVel', %.3f)" % min(speed_mms,500))
    
    def setAcceleration(self, accel_mmss):
        """Changes the robot acceleration (in mm/s2)"""
        self.addlog('Linear acceleration not supported')
    
    def setSpeedJoints(self, speed_degs):
        """Changes the robot joint speed (in deg/s)"""
        self.addline("robot.Run('SetJointVel', %.3f)" % speed_degs)
    
    def setAccelerationJoints(self, accel_degss):
        """Changes the robot joint acceleration (in deg/s2)"""
        self.addlog('Joint acceleration not supported')
        
    def setZoneData(self, zone_mm):
        """Changes the smoothing radius (aka CNT, APO or zone data) to make the movement smoother"""
        if zone_mm > 0:
            self.addline("robot.Run('SetCornering', 1)")
        else:
            self.addline("robot.Run('SetCornering', 0)")

    def setDO(self, io_var, io_value):
        """Sets a variable (digital output) to a given value"""
        if type(io_var) != str:  # set default variable name if io_var is a number
            io_var = 'OUT[%s]' % str(io_var)
        if type(io_value) != str: # set default variable value if io_value is a number
            if io_value > 0:
                io_value = 'TRUE'
            else:
                io_value = 'FALSE'

        # at this point, io_var and io_value must be string values
        # self.addline('%s=%s' % (io_var, io_value))
        self.addline("robot.Run('Delay', 0, sync=True)")
        self.addline('# robot.setDO(%s=%s)' % (io_var, io_value))
        self.addlog('Digital IOs not managed by the robot (%s=%s)' % (io_var, io_value))

    def waitDI(self, io_var, io_value, timeout_ms=-1):
        """Waits for a variable (digital input) io_var to attain a given value io_value. Optionally, a timeout can be provided."""
        if type(io_var) != str:  # set default variable name if io_var is a number
            io_var = 'IN[%s]' % str(io_var)
        if type(io_value) != str: # set default variable value if io_value is a number
            if io_value > 0:
                io_value = 'TRUE'
            else:
                io_value = 'FALSE'

        # at this point, io_var and io_value must be string values
        if timeout_ms < 0:
            #self.addline('WAIT FOR %s==%s' % (io_var, io_value))
            self.addline("robot.Run('Delay', 0, sync=True)")
            self.addline('# robot.waitDI(%s=%s)' % (io_var, io_value))
            self.addlog('Digital IOs not managed by the robot (WAIT FOR %s==%s)' % (io_var, io_value))
        else:
            #self.addline('WAIT FOR %s==%s TIMEOUT=%.1f' % (io_var, io_value, timeout_ms))
            self.addline("robot.Run('Delay', 0, sync=True)")
            self.addline('# robot.waitDI(%s=%s, %.0f)' % (io_var, io_value, timeout_ms))
            self.addlog('Digital IOs not managed by the robot (WAIT FOR %s==%s)' % (io_var, io_value))
        
    def RunCode(self, code, is_function_call = False):
        """Adds code or a function call"""
        if is_function_call:
            code.replace(' ','_')
            if not code.endswith(')'):
                code = code + '()'
            self.addline(code)
        else:
            self.addline(code)
        
    def RunMessage(self, message, iscomment = False):
        """Display a message in the robot controller screen (teach pendant)"""
        if iscomment:
            self.addline('# ' + message)
        else:
            self.addline('print("%s")' % message)
        
# ------------------ private ----------------------                
    def addline(self, newline):
        """Add a program line"""
        self.PROG = self.PROG + self.TAB + newline + '\n'
        
    def addlog(self, newline):
        """Add a log message"""
        self.LOG = self.LOG + newline + '\n'

# -------------------------------------------------
# ------------ For testing purposes ---------------   
def Pose(xyzrpw):
    [x,y,z,r,p,w] = xyzrpw
    a = r*math.pi/180
    b = p*math.pi/180
    c = w*math.pi/180
    ca = math.cos(a)
    sa = math.sin(a)
    cb = math.cos(b)
    sb = math.sin(b)
    cc = math.cos(c)
    sc = math.sin(c)
    return Mat([[cb*ca, ca*sc*sb - cc*sa, sc*sa + cc*ca*sb, x],[cb*sa, cc*ca + sc*sb*sa, cc*sb*sa - ca*sc, y],[-sb, cb*sc, cc*cb, z],[0,0,0,1]])

def test_post():
    """Test the post with a basic program"""

    robot = RobotPost()

    robot.ProgStart("Program")
    robot.RunMessage("Program generated by RoboDK using a custom post processor", True)
    robot.setFrame(Pose([807.766544, -963.699898, 41.478944, 0, 0, 0]))
    robot.setTool(Pose([62.5, -108.253175, 100, -60, 90, 0]))
    robot.MoveJ(Pose([200, 200, 500, 180, 0, 180]), [-46.18419, -6.77518, -20.54925, 71.38674, 49.58727, -302.54752] )
    robot.MoveL(Pose([200, 250, 348.734575, 180, 0, -150]), [-41.62707, -8.89064, -30.01809, 60.62329, 49.66749, -258.98418] )
    robot.MoveL(Pose([200, 200, 262.132034, 180, 0, -150]), [-43.73892, -3.91728, -35.77935, 58.57566, 54.11615, -253.81122] )
    robot.RunMessage("Setting air valve 1 on")
    robot.RunCode("TCP_On", True)
    robot.Pause(1000)
    robot.MoveL(Pose([200, 250, 348.734575, 180, 0, -150]), [-41.62707, -8.89064, -30.01809, 60.62329, 49.66749, -258.98418] )
    robot.MoveL(Pose([250, 300, 278.023897, 180, 0, -150]), [-37.52588, -6.32628, -34.59693, 53.52525, 49.24426, -251.44677] )
    robot.MoveL(Pose([250, 250, 191.421356, 180, 0, -150]), [-39.75778, -1.04537, -40.37883, 52.09118, 54.15317, -246.94403] )
    robot.RunMessage("Setting air valve off")
    robot.RunCode("TCP_Off", True)
    robot.RunCode("Gripper(1)", True)
    robot.Pause(1000)
    robot.MoveL(Pose([250, 300, 278.023897, 180, 0, -150]), [-37.52588, -6.32628, -34.59693, 53.52525, 49.24426, -251.44677] )
    robot.MoveL(Pose([250, 200, 278.023897, 180, 0, -150]), [-41.85389, -1.95619, -34.89154, 57.43912, 52.34162, -253.73403] )
    robot.MoveL(Pose([250, 150, 191.421356, 180, 0, -150]), [-43.82111, 3.29703, -40.29493, 56.02402, 56.61169, -249.23532] )
    robot.MoveJ(None, [-46.18419, -6.77518, -20.54925, 71.38674, 49.58727, -302.54752] )
    robot.ProgFinish("Program")
    # robot.ProgSave(".","Program",True)
    print(robot.PROG)
    if len(robot.LOG) > 0:
        mbox('Program generation LOG:\n\n' + robot.LOG)

    input("Press Enter to close...")

if __name__ == "__main__":
    """Function to call when the module is executed by itself: test"""
    test_post()