_target = None
_threads = None

def on_launch(target):
    """
    Define in this function actions to be executed on launch during
    the connection attempt. This function is automatically executed
    after the Sysdbg CLI is started. For example, global variables
    _target and _threads used in this module can be initialized.
    If defined, this function must have the definition above, so
    that it can be correctly executed: "def on_launch(target)".

    :param target: target variable on global scope
    :type target: Session
    :returns: None
    """

    # If _target and _threads global variables are used in
    # other functions in this module, initialize them here.
    global _target
    global _threads
    _target = target
    _threads = target.threads
    # Add here other actions to be executed on launch (optionally).

def read_ioport(port):
    """
    Read an IO port on the first thread of the target.
    :param port: address of the IO port (port number)
    :type port: int
    :returns: int value of the IO port
    """

    return _threads[0].io(1, port)

def write_ioport(port, value):
    """
    Write an IO port on the first thread of the target.
    :param port: address of the IO port (port number)
    :type port: int
    :param value: value to be written
    :type value: int
    :returns: None on successful operation
    """

    return _threads[0].io(1, port, value)

def go():
    """
    Resume the target.
    :returns: True on successful operation
    """

    return _target.go()

def halt():
    """
    Halt the target.
    :returns: True on successful operation
    """

    return _target.halt()

def step_into():
    """
    Perform a step into operation on the first thread of the target.
    :returns: None on successful operation
    """

    return _threads[0].step_into(instruction=True)

def set_bp(address):
    """
    Add a breakpoint on the first thread of the target.
    :param address: address of the breakpoint to add
    :type address: int
    :returns: the Breakpoint object added
    """

    return _threads[0].set_breakpoint(address=address)

def remove_bp(bp):
    """
    Remove a breakpoint on the first thread of the target.
    :param bp: Breakpoint object or breakpoint ID to remove
    :type bp: Breakpoint object or str
    :returns: True on successful operation
    """

    return _threads[0].remove_breakpoint(bp)