Function serial_open

src/serial.c:215–365

* \brief Open serial port using port data only * \param rp port data structure (must spec port id eg /dev/ttyS1) * \return RIG_OK or < 0 if error */

 * \return RIG_OK or < 0 if error
 */
int HAMLIB_API serial_open(hamlib_port_t *rp)
{

    int fd;               /* File descriptor for the port */
    int err;

    if (!rp)
    {
        return (-RIG_EINVAL);
    }

#if defined(WIN32)
    int retcode = check_com_port_in_use(rp->pathname);

    switch (retcode)
    {
    case SER_IN_USE:
        rig_debug(RIG_DEBUG_ERR, "%s: serial port %s is already open\n", __func__,
                  rp->pathname);
        return -RIG_EACCESS;

    case SER_NO_EXIST:
        rig_debug(RIG_DEBUG_ERR, "%s: serial port %s does not exist\n", __func__,
                  rp->pathname);
        return -RIG_EIO;

    case SER_AVAILABLE:
        rig_debug(RIG_DEBUG_VERBOSE, "%s: serial port %s is OK\n", __func__, rp->pathname);
        break;
    }

#endif


    rig_debug(RIG_DEBUG_VERBOSE, "%s: %s\n", __func__, rp->pathname);

    if (!strncmp(rp->pathname, "uh-rig", 6))
    {
        /*
         * If the pathname is EXACTLY "uh-rig", try to use a microHam device
         * rather than a conventional serial port.
         * The microHam devices ALWAYS use "no parity", and can either use no handshake
         * or hardware handshake. Return with error if something else is requested.
         */
        if (rp->parm.serial.parity != RIG_PARITY_NONE)
        {
            return (-RIG_EIO);
        }

        if ((rp->parm.serial.handshake != RIG_HANDSHAKE_HARDWARE) &&
                (rp->parm.serial.handshake != RIG_HANDSHAKE_NONE))
        {
            return (-RIG_EIO);
        }

        /*
         * Note that serial setup is also don in uh_open_radio.
         * So we need to dig into serial_setup().