ChangeLog

Version 3.9.15 (25 Oct 2024)

• Rework of EVSE design from WG
• #1109: rework elec phase modeling to use new suite of tags
• #1056: batch hisRead and hisWrite API operations
• #1125: add synthetics tags
• Flush out more HTTP API examples (in both Zinc and JSON)
• Formalize Filter specify for comparison of Numbers with units
• Add Xeto specs to Filter syntax
• Rename computed to computedFromReciprocal for associations
• Rework docHaystack Meters chapter

Version 3.9.14 (22 Mar 2023)

• New systems design
• New units: kg/L, mg/L, in/h, mm/h

Version 3.9.13 (29 Nov 2022)

• Stub out system marker tag
• Merge in VRF branch
• #986: New tags: phaseCount, singlePhase, threePhase
• #1007 Updated tags: elec, heatPump, volt
• #1008 New tags: compressor, mech, serviceFactor

Version 3.9.12 (21 Apr 2022)

• #935: Redesign choice to use simple subtypes and tagOn
• #936: Redesign pointFunction, pointSubject, pipeFluid, tankSubstance as choice+of
• #939: Remove equipFunction taxonomy
• #968: New close op for the HTTP API
• #957: Add rated and design tags

Version 3.9.11 (11 Sep 2021)

• New op feature and def for each operation
• Rename formats to filetypes as defs query
• HTTP API specification for noSideEffects
• Span def
• Authentication plaintext scheme
• 776: biomass, coal, diesel, propane
• 776: biomassHeating, coalHeating, propaneHeating
• New Tools chapter to build from source with Haxall

Version 3.9.10 (23 Apr 2021)

• Rename weatherRef to weatherStationRef for consistency
• Annotate equip which typically uses electricity as elec-input
• Rename docSection to docAssociations
• Change protocol to subtype from marker, not entity
• Add nodoc, nosrc, deprecated
• Generate children prototypes as RDF blank nodes
• Update filters chapter for ref list handling
• Exploded point types (attempt only)
• Remove state and stateQuantity in favor of keeping run/enable on their own
• Tweaks to how vfd is used, remove drive tag
• Expand some of the sp/sensor cmd/sensor proto pairs
• Add enthalpy tag, associated weather, duct, and zone points
• Add protos grid files to the distribution
• Add greenhouse gases into ontology from WG 776
• Expand children: ducts, zones
• Port min/max marker tags from Haystack 3
• New alarm point; alarm sensor on motor, chiller, boiler
• New air-velocity quantity
• Rename vavMode to hvacMode, clarify use with dual effective setpoints
• Other new tags: deadband, deviceRef, nh3, no2, o2, o3
• Add heatingOnly as peer to coolingOnly, clarify usage in AHU
• FumeHood children protos
• Add enable cmd as plant level point
• Add cool/heat enable cmd as ahu points
• Revert plantPrimaryLoop/plantSecondaryLoop to primaryLoop/secondaryLoop
• Rework VAVs to not use subtypes (more like AHUs)
• Add ups equipment type
• New Sites chapter
• New Spaces chapter
• New Equips chapter
• New Points chapter
• New Weather chapter
• New Devices chapter
• New Meters chapter
• New AHUs chapter
• New VAVs chapter
• New Plants chapter
• New Zones chapter
• New Motors chapter
• New ElecPanels chapter
• New ATES chapter and tags from WG 734
• New DataCenters chapter

Version 3.9.9 (23 Jul 2020)

• Enhance enum value spec to allow list of dicts
• Add plantTertiaryLoop tag
• Add doas tag for Dedicated Outside Air System
• Change mau to subtype from doas
• Add economizer, ventilation ductSectionTypes
• 808: Rename gasHeating, oilHeating to naturalGasHeating, fuelOilHeating
• 808: New flow relationship tags: airRef, elecRef, chilledWaterRef, etc
• Remove processUses in favor of xxx-input subtyping
• Rename receives/supplies to inputs/outputs
• Rename zoneAirPoints to hvacZonePoints
• 705: Add lightingZonePoints
• 705: Add occupancy sensor for number of occupants
• New Intro chapter
• New Kinds chapter
• New Filetypes chapter
• Add waterCooling as subtype of coolingProcessType

Version 3.9.8 (24 Mar 2020)

• New Changes3to4 chapter
• Port file type docs: Zinc, Json, Trio, Csv
• Port docs: Grid, HttpApi (was Rest), Ops, and Auth
• Zinc and JSON support for symbol literals
• Zinc support for optional commas in nested dict literals
• Trio support for nested lists
• Rename lib includes to depends
• Rework children to be lists of dicts instead of Zinc strings
• Rename filter to filterStr and add filter marker tag
• Add tags: co, diverting, volume
• Add choice airVolumeAdjustability - constantAirVolume, variableAirVolume
• Add choice plantLoop - plantPrimaryLoop, plantSecondaryLoop
• Rename openLoop/closedLoop to condenserOpenLoop/condenserClosedLoop as choice
• Add openEnum marker for geoState
• 609: Add humidifier equip and points
• 609: Add economizing ahu point
• 609: Add dessicantDehumidifier ahu point
• 705: Add active-energy, reactive-energy, apparent-energy
• 741: HttpApi incomplete data
• 749: Add pointGroup, zoneAirPoints as supertype for hvac-zone-space, thermostat
• 778: Add elec-demand

Version 3.9.7 (3 Oct 2019)

• Cleanup relationship defs
• Make containedBy, contains relationships, not associations
• Add accumulate marker for normalization
• Use produces instead of supplies for equip level functionality
• Finish elec-meter points
• Finish actuator points
• Finish ahu points/tags: freezeStat, heatWheel, faceBypass
• Finish vav points: reheat, ductArea, perimeterHeat, vavMode
• Finish boiler points: circ (pipeType)
• Finish plant points: flue (ductType), mixing
• Finish tank points
• Simplify cooling/heating coils taxonomy and add children points

Version 3.9.6 (25 Sep 2019)

• Remove pointKind and use kind to keep it back compatible
• Replace mixinOn concept with tagOn
• Refactor choice to subtype directly from symbol
• Rename aspects to associations
• New Normalization chapter
• New Protos chapter
• New Associations chapter
• Zone setpoint ontology
• Space subtypes appendix
• Point protos appendix
• Add panel, elec-panel, controls-panel
• Stub simple device taxonomy
• Stub simple dataCenter, rack tags
• Apply tagOn to ref tags

Version 3.9.5 (12 Jun 2019)

• Refactor site/weatherStation to be closer to current design
• Remove building tag
• Add phIct library for hardware, software, and networking
• Redesign children using dict prototype instances
• Rework motor/actuator conjuncts for fan, pump, damper, and valve
• Add docs on the doc sections
• Add usage doc section

Version 3.9.4 (3 May 2019)

• New synthesizer design
• Rework mixins to use mixinOn/mixins tags
• Rework fan, damper, pump, valve to be both point and equip
• Add motor/vfd as supertype/mixin for fan/pump
• Add actuator as supertyper of damper/valve
• Rename uv to unitVent and subtype from fcu
• Add movingWalkway
• Add coils and associated subtypes as a type of heatExchanger
• Flush out pointFunction, pointSubject, and pointQuantity

Version 3.9.3 (26 Apr 2019)

• Remove generics
• Remove compose symbols (replaced with tagOn, containedBy)
• Add defx support
• Rename Spaces to Namespaces
• Simplify process taxonomy
• Add ac-elec-meter, dc-elec-meter subtypes
• Add fan, damper, pump, valve
• Rename meterSphere to meterScope
• Flush out submeterOf relationship
• Add ground-floor, roof-floor, subterranean-floor, and floorNum
• Add equipFunction aspects
• Add airTerminalUnit and cav equip types
• Add airHandlingEquip, mau, rtu, fcu, uv, heatPump, fumeHood
• Add radiantEquip, radiator, radiantFloor, chilledBeam
• Add thermostat
• Add quantities: illuminance, luminance, luminous-flux, luminous-intensity
• Add luminaire
• Add verticalTransport, elevator, escalator

Version 3.9.2 (28 Mar 2019)

• Public review of new Haystack 4.0 docs and defs

Version 3.0.2 (16-Jan-2017)

• Elec model enhancments
• Updated tags: apparent, current, pf, phase, power, volt,
• New tags: ac, active, angle, avg, export, dc, imbalance, import, mag, net, reactive, total, thd

Version 3.0.1 (13-Jul-2016)

• Add new Associate members to about
• New tags: circ, diverting, flue, gasHeat, header, level, mixing, oil, tank
• Add file manager to website
• Roll encoding version to "3.0" for Zinc and JSON
• Add Trio chapter
• Renamed chillerPlant to chilledWaterPlant
• Renamed boilerPlant to hotWaterPlant/steamPlant
• Change pump to work as equop or point (like fan)
• New Tanks chapter
• Beef up curStatus enumeration
• 258: JSON new encoding
• 341: heating plants
• 350: new mau tag
• 360: new XStr data type
• 361: nested collection types
• 362: new NA data type
• 383: new HTTP authentication protocol
• 396: remove discharge/entering tag from VAVs
• 418: new weather points

Version 2.0.7 (2-Jun-2015)

• Publish source to BitBucket
• New Builds and ChangeLog chapters
• New Builds section on Downloads page

Version 2.0.6 (14-May-2015)

• Add Zones chapter
• Add Unitary Equip chapter
• Enhanced VAV tags
• Add AHU section on cooling/heating methods
• Remove curDis
• Add links for C++, Dart, and Node.JS projects
• New tags: chilledWaterCool, co, coolOnly, ductArea, dxCool, elecHeat, elecReheat, fanPowered, fcu, heatPump, hotWaterHeat, hotWaterReheat, max, min, occ, parallel, pressureDependent, pressureIndependent, reheat, reheating, series, singleDuct, standby, steamHeat, unocc, uv, vavMode

Version 2.0.5 (13-Aug-2014)

• #193 New meter tag design
• #193 New VFD chapter
• #193 Additional points for chillers
• #50 JSON serialization tweaks
• #146: change tags in formats op
• #181: minVal and maxVal
• French localization provided by Christian Tremblay
• Rework doc engine to use new new fandoc APIs
• File downloads

Version 2.0.4 (13-Jan-2014)

• Fix wetBulb
• Add search redirect to google

Version 2.0.3 (27-Nov-2013)

• Update diagrams to use @ ref syntax
• #30: Experimental device networking model
• #35: Rename condensed to condenser
• #35: Add primaryLoop and secondaryLoop
• #80: ElecPanels
• #85: AHU enhancements
• #119: Add wetBulb, clarify air as dry-blub
• #134: new units PUE, DCIE

Version 2.0.2 (15-Jul-2013)

• Energy Star tags #104
• Fix password reset bug
• Add zh.props

Version 2.0.1 (1-Apr-2013)

• Allow tilde char to Refs
• Add ops: nav, pointWrite, invokeAction
• Beef up rules for ids and ordering of watchSub/watchPoll
• #50 Add Json chapter
• #52 Add Str/enum points
• #64 Add cur, writable, his point tags
• #63 Add hisInterpoalte, hisTotalized
• #66 Add Coord tag value type, replace geoLat/geoLon with geoCoord
• #76 Add geoCounty

Version 2.0.0 (1-Oct-2012)

• New @ Ref syntax
• Add Grid, Filters, Zinc, Csv, Rest, Ops chapters
• New units: kBTU/ft², MBTU/ft², kBTU/h/ft², W/cfm, kW/kcfm, kW/gal/min, knot
• Fix chiller diagram to use "leaving"
• Add meter diagram to Energy chapter
• New path environment design/repo
• #48 VAV entering
• #49 add AHU bypass damper cmd

Version 1.0.4 (2-Dec-2011)

• #7: Rename elecKw/elecKwh to kw and kwh
• #7: New elecMeter points for current, volt, freq, pf, 3-phase
• #25: Rename in/out to sensor/cmd
• #33: Require equipRef on points, optional on equip
• Rework equip point listing for reflection
• Added W/ft² to unit database
• Formalize kind tag, use Number vs Num
• Add equip-point downloads
• Add tag linking in forum posts
• Chiller plants

Version 1.0.3 (7-Sep-2011)

• Rework to use multiple finer grained tags

Version 1.0.2 (14-Jun-2011)

• Add new tag types: bool, uri, date, time, datetime
• #4: added MMBTU and kcfm units
• #9: Added returnCO2, zoneCO2, zoneHumidity, outsideFlowSp
• #9: Added zoneTempHeatSp, zoneTempCoolSp, heatWheel
• #9: Added outsideTemp, outsideTempRef, outsideHumidity, outsideHumidityRef
• #10: Added faceBypass, freezeState, fanDiffPressure
• #10: Updated filterDiffPresssure

Version 1.0.1 (4-Apr-2011)

• Initial version