|
1 | | -# mpremote-vscode |
2 | | -Command palette access to mpremote Python module. Learn how to use it |
3 | | -in the [wiki](https://github.com/DavesCodeMusings/mpremote-vscode/wiki) |
| 1 | +# uv-mpremote-vscode |
4 | 2 |
|
5 | | -## Features |
6 | | -The goal of this extension is giving easy access to some of mpremote's |
7 | | -functionality from within VS Code. |
8 | | - |
9 | | -The most notable features are the the ability to access a REPL prompt, |
10 | | -upload files from the development host to the microcontroller, and |
11 | | -install packages using MicroPython's MIP tool. |
12 | | - |
13 | | -If more than one MicroPython device is plugged in when a command is run, |
14 | | -you will be given a selection list of COM ports to choose from. |
15 | | - |
16 | | -## Installing and Using the Extension |
17 | | -The extension can be installed from the VS Code Marketplace: |
18 | | -https://marketplace.visualstudio.com/publishers/DavesCodeMusings |
19 | | - |
20 | | -To use the extension: |
21 | | -1. In VS Code, open the folder containing your MicroPython project's files. |
22 | | -2. Plug in your microcontroller and find it under Serial Ports in VS Code's Explorer pane. |
23 | | -3. Right-click the microcotroller's serial port to access a menu of MPRemote commands. |
24 | | - |
25 | | -## Requirements |
26 | | -The host running this extension must have Python 3 installed as well |
27 | | -as the mpremote module. |
28 | | - |
29 | | -You can get Python from: https://www.python.org/downloads/ |
30 | | - |
31 | | -The mpremote module can be installed with pip, like this: |
32 | | -`py -m pip install mpremote` |
33 | | - |
34 | | -## About Version Numbers |
35 | | -Older version numbers attempted to follow MicroPython's mpremote version. Starting with 2.0, this extension's version is independent. |
36 | | - |
37 | | -## Release Notes |
38 | | - |
39 | | -### 2.0.0 |
40 | | -Standardize on semantic versioning. |
41 | | - |
42 | | -### 1.21.21 |
43 | | -Enhancement to add "Run on remote device (run)" to the editor toolbar's Run button. |
44 | | - |
45 | | -### 1.21.20 |
46 | | -Enhancement to skip `__pycache__` on recursive uploads (issue #36). |
47 | | - |
48 | | -### 1.21.19 |
49 | | -Bug fix for Linux serial port detection (issue #35). |
50 | | - |
51 | | -### 1.21.18 |
52 | | -Enhancement to add the `df` command to show flash file system usage (issue #34). |
53 | | - |
54 | | -### 1.21.17 |
55 | | -Enhancement to allow overriding mpremote command invocation with config setting (issue #31). |
56 | | - |
57 | | -### 1.21.16 |
58 | | -Remove SerialPort dependency and use mpremote devs instead (issue #29). |
59 | | - |
60 | | -### 1.21.15 |
61 | | -Enhancement to show MicroPython firmware version on device (issue #26). |
62 | | - |
63 | | -### 1.21.14 |
64 | | -Enhancement to allow upload of any file type, not just .py (issue #30). |
65 | | - |
66 | | -### 1.21.13 |
67 | | -Fixes path separator problem when uploading (issue #32). |
68 | | - |
69 | | -### 1.21.12 |
70 | | -Reverting 1.21.11 changes due to bugs. |
71 | | - |
72 | | -### 1.21.11 |
73 | | -Add feature for uploading into a directory other than / (issue #24). |
74 | | - |
75 | | -### 1.21.10 |
76 | | -Fix serial port skip bug (issue #22). Thanks SteveKerle! |
77 | | - |
78 | | -### 1.21.9 |
79 | | -Allow .mpy files to be uploaded/downloaded with context menu. |
80 | | - |
81 | | -### 1.21.8 |
82 | | -Change how mpremote is called on non-Windows systems. |
83 | | - |
84 | | -### 1.21.7 |
85 | | -Configuration option for specific local subdir for MicroPython files (e.g. src) |
86 | | - |
87 | | -### 1.21.6 |
88 | | -Uploading individual files in subdirectories takes local subdirectories into account. |
89 | | - |
90 | | -### 1.21.5 |
91 | | -Use python3 as the binary for non-Windows systems. |
92 | | - |
93 | | -### 1.21.4 |
94 | | -Bug fix for multiple terminals. Consolidate Python executable O.S. detection. |
95 | | - |
96 | | -### 1.21.3 |
97 | | -Bug fix for remote file/dir selection prompts not working on non-Windows systems. |
98 | | - |
99 | | -### 1.21.2 |
100 | | -Bug fix for unknown local path when run and upload commands are chosen from the palette. |
101 | | - |
102 | | -### 1.21.1 |
103 | | -Bug fixes for sync and setrtc from command palette and sync files with spaces. |
104 | | - |
105 | | -### 1.21.0 |
106 | | -Change made to realtime clock set command. |
107 | | - |
108 | | -### 1.20.19 |
109 | | -Bug fixes to quote file and dir names containing spaces. |
110 | | - |
111 | | -### 1.20.18 |
112 | | -Bug fix for serial port skip configuration. |
113 | | - |
114 | | -### 1.20.17 |
115 | | -Provide configuration option to skip start-up checks for python binary |
116 | | -and mpremote module. |
117 | | - |
118 | | -### 1.20.16 |
119 | | -Add refresh button to serial port welcome view. |
120 | | - |
121 | | -### 1.20.15 |
122 | | -Fix to rmdir command. Welcome view for empty Serial Ports. |
123 | | - |
124 | | -### 1.20.14 |
125 | | -Fixes to run and upload commands. Menu cleanup. |
126 | | - |
127 | | -### 1.20.13 |
128 | | -The "Born under a bad sign" release, with apologies to Albert King. Fixed |
129 | | -missing code in the 'sync' command. Cleaned up string checking. |
130 | | - |
131 | | -### 1.20.12 |
132 | | -Added exec command. Organized context menu. |
133 | | - |
134 | | -### 1.20.11 |
135 | | -Skipping the dot ten release, because there are so many changes. This one... |
136 | | -wait for it... this one goes up to eleven! |
137 | | - |
138 | | -Converted code to TypeScript. Updated user interface with serial port explorer |
139 | | -view and many more context menu options. Removed welcome view and snake icon. |
140 | | - |
141 | | -### 1.20.9 |
142 | | -Closes Python virtual env bug (issue #4). Also minor UI tweak. |
143 | | - |
144 | | -### 1.20.8 |
145 | | -Closes mip bug (issue #3) and serial port skip enhancement (issue #5) |
146 | | - |
147 | | -### 1.20.7 |
148 | | -Add welcome view to activity bar. |
149 | | - |
150 | | -### 1.20.6 |
151 | | -Add some commands to context menus. |
152 | | - |
153 | | -### 1.20.5 |
154 | | -Code improvements, fixes, and new `setrtc` command. |
155 | | - |
156 | | -### 1.20.4 |
157 | | -Added sync command for mass upload. |
158 | | - |
159 | | -### 1.20.3 |
160 | | -New commands and UI consistency improvements. |
161 | | - |
162 | | -### 1.20.2 |
163 | | -New commands. Better handling of remote subdirectories. |
164 | | - |
165 | | -### 1.20.1 |
166 | | -Fix problems when there are unsaved changes in editor. |
167 | | - |
168 | | -### 1.20.0 |
169 | | -Fix to use quotes around file paths so spaces don't cause problems. |
170 | | -Bump version to match compatible mpremote version. |
171 | | - |
172 | | -### 0.4.4 |
173 | | -Fix to use py.exe only on Windows and python on all other OS. |
174 | | - |
175 | | -### 0.4.3 |
176 | | -Logo change. |
177 | | - |
178 | | -### 0.4.2 |
179 | | -Fixed upload file bug. |
180 | | - |
181 | | -### 0.4.1 |
182 | | -Detect COM ports as part of the extension's code rather than parsing |
183 | | -output from mpremote's devs command. |
184 | | - |
185 | | -Auto-save current editor locally before calling mpremote run. |
186 | | - |
187 | | -Use active editor path for file uploads rather than an Open dialog. |
| 3 | +This plugin is a slight modification of [https://github.com/DavesCodeMusings/mpremote-vscode](https://github.com/DavesCodeMusings/mpremote-vscode). It has been chagned to accommodate the `uv` package manager and to automatically detect the Python binary used to run programs using the manager. |
0 commit comments