Other useful resources ¶ OSCAT http://www.oscat.de/ ¶ The OSCAT BASIC library provides many low-level — but nevertheless very useful — functionalities. The following are especially worth mentioning: Mathematics, complex mathematics, vector mathematics Arithmetic functions Geometric functions Pulse generators / signal generators Signal processing Physical transformation calculations (For example, F_TO_PT converts a frequency value of Hz in the corresponding period.) The OSCAT BASIC library build into a CODESYS package can be downloaded from the CODESYS store ( https://store.codesys.com/oscat-basic.html ). The OSCAT BUILDING library provides building-automation-specific functionalities. The following are especially worth mentioning: Some very simple actuators Some simple aggregates - BOILER, BURNER Computation of physics Blind modules The OSCAT BUILDING library build into a CODESYS package can be downloaded from the CODESYS store ( https://store.codesys.com/oscat-building.html ). OSCAT BUILDING LIBRARY - computation of physics. The following are especially worth mentioning: ¶ Air density depending on pressure, humidity, and temperature - AIR_DENSITY Calorimeter - HEAT_METER Dew point temperature depending on water vapor concentration (VC) and temperature - DEW_TEMP Density of liquid water as a function of temperature at atmospheric pressure - WATER_DENSITY Enthalpy of liquid water as a function of temperature at atmospheric pressure — WATER_ENTHALPY Enthalpy of moist air depending on temperature and relative humidity - AIR_ENTHALPY Relative humidity depending on water vapor concentration (VC) and temperature - DEW_RH Saturation vapor pressure for water vapor in air - SDD Saturation vapor pressure for ammonia (NH3) - SDD_NH3 Specifc heat capacity of liquid water as a function of temperature at atmospheric pressure - WATER_CP Water vapor concentration in the air depending on temperature and relative humidity - DEW_CON OSCAT BUILDING LIBRARY - blind modules: ¶ Blind actuator - BLIND_ACTUATOR Blind fin angle control - BLIND_CONTROL Blind position control - BLIND_CONTROL_S Blind protection - BLIND_SECURITY Blind optimum shading - BLIND_SHADE / BLIND_SHADE_S Closing blinds at night - BLIND_NIGHT Scene control for blinds - BLIND_SCENE

CmpCharDevice2 Interfaces Library Documentation ¶ Company 3S - Smart Software Solutions GmbH Title CmpCharDevice2 Interfaces Version 3.5.19.0 Categories System|SysLibs Author CODESYS Development GmbH Description 1 ¶ Interfaces of the Linux runtime component CmpCharDevice Contents: ¶ CmpCharDevice Interfaces ACCESS_MODE (Enum) GVL (GVL) MMAPS_FLAGS (Enum) MMAP_PROT (Enum) SEEK_MODE (Enum) Indices and tables ¶ 1 Based on CmpCharDevice2_Itfs.library, last modified 02.03.2023, 11:01:18. LibDoc 4.4.0.0-b.27 The content file CmpCharDevice2_Itfs.clean.json was generated with CODESYS V3.5 SP16 Patch 3 on 02.03.2023, 11:01:20.

CmpCharDevice Interfaces ¶ ACCESS_MODE (Enum) GVL (GVL) MMAPS_FLAGS (Enum) MMAP_PROT (Enum) SEEK_MODE (Enum)

ACCESS_MODE (ENUM) ¶ TYPE ACCESS_MODE : InOut: Name Initial O_RDONLY 0 O_WRONLY 1 O_RDWR 2

GVL (GVL) ¶ InOut: Scope Name Type Initial Constant MAP_FAILED __XWORD -1

Persistence as an option ¶ Some function blocks in the CODESYS Building Automation library contain data which may require persistence. |OperationalTime| .tOp could be a good example. Of course, some applications may not require those values to be persistent, but rather save the resources needed to handle persistence. In case persistence is required, the CODESYS Application Composer Module “Persistence Manager” can be used to provide this. For detailed information about the “Persistence Manager”, see https://help.codesys.com/webapp/ac_pm_overview;product=core_Application_Composer . Optional persistent aspects in the CODESYS Building Automation library carry the {attribute ‘ac_persist’} with a named “persistence group”. Right now, the CODESYS Building Automation library requires the application to use the “Persistence Manager” in a way to restore persistent aspects during initialization. To achieve this, set PersistenceManager.PersistenceChannel.xReadVarsDuringInit to TRUE. Currently, the following “persistence groups” exist in the CODESYS Building Automation library: BuildingLib_OperationalTime - operational time / counters of actuators, aggregates, etc.

MMAPS_FLAGS (ENUM) ¶ TYPE MMAPS_FLAGS : InOut: Name Initial MAP_SHARED 1 MAP_SHARED_VALIDATE 3 MAP_PRIVATE 2

MMAP_PROT (ENUM) ¶ TYPE MMAP_PROT : InOut: Name Initial PROT_EXEC 4 PROT_READ 1 PROT_WRITE 2 PROT_NONE 0

SEEK_MODE (ENUM) ¶ TYPE SEEK_MODE : InOut: Name Initial SEEK_SET 0 SEEK_CUR 1 SEEK_END 2

BuildingAutomation ¶ The Building Lib … Doc Aggregate variants CFC-specific considerations Example Air types - Terms, abbreviations, and colors Compile options Levels of application development and functional aspects covered currently Levels of application development covered currently Functional aspects covered currently Examples Functional aspects in the building automation field Implementation Implementation language Implementation rules Introduction Legal Disclaimer License Terms Levels of building automation application development Other useful resources OSCAT http://www.oscat.de/ OSCAT BUILDING LIBRARY - computation of physics. The following are especially worth mentioning: OSCAT BUILDING LIBRARY - blind modules: Persistence as an option System requirements and restrictions Exceptions System schemes Visualization Non-real-time testing and simulation - how to use the “warp clock” What is the “warp clock”? How to use the “warp clock”? Enums AutoOnOff (Enum) EnergyLevel (Enum) Error (Enum) HeatCoolOperationMode (Enum) ServiceIndication (Enum) Function Blocks Actuator Fan3Stage (FunctionBlock) Fan3StageState (Enum) HVAC_Coil (FunctionBlock) Functionality SetError (Method) HVAC_RotaryHeatExchanger (FunctionBlock) Functionality optional cleaning operation malfunction detection malfunction locking SetError (Method) HeatCool2Linear (FunctionBlock) IActuatorContinuous (Interface) DateTimeProvider (Property) Enable (Property) ErrorIdOut (Property) ErrorOut (Property) Reset (Property) Setpoint (Property) IActuatorOnOff (Interface) DateTimeProvider (Property) ErrorIdOut (Property) ErrorOut (Property) IsOn (Property) RequestOn (Property) Reset (Property) IValveContinuous (Interface) PumpOnOff (FunctionBlock) Application example Device examples Functionality on / off delay blocking protection command execution monitoring malfunction detection malfunction locking DateTimeProvider (Property) ErrorIdOut (Property) ErrorOut (Property) IsOn (Property) RequestOn (Property) Reset (Property) ValveContinuous (FunctionBlock) Functionality Blocking protection DateTimeProvider (Property) Enable (Property) ErrorIdOut (Property) ErrorOut (Property) Reset (Property) Setpoint (Property) ValveSixWay (FunctionBlock) Application example Device examples Functionality ValveThermo (FunctionBlock) Application example Device examples Functionality Normally closed valves and warmup: Blocking protection DateTimeProvider (Property) Enable (Property) ErrorIdOut (Property) ErrorOut (Property) Reset (Property) Setpoint (Property) ValveThermoWarmupState (Enum) WindowActuator (FunctionBlock) Application example Device examples Functionality WindowActuatorState (Enum) Aggregates Examples ExampleFancoil3StageAggregate (FunctionBlock) Fancoil3Stage (FunctionBlock) Functionality Control of fan speed dependent on valve position or control deviation FancoilContinuous (FunctionBlock) Application example Device examples Why does CODESYS Building Automation library contain a fan coil unit control strategy, even if some fan coil units come with integrated controller? Functionality Characteristic curve of fan speed Assemblies FourToTwoPipes (FunctionBlock) Application example Functionality Control CommandExecutionMonitoring (FunctionBlock) CommandVariable (FunctionBlock) HVAC_AntiFreezeControlMonitor (FunctionBlock) Application example Functionality HVAC_AntiFreezeControlSensor (FunctionBlock) Application example Functionality HVAC_AntiFreezeControlStartup (FunctionBlock) Application example Functionality RedundantPlantControl8 (FunctionBlock) SequenceControl (FB) Sequence combinations: Sequence relations: Control algorithm inputs: Relation between setpoints sequences: Other control characteristics: Integrator dynamics Reset “Anti windup” (integration limit) “Soft set” SequenceControlSequences (Enum) SequenceSwitch (FunctionBlock) Examples ExampleAirConditioning1 (FB) Air types Sequence control heater coil / cooler coil Hints Caveats ExampleAirConditioning2 (FB) Air types Sequence control damper / heater coil / cooler coil Recirculation air admixing and energy selection Minimum outdoor air ratio Water side anti-freeze for heater coil Air side anti-freeze Hints Caveats ExampleHeating (FunctionBlock) Heating circuit operation Night time setpoint reduction vs. switching off heating circuit operation Economy mode Optional anti-freeze Caveats ExampleHotWater (FunctionBlock) 2 point control of boiler temperature Legionella prevention Optional unload protection Caveats ExampleRoomAutomation (FB) Air types Presence controlled energy level Night cooling Energy lock Sommer compensation Fast heat / cool Window alarm Manual fan control Hints Caveats ExampleVariantsRoomControlFCUSimple (FunctionBlock) Examples_ImagePool (ImagePool) Misc DailyMeanTemperature (FunctionBlock) When does the daily mean temperature gets valid? “Warp clock”-enabled HeatingCharacteristicCurve (FunctionBlock) Application example Functionality HysteresisReal (FunctionBlock) LogBoolChange (FunctionBlock) RoomSetpoint (FunctionBlock) “effective comfort setpoint” Setpoint outputs - whats the difference Optimization EnergyLevelSetpoint (FunctionBlock) VDI 3814 reference HeatCoolUsingOutdoorAir (FB) Functionality Cooling mode Heating mode Time related DateTimeSplit (FunctionBlock) MaxOnTime (FunctionBlock) “Warp clock”-enabled MinOnOffTime (FunctionBlock) “Warp clock”-enabled OnOffDelay (FunctionBlock) “Warp clock”-enabled OperationalTime (FunctionBlock) “Warp clock”-enabled PeriodicTimer (FunctionBlock) “Warp clock”-enabled WarpClock (FunctionBlock) AddTime (Method) ComputeWarpFactor (Method) GetDateTime (Method) GetLocalSystemTime (Method) GetUtcSystemTime (Method) Functions LinTransf (Function) LinTransfClip (Function) LinTransfNormalized (Function) Log RealEquals (Function) RealGreaterEqual (Function) RealInRange (Function) RealLessEqual (Function) ServiceIndicationValue (Function) Time related DateTimeToString (Function) UdintInRange (Function)