This package provides a Python module to control the GPIO on a VisionFive SBC.
Support basic GPIO function including I/O, edge detection, PWM, I2C, SPI. Although hardware PWM is not available yet, software PWM is available to use on all channels.
Installation
--------------
Pypi does not support uploading binaries of RISC-V architectures, there are two ways to install VisionFive.gpio:
pip:
a. First, access the following website to check the latest version number of VisionFive.gpio: <https://pypi.org/project/VisionFive.gpio/#history>
b. Replace "1.x.x" in the following URL with the latest version number obtained from the above step: <https://pypi.org/project/VisionFive.gpio/1.x.x/#files>
c. Visit the modified URL, for example: <https://pypi.org/project/VisionFive.gpio/1.2.12/#files>
d. Hover over the file with the ".whl" extension (e.g., VisionFive.gpio-1.2.12-cp34-abi3-any.whl) and right-click to copy the link address.
e. Download the .whl installation package using the wget command:
$ wget download_address_of_whl_package
f. Rename the .whl package by replacing "any" with "linux_riscv64":
$ mv VisionFive.gpio-1.2.12-cp34-abi3-any.whl VisionFive.gpio-1.2.12-cp34-abi3-linux_riscv64.whl
g. Finally, install the .whl package using the following command:
$ pip install VisionFive.gpio-1.2.12-cp34-abi3-any.whl
script:
You can use the method provided in the following URL to install the script: <https://doc-en.rvspace.org/VisionFive2/AN_Edge_Detection/VisionFive2_ApplicationNotes/Shared_preparing_software%20-%20vf2.html>
Usage
-------
Same as RPi.GPIO, help and usage of APIs can be obtained through help() API:
$ import VisionFive.gpio as GPIO
$ help(GPIO)
$ help(GPIO.setup)
Sample Code
-------------
Support python sample, such as:
- GPIO basic operation including input and output
- Sense HAT(B) basing I2C API
- LED_Matrix to display logo about Starfive
- uart_gps_demo to read gps information from GPS NEO-6M
- pwm_led to test PWM module works well
- edge_detection_basic about basic edge API usage
- edge_with_waiting_time about edge detection with specific time
- edge_with_LED_Matrix about trigger LED display by button
- RPi_demo_#GPIO_basic#_run_on_VisionFive about running RPi GPIO demo on VisionFive board
- RPi_demo_#PWM#_run_on_VisionFive about running RPi PWM demo on VisionFive board
All demos above are on the example folder.
Change Log
==========
1.3.1
-------
- Fix bugs in 'gpio_function()'
1.3.0
-------
- Improve the setmode() and getmode() functions
- Added BCM mode
- Updated the demo program
1.2.16
-------
- Fix and update demo program of 2.4inch_LCD
1.2.15
-------
- Supplementary help documentation
- Fix the missing warning message when 'GPIO.cleanup()' is repeated
1.2.10
-------
- Fix gpio issues and text format
1.2.9
-------
- Add help description for gpio, i2c, spi
1.2.8
-------
- Fix gpio issue
1.2.7
-------
- Fix pud issue
1.2.6
-------
- Support GPIO edge detection
- Add GPIO edge detection demo
1.2.5
-------
- Support GPIO pud
1.2.4
-------
- update 2.24inch LCD demo
1.2.3
-------
- Update setup.py
1.2.2
-------
- Update gpio code
1.2.1
-------
- Modify PWM
1.2.0
-------
- Modify Demo Code
1.1.1
-------
- Modify prompt information
1.0.1
-------
- ###Basic function:
- For SPI API: add a function to write multiple bytes
- ###Python sample:
- ADD a SPI demo: using VisionFive SPI support LCD display
1.0.0
-------
- ###Basic function:
- Support basic GPIO function
- Support I2C API
- Support PWM API
- Support SPI API
- ###Python sample:
- GPIO basic operation, including input, output
- Sense HAT(B) basing I2C API
- LED_Matrix to display logo about Starfive
- uart_test to test VersionFive's UART works well with UART loopback
- uart_gps_demo to read gps information from GPS NEO-6M
- pwm_led to test PWM module works well
Raw data
{
"_id": null,
"home_page": "http://gitlab.starfivetech.com/product1/software-ae/visionfive-python-gpio/gpio-libs",
"name": "VisionFive.gpio",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "VisionFive GPIO",
"author": "StarFive",
"author_email": "support@starfivetech.com",
"download_url": "",
"platform": null,
"description": "\nThis package provides a Python module to control the GPIO on a VisionFive SBC.\n\nSupport basic GPIO function including I/O, edge detection, PWM, I2C, SPI. Although hardware PWM is not available yet, software PWM is available to use on all channels.\n\nInstallation\n--------------\n\nPypi does not support uploading binaries of RISC-V architectures, there are two ways to install VisionFive.gpio:\n\npip:\n\na. First, access the following website to check the latest version number of VisionFive.gpio: <https://pypi.org/project/VisionFive.gpio/#history> \n\nb. Replace \"1.x.x\" in the following URL with the latest version number obtained from the above step: <https://pypi.org/project/VisionFive.gpio/1.x.x/#files> \n\nc. Visit the modified URL, for example: <https://pypi.org/project/VisionFive.gpio/1.2.12/#files> \n\nd. Hover over the file with the \".whl\" extension (e.g., VisionFive.gpio-1.2.12-cp34-abi3-any.whl) and right-click to copy the link address. \n\ne. Download the .whl installation package using the wget command:\n\n$ wget download_address_of_whl_package\n\nf. Rename the .whl package by replacing \"any\" with \"linux_riscv64\":\n\n$ mv VisionFive.gpio-1.2.12-cp34-abi3-any.whl VisionFive.gpio-1.2.12-cp34-abi3-linux_riscv64.whl\n\ng. Finally, install the .whl package using the following command:\n\n$ pip install VisionFive.gpio-1.2.12-cp34-abi3-any.whl\n\nscript: \n\nYou can use the method provided in the following URL to install the script: <https://doc-en.rvspace.org/VisionFive2/AN_Edge_Detection/VisionFive2_ApplicationNotes/Shared_preparing_software%20-%20vf2.html>\n\nUsage\n-------\n\nSame as RPi.GPIO, help and usage of APIs can be obtained through help() API:\n\n$ import VisionFive.gpio as GPIO\n\n$ help(GPIO)\n\n$ help(GPIO.setup)\n\nSample Code \n-------------\n\nSupport python sample, such as: \n\n- GPIO basic operation including input and output\n- Sense HAT(B) basing I2C API\n- LED_Matrix to display logo about Starfive\n- uart_gps_demo to read gps information from GPS NEO-6M\n- pwm_led to test PWM module works well\n- edge_detection_basic about basic edge API usage\n- edge_with_waiting_time about edge detection with specific time\n- edge_with_LED_Matrix about trigger LED display by button\n- RPi_demo_#GPIO_basic#_run_on_VisionFive about running RPi GPIO demo on VisionFive board\n- RPi_demo_#PWM#_run_on_VisionFive about running RPi PWM demo on VisionFive board \n\nAll demos above are on the example folder.\n\nChange Log\n==========\n\n1.3.1\n-------\n- Fix bugs in 'gpio_function()'\n\n1.3.0\n-------\n- Improve the setmode() and getmode() functions\n- Added BCM mode\n- Updated the demo program\n\n1.2.16\n-------\n- Fix and update demo program of 2.4inch_LCD\n\n1.2.15\n-------\n- Supplementary help documentation\n- Fix the missing warning message when 'GPIO.cleanup()' is repeated\n\n1.2.10\n-------\n- Fix gpio issues and text format\n\n1.2.9\n-------\n- Add help description for gpio, i2c, spi\n\n1.2.8\n-------\n- Fix gpio issue\n\n1.2.7\n-------\n- Fix pud issue\n\n1.2.6\n-------\n- Support GPIO edge detection\n- Add GPIO edge detection demo\n\n1.2.5\n-------\n- Support GPIO pud\n\n1.2.4\n-------\n- update 2.24inch LCD demo\n\n1.2.3\n-------\n- Update setup.py\n\n1.2.2\n-------\n- Update gpio code\n\n1.2.1\n-------\n- Modify PWM\n\n1.2.0\n-------\n- Modify Demo Code\n\n1.1.1\n-------\n- Modify prompt information\n\n1.0.1\n-------\n- ###Basic function:\n- For SPI API: add a function to write multiple bytes\n- ###Python sample:\n- ADD a SPI demo: using VisionFive SPI support LCD display\n\n1.0.0\n-------\n- ###Basic function:\n- Support basic GPIO function\n- Support I2C API\n- Support PWM API\n- Support SPI API\n- ###Python sample:\n- GPIO basic operation, including input, output\n- Sense HAT(B) basing I2C API\n- LED_Matrix to display logo about Starfive\n- uart_test to test VersionFive's UART works well with UART loopback \n- uart_gps_demo to read gps information from GPS NEO-6M\n- pwm_led to test PWM module works well\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A module to control VisionFive GPIO ports",
"version": "1.3.1",
"project_urls": {
"Homepage": "http://gitlab.starfivetech.com/product1/software-ae/visionfive-python-gpio/gpio-libs"
},
"split_keywords": [
"visionfive",
"gpio"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9441c433dfa61fe14a110dffa3d43cf7b96c49c41a8e4529525a785b4b4d71f9",
"md5": "a369336eddfa0f4428750326a489b953",
"sha256": "1dd4173cc9a46af99e1be46d639130c4b0e7610d3e7c5162f9994350190beabd"
},
"downloads": -1,
"filename": "VisionFive.gpio-1.3.1-cp310-cp310-any.whl",
"has_sig": false,
"md5_digest": "a369336eddfa0f4428750326a489b953",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": null,
"size": 435747,
"upload_time": "2023-11-14T06:59:15",
"upload_time_iso_8601": "2023-11-14T06:59:15.202444Z",
"url": "https://files.pythonhosted.org/packages/94/41/c433dfa61fe14a110dffa3d43cf7b96c49c41a8e4529525a785b4b4d71f9/VisionFive.gpio-1.3.1-cp310-cp310-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-14 06:59:15",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "visionfive.gpio"
}
JSON