{"id":20777803,"url":"https://github.com/fiware/iotagent-isoxml","last_synced_at":"2025-04-30T18:30:06.971Z","repository":{"id":45308119,"uuid":"274411903","full_name":"FIWARE/iotagent-isoxml","owner":"FIWARE","description":":tractor:.  IoT Agent for the ISOXML/ADAPT protocol for agricultural machinery (over an HTTP transport)","archived":false,"fork":false,"pushed_at":"2024-12-04T08:37:11.000Z","size":383,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-30T18:51:11.462Z","etag":null,"topics":["adapt","fiware","fiware-iot-agents","iot","iot-agent","iso11783","isoxml"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FIWARE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-23T13:23:33.000Z","updated_at":"2025-01-22T07:08:21.000Z","dependencies_parsed_at":"2023-02-01T03:00:48.015Z","dependency_job_id":"55fcb233-794d-4503-933c-1040b9b98e09","html_url":"https://github.com/FIWARE/iotagent-isoxml","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fiotagent-isoxml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fiotagent-isoxml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fiotagent-isoxml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fiotagent-isoxml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FIWARE","download_url":"https://codeload.github.com/FIWARE/iotagent-isoxml/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251760509,"owners_count":21639419,"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","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":["adapt","fiware","fiware-iot-agents","iot","iot-agent","iso11783","isoxml"],"created_at":"2024-11-17T13:17:19.157Z","updated_at":"2025-04-30T18:30:06.948Z","avatar_url":"https://github.com/FIWARE.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IoT Agent for the ISOXML/ADAPT protocol\n\n[![FIWARE IoT Agents](https://nexus.lab.fiware.org/static/badges/chapters/iot-agents.svg)](https://www.fiware.org/developers/catalogue/)\n[![License: APGL](https://img.shields.io/github/license/FIWARE/iotagent-isoxml.svg)](https://opensource.org/licenses/AGPL-3.0)\n[![Docker badge](https://img.shields.io/badge/quay.io-fiware%2Fiotagent--xml-grey?logo=red%20hat\u0026labelColor=EE0000)](https://quay.io/repository/fiware/iotagent-isoxml)\n[![Support badge](https://img.shields.io/badge/tag-fiware+iot-orange.svg?logo=stackoverflow)](https://stackoverflow.com/questions/tagged/fiware+iot)\n\u003cbr/\u003e\n[![Documentation badge](https://img.shields.io/readthedocs/fiware-iotagent-isoxml.svg)](https://fiware-iotagent-isoxml.readthedocs.io/en/latest/?badge=latest)\n![CI](https://github.com/FIWARE/iotagent-isoxml/workflows/CI/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/FIWARE/iotagent-isoxml/badge.svg?branch=master)](https://coveralls.io/github/FIWARE/iotagent-isoxml?branch=master)\n![Status](https://nexus.lab.fiware.org/repository/raw/public/badges/statuses/incubating.svg)\n\nAn Internet of Things Agent for the ISO 11783 protocol (with [HTTP](https://www.w3.org/Protocols/)). This IoT Agent is\ndesigned to be a bridge between ISOXML/ADAPT and the\n[NGSI](https://swagger.lab.fiware.org/?url=https://raw.githubusercontent.com/FIWARE/specifications/master/OpenAPI/ngsiv2/ngsiv2-openapi.json)\ninterface of a context broker.\n\nIt is based on the [IoT Agent Node.js Library](https://github.com/telefonicaid/iotagent-node-lib). Further general\ninformation about the FIWARE IoT Agents framework, its architecture and the common interaction model can be found in the\nlibrary's GitHub repository.\n\nThis project is part of [FIWARE](https://www.fiware.org/). For more information check the FIWARE Catalogue entry for the\n[IoT Agents](https://github.com/Fiware/catalogue/tree/master/iot-agents).\n\n| :books: [Documentation](https://fiware-iotagent-isoxml.readthedocs.io) | \u003cimg style=\"height:1em\" src=\"https://quay.io/static/img/quay_favicon.png\"/\u003e [quay.io](https://quay.io/repository/fiware/iotagent-isoxml) | :dart: [Roadmap](https://github.com/FIWARE/iotagent-isoxml/blob/master/docs/roadmap.md) |\n| ---------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n\n## Contents\n\n-   [Background](#background)\n-   [Install](#install)\n-   [Usage](#usage)\n-   [API](#api)\n-   [Testing](#testing)\n-   [License](#license)\n\n## Background\n\n[ISO 11783](https://www.iso.org/obp/ui/#iso:std:iso:11783:-10:ed-2:v1:en) is a standard for electronics communications\nprotocol for agricultural equipment. This _Internet of Things Agent_ is a bridge that can be used to communicate devices\nusing the ISO 11783 protocol and NGSI Context Brokers (like [Orion](https://github.com/telefonicaid/fiware-orion)). ISO\n11783 is an XML file based protocol used to pass message data. This IoT Agent does not deal with ISO 11783\ncommunications directly, it is assumed that a separate MICS (Mobile Implement control system) server is present which in\nturn sends files down to devices and receives uploaded files to be processed.\n\nAs is the case in any IoT Agent, this one follows the interaction model defined in the\n[Node.js IoT Agent Library](https://github.com/telefonicaid/iotagent-node-lib), that is used for the implementation of\nthe APIs found on the IoT Agent's North Port. Information about the architecture of the IoT Agent can be found on that\nglobal repository. This documentation will only address those features and characteristics that are particular to ISO\n11783\n\nAdditional information about operating the component can be found in the\n[Operations: logs and alarms](docs/operations.md) document.\n\n## Install\n\nInformation about how to install the IoT Agent for ISOXML/ADAPT can be found at the corresponding section of the\n[Installation \u0026 Administration Guide](docs/installationguide.md).\n\nA `Dockerfile` is also available for your use - further information can be found [here](docker/README.md)\n\n## Usage\n\nInformation about how to use the IoT Agent can be found in the [User \u0026 Programmers Manual](docs/usermanual.md).\n\n## API\n\nApiary reference for the Configuration API can be found\n[here](https://telefonicaiotiotagents.docs.apiary.io/#reference/configuration-api). More information about IoT Agents\nand their APIs can be found in the IoT Agent Library [documentation](https://iotagent-node-lib.readthedocs.io/).\n\nThe latest IoT Agent for ISOXML/ADAPT documentation is also available on\n[ReadtheDocs](https://fiware-iotagent-isoxml.readthedocs.io/en/latest/)\n\n## Testing\n\n[Mocha](https://mochajs.org/) Test Runner + [Should.js](https://shouldjs.github.io/) Assertion Library.\n\nTo run tests, type\n\n```console\nnpm test\n```\n\n---\n\n## License\n\nThe IoT Agent for ISOXML/ADAPT is licensed under [Affero General Public License (GPL) version 3](./LICENSE).\n\n© 2020-2023 FIWARE Foundation e.V.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAre there any legal issues with AGPL 3.0? Is it safe for me to use?\u003c/strong\u003e\u003c/summary\u003e\nThere is absolutely no problem in using a product licensed under AGPL 3.0. Issues with GPL (or AGPL) licenses are mostly\nrelated with the fact that different people assign different interpretations on the meaning of the term “derivate work”\nused in these licenses. Due to this, some people believe that there is a risk in just _using_ software under GPL or AGPL\nlicenses (even without _modifying_ it).\n\nFor the avoidance of doubt, the owners of this software licensed under an AGPL-3.0 license wish to make a clarifying\npublic statement as follows:\n\n\u003e Please note that software derived as a result of modifying the source code of this software in order to fix a bug or\n\u003e incorporate enhancements is considered a derivative work of the product. Software that merely uses or aggregates (i.e.\n\u003e links to) an otherwise unmodified version of existing software is not considered a derivative work, and therefore it\n\u003e does not need to be released as under the same license, or even released as open source.\n\n\u003c/summary\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Fiotagent-isoxml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiware%2Fiotagent-isoxml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Fiotagent-isoxml/lists"}