Skip to content

Commit 315a1c5

Browse files
Improve linux
1 parent b8afb9b commit 315a1c5

File tree

1 file changed

+14
-6
lines changed

1 file changed

+14
-6
lines changed

docs/os-development/building-for-linux.md renamed to docs/os-development/linux.md

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,20 +33,24 @@ sudo apt-get install -y build-essential libffi-dev pkg-config cmake ninja-build
3333
3434
Usage:
3535
36+
<pre>
3637
```
3738
./scripts/build_lvgl_micropython.sh <target system> <build type (prod or dev)> [optional target device]
3839
```
40+
</pre>
3941
40-
Supported target systems: esp32, unix (= Linux) and macOS
42+
**Target systems**: esp32, unix (= Linux) and macOS
4143
42-
Build types:
44+
**Build types**:
45+
4346
- A "prod" build includes the complete filesystem that's "frozen" into the build, so it's fast and all ready to go but the files in /lib and /builtin will be read-only.
4447
- A "dev" build comes without a filesystem, so it's perfect for power users that want to work on MicroPythonOS internals. There's a simple script that will copy all the necessary files over later, and these will be writeable.
45-
Note: for unix and macOS systems, only "dev" has been tested. The "prod" builds might have issues.
4648
47-
Target devices: waveshare-esp32-s3-touch-lcd-2 and fri3d-2024
49+
_Note_: for unix and macOS systems, only "dev" has been tested. The "prod" builds might have issues but should be made to work soon.
50+
51+
**Target devices**: waveshare-esp32-s3-touch-lcd-2 and fri3d-2024
4852
49-
Examples:
53+
**Examples**:
5054
5155
<pre>
5256
```
@@ -58,6 +62,7 @@ sudo apt-get install -y build-essential libffi-dev pkg-config cmake ninja-build
5862
</pre>
5963
6064
The resulting build file will be in `lvgl_micropython/build/`, for example:
65+
6166
- lvgl_micropython/build/lvgl_micropy_unix
6267
- lvgl_micropython/build/lvgl_micropy_macOS
6368
- lvgl_micropython/build/lvgl_micropy_ESP32_GENERIC_S3-SPIRAM_OCT-16.bin
@@ -69,10 +74,13 @@ sudo apt-get install -y build-essential libffi-dev pkg-config cmake ninja-build
6974
7075
<pre>
7176
```
72-
./scripts/run_desktop.sh
77+
cd internal_filesystem/
78+
/path/to/MicroPythonOS_amd64_Linux -X heapsize=32M -v -i -c "$(cat boot_unix.py main.py)"
7379
```
7480
</pre>
7581
82+
There's also convenient `./scripts/run_desktop.sh` script that will attempt to start the latest build, if you compiled it yourself.
83+
7684
### Modifying files
7785
7886
You'll notice that, whenever you change a file on your local system, the changes are immediately visible whenever you reload the file.

0 commit comments

Comments
 (0)