/** * <summary> * Retrieves a CO2 sensor for a given identifier in a YAPI context. * <para> * The identifier can be specified using several formats: * </para> * <para> * </para> * <para> * - FunctionLogicalName * </para> * <para> * - ModuleSerialNumber.FunctionIdentifier * </para> * <para> * - ModuleSerialNumber.FunctionLogicalName * </para> * <para> * - ModuleLogicalName.FunctionIdentifier * </para> * <para> * - ModuleLogicalName.FunctionLogicalName * </para> * <para> * </para> * <para> * This function does not require that the CO2 sensor is online at the time * it is invoked. The returned object is nevertheless valid. * Use the method <c>YCarbonDioxide.isOnline()</c> to test if the CO2 sensor is * indeed online at a given time. In case of ambiguity when looking for * a CO2 sensor by logical name, no error is notified: the first instance * found is returned. The search is performed first by hardware name, * then by logical name. * </para> * </summary> * <param name="yctx"> * a YAPI context * </param> * <param name="func"> * a string that uniquely characterizes the CO2 sensor, for instance * <c>YCO2MK02.carbonDioxide</c>. * </param> * <returns> * a <c>YCarbonDioxide</c> object allowing you to drive the CO2 sensor. * </returns> */ public static YCarbonDioxide FindCarbonDioxideInContext(YAPIContext yctx, string func) { YCarbonDioxide obj; obj = (YCarbonDioxide)YFunction._FindFromCacheInContext(yctx, "CarbonDioxide", func); if (obj == null) { obj = new YCarbonDioxide(yctx, func); YFunction._AddToCache("CarbonDioxide", func, obj); } return(obj); }
/** * <summary> * Retrieves a CO2 sensor for a given identifier. * <para> * The identifier can be specified using several formats: * </para> * <para> * </para> * <para> * - FunctionLogicalName * </para> * <para> * - ModuleSerialNumber.FunctionIdentifier * </para> * <para> * - ModuleSerialNumber.FunctionLogicalName * </para> * <para> * - ModuleLogicalName.FunctionIdentifier * </para> * <para> * - ModuleLogicalName.FunctionLogicalName * </para> * <para> * </para> * <para> * This function does not require that the CO2 sensor is online at the time * it is invoked. The returned object is nevertheless valid. * Use the method <c>YCarbonDioxide.isOnline()</c> to test if the CO2 sensor is * indeed online at a given time. In case of ambiguity when looking for * a CO2 sensor by logical name, no error is notified: the first instance * found is returned. The search is performed first by hardware name, * then by logical name. * </para> * <para> * If a call to this object's is_online() method returns FALSE although * you are certain that the matching device is plugged, make sure that you did * call registerHub() at application initialization time. * </para> * <para> * </para> * </summary> * <param name="func"> * a string that uniquely characterizes the CO2 sensor, for instance * <c>YCO2MK02.carbonDioxide</c>. * </param> * <returns> * a <c>YCarbonDioxide</c> object allowing you to drive the CO2 sensor. * </returns> */ public static YCarbonDioxide FindCarbonDioxide(string func) { YCarbonDioxide obj; obj = (YCarbonDioxide)YFunction._FindFromCache("CarbonDioxide", func); if (obj == null) { obj = new YCarbonDioxide(func); YFunction._AddToCache("CarbonDioxide", func, obj); } return(obj); }