{ "info": { "author": "mfe", "author_email": "794557226@qq.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5" ], "description": "## ampy\n\nAdafruit MicroPython Tool (ampy) - Utility to interact with a CircuitPython or MicroPython board over a serial connection.\n\nAmpy is meant to be a simple command line tool to manipulate files and run code on a CircuitPython or\nMicroPython board over its serial connection.\nWith ampy you can send files from your computer to the\nboard's file system, download files from a board to your computer, and even send a Python script\nto a board to be executed.\n\nNote that ampy by design is meant to be simple and does not support advanced interaction like a shell\nor terminal to send input to a board. Check out other MicroPython tools\nlike [rshell](https://github.com/dhylands/rshell)\nor [mpfshell](https://github.com/wendlers/mpfshell) for more advanced interaction with boards.\n\n## Installation\n\nYou can use ampy with either Python 2.7.x or 3.x and can install it easily from\nPython's package index. On MacOS or Linux, in a terminal run the following command (assuming\nPython 3):\n\n pip3 install --user adafruit-ampy\n\nOn Windows, do:\n\n pip install adafruit-ampy\n\nNote on some Linux and Mac OSX systems you might need to run as root with sudo:\n\n sudo pip3 install adafruit-ampy\n\nIf you don't have Python 3 then try using Python 2 with:\n\n pip install adafruit-ampy\n\nOnce installed verify you can run the ampy program and get help output:\n\n ampy --help\n\nYou should see usage information displayed like below:\n\n Usage: ampy [OPTIONS] COMMAND [ARGS]...\n\n ampy - Adafruit MicroPython Tool\n\n Ampy is a tool to control MicroPython boards over a serial connection.\n Using ampy you can manipulate files on the board's internal filesystem and\n even run scripts.\n\n Options:\n -p, --port PORT Name of serial port for connected board. [required]\n -b, --baud BAUD Baud rate for the serial connection. (default 115200)\n -d, --delay DELAY Delay in seconds before entering RAW MODE (default 0)\n --help Show this message and exit.\n\n Commands:\n get Retrieve a file from the board.\n ls List contents of a directory on the board.\n put Put a file on the board.\n rm Remove a file from the board.\n run Run a script and print its output.\n\nIf you'd like to install from the Github source then use the standard Python\nsetup.py install (or develop mode):\n\n python3 setup.py install\n\nNote to run the unit tests on Python 2 you must install the mock library:\n\n pip install mock\n\n## Usage\n\nAmpy is made to talk to a CircuitPython MicroPython board over its serial connection. You will\nneed your board connected and any drivers to access it serial port installed.\nThen for example to list the files on the board run a command like:\n\n ampy --port /dev/tty.SLAB_USBtoUART ls\n\nYou should see a list of files on the board's root directory printed to the\nterminal. Note that you'll need to change the port parameter to the name or path\nto the serial port that the MicroPython board is connected to.\n\nOther commands are available, run ampy with --help to see more information:\n\n ampy --help\n\nEach subcommand has its own help, for example to see help for the ls command run (note you\nunfortunately must have a board connected and serial port specified):\n\n ampy --port /dev/tty.SLAB_USBtoUART ls --help\n\n## Configuration\n\nFor convenience you can set an `AMPY_PORT` environment variable which will be used\nif the port parameter is not specified. For example on Linux or OSX:\n\n export AMPY_PORT=/dev/tty.SLAB_USBtoUART\n ampy ls\n\nOr on Windows (untested) try the SET command:\n\n set AMPY_PORT=COM4\n ampy ls\n\nSimilarly, you can set `AMPY_BAUD` and `AMPY_DELAY` to control your baud rate and\nthe delay before entering RAW MODE.\n\nTo set these variables automatically each time you run `ampy`, copy them into a\nfile named `.ampy`:\n\n```sh\n# Example .ampy file\n# Please fill in your own port, baud rate, and delay\nAMPY_PORT=/dev/cu.wchusbserial1410\nAMPY_BAUD=115200\n# Fix for macOS users' \"Could not enter raw repl\"; try 2.0 and lower from there:\nAMPY_DELAY=0.5\n```\n\nYou can put the `.ampy` file in your working directory, one of its parents, or in\nyour home directory.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/BigCircleLaw/ampy", "keywords": "adafruit ampy hardware micropython circuitpython", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "wonderbits-ampy", "package_url": "https://pypi.org/project/wonderbits-ampy/", "platform": "", "project_url": "https://pypi.org/project/wonderbits-ampy/", "project_urls": { "Homepage": "https://github.com/BigCircleLaw/ampy" }, "release_url": "https://pypi.org/project/wonderbits-ampy/1.1.0/", "requires_dist": [ "click", "pyserial", "python-dotenv" ], "requires_python": "", "summary": "ampy (Adafruit MicroPython tool) is a command line tool to interact with a CircuitPython or MicroPython board over a serial connection.", "version": "1.1.0" }, "last_serial": 5994654, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "985a066a61ba7c5fac3b8954f5fcb7d9", "sha256": "a94ba05b8752d8dc1f0ab3ddedf0f0a9046aedbf928e0686e62dab5f3bcfef83" }, "downloads": -1, "filename": "wonderbits_ampy-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "985a066a61ba7c5fac3b8954f5fcb7d9", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 16858, "upload_time": "2019-10-18T09:27:01", "url": "https://files.pythonhosted.org/packages/09/13/697d2c2e5cf1b8992dda3343fe0171a09f16bacf1050b3d01af619614d05/wonderbits_ampy-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "63c0624cdc3bf96e64c257c1abcfa0ab", "sha256": "6e2cfeb7a0e04600617913b69caf4de0155b6b3010db002482d14049eb2452d9" }, "downloads": -1, "filename": "wonderbits-ampy-0.1.0.tar.gz", "has_sig": false, "md5_digest": "63c0624cdc3bf96e64c257c1abcfa0ab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18329, "upload_time": "2019-10-18T09:27:03", "url": "https://files.pythonhosted.org/packages/62/34/bf7e982beb304a24a494684ecaaa5aa3ff94878e64136f401f5cb26737da/wonderbits-ampy-0.1.0.tar.gz" } ], "1.0.9": [ { "comment_text": "", "digests": { "md5": "cb50bbe939209ff11b81b5ca1ef1a73f", "sha256": "c1d8b7ed7a3e9c292d77bc056792aa60ad5b67e5542ad3111d6589b5ffa9b03f" }, "downloads": -1, "filename": "wonderbits_ampy-1.0.9-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "cb50bbe939209ff11b81b5ca1ef1a73f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 16763, "upload_time": "2019-10-18T05:29:59", "url": "https://files.pythonhosted.org/packages/e3/02/a81a1500a36ef3c737cfa3eea8e2cd3858e6a278a58bb7e5d130c4d63495/wonderbits_ampy-1.0.9-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "01cdb8b95eafd0ec9c43d9ec8e787147", "sha256": "686b9bc779209d20937d39981c0e6913c88a68ab8c556341b06ba7b10f68631b" }, "downloads": -1, "filename": "wonderbits-ampy-1.0.9.tar.gz", "has_sig": false, "md5_digest": "01cdb8b95eafd0ec9c43d9ec8e787147", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18224, "upload_time": "2019-10-18T05:30:01", "url": "https://files.pythonhosted.org/packages/43/c8/c324a81edb6ff7ba04dd55aac32311b5e10a2c22fc71e8c5d00cd6449053/wonderbits-ampy-1.0.9.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "9539b19f47bc7c0004c5bbdc184887ad", "sha256": "403bf22c1aa381ffe7d2fcf5282d39ba41ec45f11446345f5e02a7d5d98a599a" }, "downloads": -1, "filename": "wonderbits_ampy-1.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9539b19f47bc7c0004c5bbdc184887ad", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 16861, "upload_time": "2019-10-18T09:31:55", "url": "https://files.pythonhosted.org/packages/a5/07/6c48929284b139bda112b4cd24e11d8699a32af6aa4b6c3d46d372ba7f7b/wonderbits_ampy-1.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffb880b5cf47e3a5ed45ed2601acc1ae", "sha256": "c483992c28d5cf6034b12c2f51e1ee072f9e90512a9825793c2c62e8b5b125c7" }, "downloads": -1, "filename": "wonderbits-ampy-1.1.0.tar.gz", "has_sig": false, "md5_digest": "ffb880b5cf47e3a5ed45ed2601acc1ae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18335, "upload_time": "2019-10-18T09:31:56", "url": "https://files.pythonhosted.org/packages/06/7f/c598920eaf57e0a56423c92babdadc4b5f22a59eec7c554c239ce06f8053/wonderbits-ampy-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9539b19f47bc7c0004c5bbdc184887ad", "sha256": "403bf22c1aa381ffe7d2fcf5282d39ba41ec45f11446345f5e02a7d5d98a599a" }, "downloads": -1, "filename": "wonderbits_ampy-1.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9539b19f47bc7c0004c5bbdc184887ad", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 16861, "upload_time": "2019-10-18T09:31:55", "url": "https://files.pythonhosted.org/packages/a5/07/6c48929284b139bda112b4cd24e11d8699a32af6aa4b6c3d46d372ba7f7b/wonderbits_ampy-1.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffb880b5cf47e3a5ed45ed2601acc1ae", "sha256": "c483992c28d5cf6034b12c2f51e1ee072f9e90512a9825793c2c62e8b5b125c7" }, "downloads": -1, "filename": "wonderbits-ampy-1.1.0.tar.gz", "has_sig": false, "md5_digest": "ffb880b5cf47e3a5ed45ed2601acc1ae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18335, "upload_time": "2019-10-18T09:31:56", "url": "https://files.pythonhosted.org/packages/06/7f/c598920eaf57e0a56423c92babdadc4b5f22a59eec7c554c239ce06f8053/wonderbits-ampy-1.1.0.tar.gz" } ] }