upyboard


Nameupyboard JSON
Version 0.7.0 PyPI version JSON
download
home_pagehttps://github.com/planxstudio/upyboard
SummaryThis is a CLI tool for MicroPython-based embedded systems.
upload_time2025-03-06 01:14:00
maintainerNone
docs_urlNone
authorchanmin.park
requires_python>=3.8
licenseNone
keywords micropython pyserial genlib
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            This tool is supports microcontrollers to which MicroPython is ported.

### Help
```sh
upy
```
or
```sh
upy --help
```

### Finding the serial port on a board with MicroPython
- Explore a serially connected MicroPython device.
- The MicroPython version and device type are printed.
- Currently supported devices are Digi XBee3(xbee3) and Raspberry Pi Pico 2 W(pico2).

```sh
upy scan
```

```output
COM3 (v1.12-1556-gcc82fa9 on 2021-06-22; XBee3 Zigbee with EFR32MG)
COM4 (v1.25.0-preview.180.g495ce91ca on 2025-01-06; Raspberry Pi Pico 2 W with RP2350)
```

### Option Rules
- Options and values can have spaces or omit spaces.
- Options and values can be inserted with the = character.

```sh
<option><value>  
<option> <value>
<option>=<value> 
```

### Environment file
- You can omit this option by saving the environment variables required to run the tool in the current path in a .vscode/.upy file.
- By defining SERIAL_PORT and DEVICE_TYPE in this file, you can omit the --sport and --type options to be included in each command.

```sh
SERIAL_PORT=<your_com_port_name>
DEVICE_TYPE=<your_device_type>
```

Example (.upy)
```sh
SERIAL_PORT=com3
DEVICE_TYPE=xbee3
```

### Initialize Microcontroller file system
- If you created a .vscode/.upy file in the current path, omit the --sport and --type options in all subsequent commands.
```sh
upy init
```
or, You can also use the --sport and --type options explicitly.
```sh
upy --sport <your_com_port_name> --type <your_device_type> init
```

### Check list of Microcontroller file systems
- If path is omitted, the output will be the files or directories contained in the top-level directory.

```sh
upy ls [<path>/][remote_directory]
```

### Put PC file or directroy into Microcontroller
- If path or remote name is omitted, a remote name identical to the local name is created in the top-level directory.
```sh
upy put <local_name> [[path][/remote_name]]
```

### Get Microcontroller file to PC
- Getting the current directory is not supported.
```sh
upy get <remote_file_name> <local_file_name>
```

### Delete Microcontroller file or directory
```sh
upy rm [path/]<remote_name>
```

### Executes the PC's MicroPython script by sequentially passing it to the Microcontroller
- Wait for serial input/output until the script finishes  
- To force quit in running state, press Ctrl+c

```sh
upy <micropython_script_file>
```
or
```sh
upy run [-i | -n] <micropython_script_file>
```

**Additional Options**
- -i: Display the pressed key in the terminal window (Echo on)
- -n: Does not wait for serial output, so it appears as if the program has terminated on the PC side.
  - Script continues to run on Microcontroller
  - Used to check data output serially from Microcontroller with other tools (PuTTY, etc.)

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/planxstudio/upyboard",
    "name": "upyboard",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "micropython, pyserial, genlib",
    "author": "chanmin.park",
    "author_email": "devcamp@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/1e/24/f0de96bf7208e0e8eac0c3f3326d4124c14ef3c0d89a1fa27f17177888ab/upyboard-0.7.0.tar.gz",
    "platform": null,
    "description": "This tool is supports microcontrollers to which MicroPython is ported.\r\n\r\n### Help\r\n```sh\r\nupy\r\n```\r\nor\r\n```sh\r\nupy --help\r\n```\r\n\r\n### Finding the serial port on a board with MicroPython\r\n- Explore a serially connected MicroPython device.\r\n- The MicroPython version and device type are printed.\r\n- Currently supported devices are Digi XBee3(xbee3) and Raspberry Pi Pico 2 W(pico2).\r\n\r\n```sh\r\nupy scan\r\n```\r\n\r\n```output\r\nCOM3 (v1.12-1556-gcc82fa9 on 2021-06-22; XBee3 Zigbee with EFR32MG)\r\nCOM4 (v1.25.0-preview.180.g495ce91ca on 2025-01-06; Raspberry Pi Pico 2 W with RP2350)\r\n```\r\n\r\n### Option Rules\r\n- Options and values can have spaces or omit spaces.\r\n- Options and values can be inserted with the = character.\r\n\r\n```sh\r\n<option><value>  \r\n<option> <value>\r\n<option>=<value> \r\n```\r\n\r\n### Environment file\r\n- You can omit this option by saving the environment variables required to run the tool in the current path in a .vscode/.upy file.\r\n- By defining SERIAL_PORT and DEVICE_TYPE in this file, you can omit the --sport and --type options to be included in each command.\r\n\r\n```sh\r\nSERIAL_PORT=<your_com_port_name>\r\nDEVICE_TYPE=<your_device_type>\r\n```\r\n\r\nExample (.upy)\r\n```sh\r\nSERIAL_PORT=com3\r\nDEVICE_TYPE=xbee3\r\n```\r\n\r\n### Initialize Microcontroller file system\r\n- If you created a .vscode/.upy file in the current path, omit the --sport and --type options in all subsequent commands.\r\n```sh\r\nupy init\r\n```\r\nor, You can also use the --sport and --type options explicitly.\r\n```sh\r\nupy --sport <your_com_port_name> --type <your_device_type> init\r\n```\r\n\r\n### Check list of Microcontroller file systems\r\n- If path is omitted, the output will be the files or directories contained in the top-level directory.\r\n\r\n```sh\r\nupy ls [<path>/][remote_directory]\r\n```\r\n\r\n### Put PC file or directroy into Microcontroller\r\n- If path or remote name is omitted, a remote name identical to the local name is created in the top-level directory.\r\n```sh\r\nupy put <local_name> [[path][/remote_name]]\r\n```\r\n\r\n### Get Microcontroller file to PC\r\n- Getting the current directory is not supported.\r\n```sh\r\nupy get <remote_file_name> <local_file_name>\r\n```\r\n\r\n### Delete Microcontroller file or directory\r\n```sh\r\nupy rm [path/]<remote_name>\r\n```\r\n\r\n### Executes the PC's MicroPython script by sequentially passing it to the Microcontroller\r\n- Wait for serial input/output until the script finishes  \r\n- To force quit in running state, press Ctrl+c\r\n\r\n```sh\r\nupy <micropython_script_file>\r\n```\r\nor\r\n```sh\r\nupy run [-i | -n] <micropython_script_file>\r\n```\r\n\r\n**Additional Options**\r\n- -i: Display the pressed key in the terminal window (Echo on)\r\n- -n: Does not wait for serial output, so it appears as if the program has terminated on the PC side.\r\n  - Script continues to run on Microcontroller\r\n  - Used to check data output serially from Microcontroller with other tools (PuTTY, etc.)\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "This is a CLI tool for MicroPython-based embedded systems.",
    "version": "0.7.0",
    "project_urls": {
        "Homepage": "https://github.com/planxstudio/upyboard"
    },
    "split_keywords": [
        "micropython",
        " pyserial",
        " genlib"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9bc95b2a88ca91eb5162fc39ffc12c5f1bf01b01c11f08c18349d7f291770628",
                "md5": "1b8d08433d176e04767006caba38fbfb",
                "sha256": "309a391c0173b3375382f77cc19e977e4dbeb21ec06bffeaed27944767aa0235"
            },
            "downloads": -1,
            "filename": "upyboard-0.7.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1b8d08433d176e04767006caba38fbfb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 92916,
            "upload_time": "2025-03-06T01:13:58",
            "upload_time_iso_8601": "2025-03-06T01:13:58.528986Z",
            "url": "https://files.pythonhosted.org/packages/9b/c9/5b2a88ca91eb5162fc39ffc12c5f1bf01b01c11f08c18349d7f291770628/upyboard-0.7.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1e24f0de96bf7208e0e8eac0c3f3326d4124c14ef3c0d89a1fa27f17177888ab",
                "md5": "97c65296828b602438de0eae58116e4a",
                "sha256": "5df0a2ed3f258b31b1f17bb12646846916af387ddf5f48dbc74d8c8f6f7755d8"
            },
            "downloads": -1,
            "filename": "upyboard-0.7.0.tar.gz",
            "has_sig": false,
            "md5_digest": "97c65296828b602438de0eae58116e4a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 73339,
            "upload_time": "2025-03-06T01:14:00",
            "upload_time_iso_8601": "2025-03-06T01:14:00.517172Z",
            "url": "https://files.pythonhosted.org/packages/1e/24/f0de96bf7208e0e8eac0c3f3326d4124c14ef3c0d89a1fa27f17177888ab/upyboard-0.7.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-06 01:14:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "planxstudio",
    "github_project": "upyboard",
    "github_not_found": true,
    "lcname": "upyboard"
}
        
Elapsed time: 1.52817s