ev3dev2simulator


Nameev3dev2simulator JSON
Version 2.0.10 PyPI version JSON
download
home_pageNone
SummaryEV3 simulator for the ev3dev2 library
upload_time2024-05-19 15:31:16
maintainerNone
docs_urlNone
authorSam Jansen, Niels Okker
requires_pythonNone
licenseThe MIT License (MIT) Copyright (c) 2020 Harco Kuppens Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords ide education programming ev3 mindstorms lego
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ev3dev2simulator: simulator for the EV3 (ev3dev2 API)

The behaviour of the EV3 robot is simulated in the simulator. This is convenient to quickly test programs when you momentarily don’t have access to an EV3.

![ev3dev2simulator](https://raw.githubusercontent.com/wiki/ev3dev-python-tools/ev3dev2simulator/img/small.PNG "ev3dev2simulator")

You can use the 'ev3dev2' python library to program the EV3. The simulator installs a fake 'ev3dev2' library on the PC. When using this library on the PC, every call to this API is forwarded to the simulator which uses it to simulate the behaviour of the EV3 robot. 

For an example see: https://github.com/ev3dev-python-tools/thonny-ev3dev/wiki/Simulator-example<br>
The running program can be seen in the following video: http://www.cs.ru.nl/lab/ev3dev2simulator.html .

The thonny-ev3dev plugin makes it easier to program the EV3 programmable LEGO brick 
using the [Thonny Python IDE for beginners](http://thonny.org/). 
The thonny-ev3dev plugin for the Thonny IDE comes with the ev3dev2simulator.

For more info about the thonny-ev3dev plugin see: https://github.com/ev3dev-python-tools/thonny-ev3dev/wiki <br>
For more info about Thonny: http://thonny.org

## Getting started
   
### Prerequisites needed only for Linux

   
For Macos and Windows you don't need any prerequisites,
but for linux you do.

The pyttsx3  python speech library  uses system libraries in its implementation. For Macos/Windows the used system 'speak' libraries are always available, but for linux you must sure these are installed with:

     sudo apt update && sudo apt install espeak ffmpeg libespeak1

For linux there are is no binary distribution available for simpleaudio.
          The Python 3 and ALSA development packages are required for pip to build the extension.
          For Debian variants (including Raspbian), this will usually get the job done:

     sudo apt-get install -y python3-dev libasound2-dev


### Installation

Install with pip:
   
      pip install ev3dev2simulator
     
For Windows and Macos all binary dependencies are provided by wheels on pypi, however for Linux the binary extenssion for simpleaudio is compiled when installing.
     
Then you can just run the simulator by running the executable:
   
      ev3dev2simulator

The simulator works on all python versions 3.8 till python 3.12.

   

## Using the simulator

The user guide of the simulator can be found on the [wiki](https://github.com/ev3dev-python-tools/ev3dev2simulator/wiki).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "ev3dev2simulator",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "IDE, education, programming, EV3, mindstorms, lego",
    "author": "Sam Jansen, Niels Okker",
    "author_email": "Harco Kuppens <h.kuppens@cs.ru.nl>",
    "download_url": "https://files.pythonhosted.org/packages/0c/fa/f183597923d0c6963eb69eacb66d8de893e8c83952022c3a09025dcd034e/ev3dev2simulator-2.0.10.tar.gz",
    "platform": null,
    "description": "# ev3dev2simulator: simulator for the EV3 (ev3dev2 API)\n\nThe behaviour of the EV3 robot is simulated in the simulator. This is convenient to quickly test programs when you momentarily don\u2019t have access to an EV3.\n\n![ev3dev2simulator](https://raw.githubusercontent.com/wiki/ev3dev-python-tools/ev3dev2simulator/img/small.PNG \"ev3dev2simulator\")\n\nYou can use the 'ev3dev2' python library to program the EV3. The simulator installs a fake 'ev3dev2' library on the PC. When using this library on the PC, every call to this API is forwarded to the simulator which uses it to simulate the behaviour of the EV3 robot. \n\nFor an example see: https://github.com/ev3dev-python-tools/thonny-ev3dev/wiki/Simulator-example<br>\nThe running program can be seen in the following video: http://www.cs.ru.nl/lab/ev3dev2simulator.html .\n\nThe thonny-ev3dev plugin makes it easier to program the EV3 programmable LEGO brick \nusing the [Thonny Python IDE for beginners](http://thonny.org/). \nThe thonny-ev3dev plugin for the Thonny IDE comes with the ev3dev2simulator.\n\nFor more info about the thonny-ev3dev plugin see: https://github.com/ev3dev-python-tools/thonny-ev3dev/wiki <br>\nFor more info about Thonny: http://thonny.org\n\n## Getting started\n   \n### Prerequisites needed only for Linux\n\n   \nFor Macos and Windows you don't need any prerequisites,\nbut for linux you do.\n\nThe pyttsx3  python speech library  uses system libraries in its implementation. For Macos/Windows the used system 'speak' libraries are always available, but for linux you must sure these are installed with:\n\n     sudo apt update && sudo apt install espeak ffmpeg libespeak1\n\nFor linux there are is no binary distribution available for simpleaudio.\n          The Python 3 and ALSA development packages are required for pip to build the extension.\n          For Debian variants (including Raspbian), this will usually get the job done:\n\n     sudo apt-get install -y python3-dev libasound2-dev\n\n\n### Installation\n\nInstall with pip:\n   \n      pip install ev3dev2simulator\n     \nFor Windows and Macos all binary dependencies are provided by wheels on pypi, however for Linux the binary extenssion for simpleaudio is compiled when installing.\n     \nThen you can just run the simulator by running the executable:\n   \n      ev3dev2simulator\n\nThe simulator works on all python versions 3.8 till python 3.12.\n\n   \n\n## Using the simulator\n\nThe user guide of the simulator can be found on the [wiki](https://github.com/ev3dev-python-tools/ev3dev2simulator/wiki).\n",
    "bugtrack_url": null,
    "license": "The MIT License (MIT)  Copyright (c) 2020 Harco Kuppens  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "EV3 simulator for the ev3dev2 library",
    "version": "2.0.10",
    "project_urls": {
        "Homepage": "https://github.com/ev3dev-python-tools/ev3dev2simulator"
    },
    "split_keywords": [
        "ide",
        " education",
        " programming",
        " ev3",
        " mindstorms",
        " lego"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "19fdfee1d84fbcc6a98219453ad60ceacca909cb05c74fdb3ab5274c64d61290",
                "md5": "c8098a0c108b99a2d573151b0863d51c",
                "sha256": "73a62375d4497a448d03fc40fd0046cc03b973dd3875b15a3b14ea4c571872c0"
            },
            "downloads": -1,
            "filename": "ev3dev2simulator-2.0.10-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c8098a0c108b99a2d573151b0863d51c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 356356,
            "upload_time": "2024-05-19T15:31:14",
            "upload_time_iso_8601": "2024-05-19T15:31:14.548643Z",
            "url": "https://files.pythonhosted.org/packages/19/fd/fee1d84fbcc6a98219453ad60ceacca909cb05c74fdb3ab5274c64d61290/ev3dev2simulator-2.0.10-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0cfaf183597923d0c6963eb69eacb66d8de893e8c83952022c3a09025dcd034e",
                "md5": "3e404a3349b734a53d9c97d19249567b",
                "sha256": "900826e209468a4f1b7836cfc2a48faef924ac1dc2df3b064e546ed0d89ffe97"
            },
            "downloads": -1,
            "filename": "ev3dev2simulator-2.0.10.tar.gz",
            "has_sig": false,
            "md5_digest": "3e404a3349b734a53d9c97d19249567b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 309799,
            "upload_time": "2024-05-19T15:31:16",
            "upload_time_iso_8601": "2024-05-19T15:31:16.371572Z",
            "url": "https://files.pythonhosted.org/packages/0c/fa/f183597923d0c6963eb69eacb66d8de893e8c83952022c3a09025dcd034e/ev3dev2simulator-2.0.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-19 15:31:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ev3dev-python-tools",
    "github_project": "ev3dev2simulator",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "ev3dev2simulator"
}
        
Elapsed time: 0.30167s