{"id":30193948,"url":"https://github.com/bacnet-ex/bacnet_ede","last_synced_at":"2025-08-13T02:07:02.144Z","repository":{"id":308407134,"uuid":"1032075213","full_name":"bacnet-ex/bacnet_ede","owner":"bacnet-ex","description":"BACnetEDE is a BACnet EDE File parser and writer.","archived":false,"fork":false,"pushed_at":"2025-08-11T18:07:48.000Z","size":203,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-12T23:59:34.440Z","etag":null,"topics":["bacnet","bacnet-ede","elixir","elixir-lang"],"latest_commit_sha":null,"homepage":"https://bacnet-ex.github.io/bacnet_ede/","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bacnet-ex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-04T19:07:16.000Z","updated_at":"2025-08-11T18:07:08.000Z","dependencies_parsed_at":"2025-08-05T20:21:25.525Z","dependency_job_id":"73f3e29b-7efd-4523-a04f-28fbaea0fa71","html_url":"https://github.com/bacnet-ex/bacnet_ede","commit_stats":null,"previous_names":["bacnet-ex/bacnet_ede"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bacnet-ex/bacnet_ede","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacnet-ex%2Fbacnet_ede","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacnet-ex%2Fbacnet_ede/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacnet-ex%2Fbacnet_ede/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacnet-ex%2Fbacnet_ede/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bacnet-ex","download_url":"https://codeload.github.com/bacnet-ex/bacnet_ede/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacnet-ex%2Fbacnet_ede/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270166108,"owners_count":24538445,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bacnet","bacnet-ede","elixir","elixir-lang"],"created_at":"2025-08-13T02:07:01.097Z","updated_at":"2025-08-13T02:07:02.037Z","avatar_url":"https://github.com/bacnet-ex.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BACnetEDE [![CI Tests](https://github.com/bacnet-ex/bacnet_ede/workflows/Elixir%20CI/badge.svg)](https://github.com/bacnet-ex/bacnet_ede/actions?query=branch%3Amaster) [![Hex.pm](https://img.shields.io/hexpm/v/bacnet_ede.svg)](https://hex.pm/packages/bacnet_ede) [![Documentation](https://img.shields.io/badge/documentation-gray)](https://hexdocs.pm/bacnet_ede)\n\nBACnetEDE is a BACnet EDE File parser and writer. EDE stands for Engineering Data Exchange.\n\nEDE is a data exchange format specified by the BACnet Interest Group Europe - B.I.G.-EU.\nYou can download the official specification on their [website](https://www.big-eu.org/resources/).\n\nThe EDE format is basically an Excel sheet (or CSV) to help exchange engineering data,\nsuch as datapoint types and addresses information in a standardized form.\nIt was never intended for more than just human to human data exchange,\nbecause it only carries minimum information.\nHowever it has grown by convenience to use for machine-to-machine data exchange in CSV form.\n\nThe following naming conventions exist for EDE files (including additional files, such as state texts):\n- Prefix: Name agreed by the involved parties (e.g. the project name)\n- Separator: `_` Underscore\n- Suffix:\n  - `EDE` identifies the main EDE file/table\n  - `ObjTypes` identifies the object type table\n  - `StateTexts` identifies the state texts used in Binary and Multistate objects\n  - `Units` identifies the table of BACnet engineering units\n- Extension: `.csv`\n\nExample of naming convention:\n- Project Name: FlightRadar\n- EDE file: `FlightRadar_EDE.csv`\n- Object types file: `FlightRadar_ObjTypes.csv`\n- State texts file: `FlightRadar_StateTexts.csv`\n- Units file: `FlightRadar_Units.csv`\n\nSee the specification for more information on the specification itself.\nSee the documentation for more information about the library and its modules.\n\n## Installation\n\nThe package can be installed by adding `bacnet_ede` to your list of dependencies in `mix.exs`:\n\n```elixir\ndef deps do\n  [\n    {:bacnet_ede, \"~\u003e 0.1.0\"}\n  ]\nend\n```\n\nThe docs can be found at \u003chttps://hexdocs.pm/bacnet_ede\u003e.\n\n## Usage\n\nThis library can be used to read and write BACnet EDE files.\n\n### Parse EDE\n\nAn EDE file can be simply parsed by using `BACnetEDE.from_file/2` (or any other of `from_*`):\n\n```elixir\n{:ok, ede} = BACnetEDE.from_file(\"path/to/file.csv\")\n```\n\nFor example reading the official EDE sample will look like this:\n\n```elixir\niex(4)\u003e BACnetEDE.from_file(\"./samples/EDE_2_2_example_EDE.csv\")\n{:ok,\n %BACnetEDE.Project{\n   project_name: \"EDEexample\",\n   version: \"1\",\n   timestamp_last_change: ~N[2005-12-19 00:00:00],\n   author_last_change: \"G. Sampler\",\n   layout_version: \"2.2\",\n   objects: %{\n     \"Building03Room15\" =\u003e %BACnetEDE.Project.Object{\n       keyname: \"Building03Room15\",\n       device_instance: 10,\n       object_name: \"ASB03R15\",\n       object_type: 8,\n       object_instance: 10,\n       description: \"Controller10\",\n       default_present_value: nil,\n       min_present_value: nil,\n       max_present_value: nil,\n       settable: false,\n       supports_cov: false,\n       high_limit: nil,\n       low_limit: nil,\n       state_text_ref: nil,\n       unit_code: nil,\n       vendor_specific_address: \"A1.19.02\",\n       notification_class: nil,\n       more_keys: %{}\n     },\n     \"Building03Room15Damper\" =\u003e %BACnetEDE.Project.Object{\n       keyname: \"Building03Room15Damper\",\n       device_instance: 10,\n       object_name: \"Damper\",\n       object_type: 2,\n       object_instance: 1111,\n       description: \"Raw Value Damper\",\n       default_present_value: \"555\",\n       min_present_value: 0.0,\n       max_present_value: 1000.0,\n       settable: false,\n       supports_cov: true,\n       high_limit: nil,\n       low_limit: nil,\n       state_text_ref: nil,\n       unit_code: 95,\n       vendor_specific_address: \"DR12.111.2345\",\n       notification_class: nil,\n       more_keys: %{}\n     },\n     \"Building03Room15DamperPosition\" =\u003e %BACnetEDE.Project.Object{\n       keyname: \"Building03Room15DamperPosition\",\n       device_instance: 10,\n       object_name: \"Damper\",\n       object_type: 1,\n       object_instance: 1234,\n       description: \"Damper in Duct 2\",\n       default_present_value: \"55\",\n       min_present_value: 0.0,\n       max_present_value: 100.0,\n       settable: true,\n       supports_cov: true,\n       high_limit: nil,\n       low_limit: nil,\n       state_text_ref: nil,\n       unit_code: 98,\n       vendor_specific_address: \"D12.111.2345\",\n       notification_class: nil,\n       more_keys: %{}\n     },\n     \"Building03Room15Temperature\" =\u003e %BACnetEDE.Project.Object{\n       keyname: \"Building03Room15Temperature\",\n       device_instance: 10,\n       object_name: \"RoomTemperature\",\n       object_type: 0,\n       object_instance: 4123,\n       description: \"This is a Room Temperature\",\n       default_present_value: \"20\",\n       min_present_value: nil,\n       max_present_value: nil,\n       settable: false,\n       supports_cov: false,\n       high_limit: 24.0,\n       low_limit: 18.0,\n       state_text_ref: nil,\n       unit_code: 62,\n       vendor_specific_address: \"T1.128.15\",\n       notification_class: nil,\n       more_keys: %{}\n     },\n     # ...\n   }\n }}\n ```\n\n### Write EDE\n\nAn EDE file can be created by calling the  `BACnetEDE.to_*` functions with the `BACnetEDE.Project` struct.\nYou have to create such a struct yourself in a valid form, however that shouldn't be too hard.\nCheck the EDE sample example above.\n\nOnce you have such a struct, call `BACnetEDE.to_file/3` (or any other of `to_*`) to create the CSV file:\n\n```elixir\nBACnetEDE.to_file(project_struct, \"path/to/file.csv\")\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacnet-ex%2Fbacnet_ede","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbacnet-ex%2Fbacnet_ede","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacnet-ex%2Fbacnet_ede/lists"}