{ "info": { "author": "Adafruit Industries", "author_email": "circuitpython@adafruit.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries", "Topic :: System :: Hardware" ], "description": "Introduction\n============\n\n.. image:: https://readthedocs.org/projects/adafruit-circuitpython-charlcd/badge/?version=latest\n :target: https://circuitpython.readthedocs.io/projects/charlcd/en/latest/\n :alt: Documentation Status\n\n.. image :: https://img.shields.io/discord/327254708534116352.svg\n :target: https://discord.gg/nBQh6qu\n :alt: Discord\n\n.. image:: https://travis-ci.com/adafruit/Adafruit_CircuitPython_CharLCD.svg?branch=master\n :target: https://travis-ci.com/adafruit/Adafruit_CircuitPython_CharLCD\n :alt: Build Status\n\nThis library is compatible with standard Character LCDs such as:\n* `Adafruit Standard LCD 16x2 `_\n* `Adafruit RGB backlight negative LCD 16x2 `_\n* `Adafruit RGB backlight negative LCD 20x4 `_\n\nInstalling from PyPI\n--------------------\n\nOn supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from\nPyPI `_. To install for current user:\n\n.. code-block:: shell\n\n pip3 install adafruit-circuitpython-charlcd\n\nTo install system-wide (this may be required in some cases):\n\n.. code-block:: shell\n\n sudo pip3 install adafruit-circuitpython-charlcd\n\nTo install in a virtual environment in your current project:\n\n.. code-block:: shell\n\n mkdir project-name && cd project-name\n python3 -m venv .env\n source .env/bin/activate\n pip3 install adafruit-circuitpython-charlcd\n\nDependencies\n=============\nThis driver depends on:\n\n* `Adafruit CircuitPython `_\n* `Adafruit CircuitPython BusDevice `_\n* `Adafruit CircuitPython MCP230xx `_\n* `Adafruit CircuitPython 74HC595 `_\n\nI2C & SPI displays also depend on:\n\n* `Bus Device `_\n\nPlease ensure all dependencies are available on the CircuitPython filesystem.\nThis is easily achieved by downloading\n`the Adafruit library and driver bundle `_.\n\nUsage Example\n=============\n\nThe ``Character_LCD`` class interfaces a predefined Character LCD display with CircuitPython.\n\n.. code-block:: python\n\n import board\n import digitalio\n import adafruit_character_lcd.character_lcd as character_lcd\n\nYou must define the data pins (``RS``, ``EN``, ``D4``, ``D5``, ``D6``, ``D7``) in your code before using the ``Character_LCD`` class.\nIf you want to have on/off ``backlight`` functionality, you can also define your backlight as ``lcd_backlight``. Otherwise, the backlight\nwill always remain on. The following is an example setup.\n\n.. code-block:: python\n\n lcd_rs = digitalio.DigitalInOut(board.D7)\n lcd_en = digitalio.DigitalInOut(board.D8)\n lcd_d7 = digitalio.DigitalInOut(board.D12)\n lcd_d6 = digitalio.DigitalInOut(board.D11)\n lcd_d5 = digitalio.DigitalInOut(board.D10)\n lcd_d4 = digitalio.DigitalInOut(board.D9)\n lcd_backlight = digitalio.DigitalInOut(board.D13)\n\nYou must also define the size of the CharLCD by specifying its ``lcd_columns`` and ``lcd_rows``:\n\n.. code-block:: python\n\n lcd_columns = 16\n lcd_rows = 2\n\nAfter you have set up your LCD, we can make the device by calling it\n\n.. code-block:: python\n\n lcd = character_lcd.Character_LCD_Mono(lcd_rs, lcd_en, lcd_d4, lcd_d5, lcd_d6, lcd_d7, lcd_columns, lcd_rows, lcd_backlight)\n\n\nTo verify that your pins are correct, print a hello message to the CharLCD:\n\n.. code-block:: python\n\n lcd.message = \"Hello\\nCircuitPython\"\n\n\nCustom character example with ``create_char()`` is provided within /examples/\n\n\nContributing\n============\n\nContributions are welcome! Please read our `Code of Conduct\n`_ before contributing to help this project stay welcoming.\n\n\nBuilding locally\n================\n\nTo build this library locally you'll need to install the\n`circuitpython-build-tools `_ package.\n\n.. code-block:: shell\n\n python3 -m venv .env\n source .env/bin/activate\n pip install circuitpython-build-tools\n\nOnce installed, make sure you are in the virtual environment:\n\n.. code-block:: shell\n\n source .env/bin/activate\n\nThen run the build:\n\n.. code-block:: shell\n\n circuitpython-build-bundles --filename_prefix adafruit-circuitpython-charlcd --library_location .\n\nSphinx documentation\n-----------------------\n\nSphinx is used to build the documentation based on rST files and comments in the code. First,\ninstall dependencies (feel free to reuse the virtual environment from above):\n\n.. code-block:: shell\n\n python3 -m venv .env\n source .env/bin/activate\n pip install Sphinx sphinx-rtd-theme\n\nNow, once you have the virtual environment activated:\n\n.. code-block:: shell\n\n cd docs\n sphinx-build -E -W -b html . _build/html\n\nThis will output the documentation to ``docs/_build/html``. Open the index.html in your browser to\nview them. It will also (due to -W) error out on any warning like Travis will. This is a good way to\nlocally verify it will pass.", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/adafruit/Adafruit_CircuitPython_CharLCD", "keywords": "adafruit character lcd rgb 16x2 20x4 hardware micropython circuitpython", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "adafruit-circuitpython-charlcd", "package_url": "https://pypi.org/project/adafruit-circuitpython-charlcd/", "platform": "", "project_url": "https://pypi.org/project/adafruit-circuitpython-charlcd/", "project_urls": { "Homepage": "https://github.com/adafruit/Adafruit_CircuitPython_CharLCD" }, "release_url": "https://pypi.org/project/adafruit-circuitpython-charlcd/3.2.1/", "requires_dist": null, "requires_python": "", "summary": "CircuitPython library for standard character LCDs.", "version": "3.2.1" }, "last_serial": 5344420, "releases": { "2.3.2": [ { "comment_text": "", "digests": { "md5": "ec7dfbab0d5fc40f5039f8fe1f579b80", "sha256": "6ab0681b642dbe8224f5f416e933311f5b2cc0d232343057484623392f01c641" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-2.3.2.tar.gz", "has_sig": false, "md5_digest": "ec7dfbab0d5fc40f5039f8fe1f579b80", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29566, "upload_time": "2018-08-03T17:42:59", "url": "https://files.pythonhosted.org/packages/df/9b/261003a4bb8e598c8af699d7365d6abed0703e7dd9769875f408ca667cc8/adafruit-circuitpython-charlcd-2.3.2.tar.gz" } ], "2.4.0": [ { "comment_text": "", "digests": { "md5": "93cb4b8937c41faf18761966851f7214", "sha256": "22ea1f0d0c6278fcb219fc66b0f5fb215d031605fcba1a9dac090f07ef9ad131" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-2.4.0.tar.gz", "has_sig": false, "md5_digest": "93cb4b8937c41faf18761966851f7214", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30110, "upload_time": "2018-10-26T19:11:01", "url": "https://files.pythonhosted.org/packages/de/a8/19a64f3e6fc8b4d93dbcd909f0c3bfb48d42fa7ca0590100d432ea0f5203/adafruit-circuitpython-charlcd-2.4.0.tar.gz" } ], "2.4.1": [ { "comment_text": "", "digests": { "md5": "a091420fc8bb0e2976859fcdde8b9ce1", "sha256": "179a8df58656de25dd742db3eb8cc7e6a2b558ad338eb2b83d2f73c1aee5e2e1" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-2.4.1.tar.gz", "has_sig": false, "md5_digest": "a091420fc8bb0e2976859fcdde8b9ce1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30105, "upload_time": "2018-11-12T20:31:02", "url": "https://files.pythonhosted.org/packages/f8/7c/bea0121e62ca60472d26c43c30e0150afdbb8eae9c0de821c38dcdbcedc3/adafruit-circuitpython-charlcd-2.4.1.tar.gz" } ], "3.0.0": [ { "comment_text": "", "digests": { "md5": "08e70aba6e4ba7151f969d0f42292401", "sha256": "273e4ae205b1ad0f305a6ea73c5d82d5172c9d6198189b64ba6d36a0de310064" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.0.0.tar.gz", "has_sig": false, "md5_digest": "08e70aba6e4ba7151f969d0f42292401", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28465, "upload_time": "2018-11-21T18:09:40", "url": "https://files.pythonhosted.org/packages/fe/f9/2861a41c88c998d3f943578c19ea2a84fb793959647498252953d7a87647/adafruit-circuitpython-charlcd-3.0.0.tar.gz" } ], "3.0.1": [ { "comment_text": "", "digests": { "md5": "454b35d1b5eb1657e7253897cdf55e60", "sha256": "a8903f21e2400c0cb58d871db38391a68555a377af4501b1355b50a87b933392" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.0.1.tar.gz", "has_sig": false, "md5_digest": "454b35d1b5eb1657e7253897cdf55e60", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28489, "upload_time": "2018-11-21T20:31:23", "url": "https://files.pythonhosted.org/packages/15/5f/4cf89f73654e48e16103bc74877ba196fe6600d21b84110f4ffc85bda3d4/adafruit-circuitpython-charlcd-3.0.1.tar.gz" } ], "3.0.2": [ { "comment_text": "", "digests": { "md5": "441e0232f6e257011add74eb7dbc35a2", "sha256": "b30abb50323b2d3c8523fceef550ae2386df31f5a3ac93ef2685753d0a949c91" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.0.2.tar.gz", "has_sig": false, "md5_digest": "441e0232f6e257011add74eb7dbc35a2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28519, "upload_time": "2018-11-28T18:14:45", "url": "https://files.pythonhosted.org/packages/e0/75/bb26554f78960581211656f649e28e24e215e2be951864c396af6718696f/adafruit-circuitpython-charlcd-3.0.2.tar.gz" } ], "3.0.3": [ { "comment_text": "", "digests": { "md5": "9e60993236128774f6c554469f0e12e3", "sha256": "db24657f8fd8491624fefe940d2f07e6508209d0fb7bca0fbf3b76677e5e2d3b" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.0.3.tar.gz", "has_sig": false, "md5_digest": "9e60993236128774f6c554469f0e12e3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28902, "upload_time": "2018-12-03T22:05:24", "url": "https://files.pythonhosted.org/packages/03/a7/f105f374bce649b76a0cf55a08e171453d0512f3eaf7b34da1d14d11a432/adafruit-circuitpython-charlcd-3.0.3.tar.gz" } ], "3.1.0": [ { "comment_text": "", "digests": { "md5": "9475d3cee53f04229f1e929d07d70e60", "sha256": "5cce3c129aa50c64f30b7857abf3d21b88af6c7561d5b9470208662cc820b5e2" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.1.0.tar.gz", "has_sig": false, "md5_digest": "9475d3cee53f04229f1e929d07d70e60", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29376, "upload_time": "2019-01-15T00:36:49", "url": "https://files.pythonhosted.org/packages/f0/20/a06c1bb05041710f0e9a3b58ee668817f4d9a7375d0f4dfda48a1a5fc798/adafruit-circuitpython-charlcd-3.1.0.tar.gz" } ], "3.1.1": [ { "comment_text": "", "digests": { "md5": "00d2dfab39cee409ac12b3fea122f914", "sha256": "aff2b0435f0afb755127f94479c1195d19ef17f687b36298973839e9a9880d9f" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.1.1.tar.gz", "has_sig": false, "md5_digest": "00d2dfab39cee409ac12b3fea122f914", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29368, "upload_time": "2019-02-02T18:45:07", "url": "https://files.pythonhosted.org/packages/05/ce/e6ce7b68b713e1426425bb28cf3feca2ef16fe6318a1e2a7d7ba46801740/adafruit-circuitpython-charlcd-3.1.1.tar.gz" } ], "3.1.2": [ { "comment_text": "", "digests": { "md5": "73609a0e817a2376cf846d7129801392", "sha256": "4931417460b7f01ed3b4e60f660037aa88b5bc36a798f5637b0f557a1c6e5557" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.1.2.tar.gz", "has_sig": false, "md5_digest": "73609a0e817a2376cf846d7129801392", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29379, "upload_time": "2019-02-08T23:35:41", "url": "https://files.pythonhosted.org/packages/5a/7a/208500a6c94bb050c8dfc061b1fa6aa14ab0e9ecab7cae4af04df5bb600f/adafruit-circuitpython-charlcd-3.1.2.tar.gz" } ], "3.2.0": [ { "comment_text": "", "digests": { "md5": "5851e2feec415499e1a938b49a499024", "sha256": "9907408dbced0550e9c0940c96b80b4d332f2e2755c19c4136380b78d1f1b070" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.2.0.tar.gz", "has_sig": false, "md5_digest": "5851e2feec415499e1a938b49a499024", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29539, "upload_time": "2019-04-12T03:37:07", "url": "https://files.pythonhosted.org/packages/31/65/e04d90e0110ce149bd87483964679e326660c6e065b3dce9694fb8539380/adafruit-circuitpython-charlcd-3.2.0.tar.gz" } ], "3.2.1": [ { "comment_text": "", "digests": { "md5": "1b096fc0c7712de84e5a17a1efa1a0ab", "sha256": "754ab44887e305912c5133d98ea9f6b45c26079b5fee01f02c8dfc1120c4c8a4" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.2.1.tar.gz", "has_sig": false, "md5_digest": "1b096fc0c7712de84e5a17a1efa1a0ab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29613, "upload_time": "2019-05-31T20:30:03", "url": "https://files.pythonhosted.org/packages/7f/e8/42a5be62a7bde00a48c36966198b65c28a7f4b84e7eb2283a89d2ae20fd0/adafruit-circuitpython-charlcd-3.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1b096fc0c7712de84e5a17a1efa1a0ab", "sha256": "754ab44887e305912c5133d98ea9f6b45c26079b5fee01f02c8dfc1120c4c8a4" }, "downloads": -1, "filename": "adafruit-circuitpython-charlcd-3.2.1.tar.gz", "has_sig": false, "md5_digest": "1b096fc0c7712de84e5a17a1efa1a0ab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29613, "upload_time": "2019-05-31T20:30:03", "url": "https://files.pythonhosted.org/packages/7f/e8/42a5be62a7bde00a48c36966198b65c28a7f4b84e7eb2283a89d2ae20fd0/adafruit-circuitpython-charlcd-3.2.1.tar.gz" } ] }