public static YAltitudeProxy FindAltitude(string name)
        {
            // cases to handle:
            // name =""  no matching unknwn
            // name =""  unknown exists
            // name != "" no  matching unknown
            // name !="" unknown exists
            YAltitude      func = null;
            YAltitudeProxy res  = (YAltitudeProxy)YFunctionProxy.FindSimilarUnknownFunction("YAltitudeProxy");

            if (name == "")
            {
                if (res != null)
                {
                    return(res);
                }
                res = (YAltitudeProxy)YFunctionProxy.FindSimilarKnownFunction("YAltitudeProxy");
                if (res != null)
                {
                    return(res);
                }
                func = YAltitude.FirstAltitude();
                if (func != null)
                {
                    name = func.get_hardwareId();
                    if (func.get_userData() != null)
                    {
                        return((YAltitudeProxy)func.get_userData());
                    }
                }
            }
            else
            {
                func = YAltitude.FindAltitude(name);
                if (func.get_userData() != null)
                {
                    return((YAltitudeProxy)func.get_userData());
                }
            }
            if (res == null)
            {
                res = new YAltitudeProxy(func, name);
            }
            if (func != null)
            {
                res.linkToHardware(name);
                if (func.isOnline())
                {
                    res.arrival();
                }
            }
            return(res);
        }
        /**
         * <summary>
         *   Enumerates all functions of type Altitude available on the devices
         *   currently reachable by the library, and returns their unique hardware ID.
         * <para>
         *   Each of these IDs can be provided as argument to the method
         *   <c>YAltitude.FindAltitude</c> to obtain an object that can control the
         *   corresponding device.
         * </para>
         * </summary>
         * <returns>
         *   an array of strings, each string containing the unique hardwareId
         *   of a device function currently connected.
         * </returns>
         */
        public static new string[] GetSimilarFunctions()
        {
            List <string> res = new List <string>();
            YAltitude     it  = YAltitude.FirstAltitude();

            while (it != null)
            {
                res.Add(it.get_hardwareId());
                it = it.nextAltitude();
            }
            return(res.ToArray());
        }