Skip to content

Commit 0ecf933

Browse files
Update - README.md
1 parent 45fd723 commit 0ecf933

File tree

1 file changed

+42
-17
lines changed

1 file changed

+42
-17
lines changed

README.md

Lines changed: 42 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ I designed and made it to be used for upgrading the hotend.**
3333
---
3434

3535
## Universal Firmware for RET6/RCT6 chips:
36-
G32, N32, H32, Creality 4.2.7 and 4.2.2 boards <br>
36+
G32, N32, H32, Creality 4.2.7 and 4.2.2 boards<br>
3737
**_<sup><sub>(Also available for E3 Free-runs, BTT SKR Mini E3, STM32F401, GD32F303, and others)</sub></sup>_**
3838

3939
> [!IMPORTANT]
@@ -57,6 +57,8 @@ New ICON's have been added, and old ones enhanced. Whoever edited them before sa
5757
5858
---
5959

60+
## Firmware for HC32 chips:
61+
6062
> [!IMPORTANT]
6163
> **Information regarding HC32:**
6264
@@ -88,21 +90,34 @@ Other changes and updates are [addressed here](https://github.com/classicrocker8
8890
There is a *MarlinSimulator* file provided to test out for yourself. It simulates a pre-built configuration of this firmware.
8991

9092
The *MarlinSimulator* can compile for Manual Mesh Bed Leveling or Auto Bed Leveling w/`BLTOUCH` enabled.
91-
Start in **Configuration.h** and change the `MOTHERBOARD` to `BOARD_SIMULATED`, then disable `ENDSTOP_INTERRUPTS_FEATURE` and `PROUI_EX`.
92-
Then in **platformio.ini** at `default_envs =` change to `simulator_windows` (for Windows) | `simulator_linux_release` (for Linux).
93-
If there is an error run `./buildroot/share/scripts/simulator_error.sh` or change the following manually:
94-
- Replace `#define INVERT_E0_DIR HMI_data.Invert_E0` with `#define INVERT_E0_DIR false` (or comment it and `#undef INVERT_E0_DIR` out) in **proui/dwin_defines.h**.
95-
- Comment out `#undef Z_MIN_ENDSTOP_HIT_STATE` in **inc/Conditionals-5-post.h**.
96-
- Replace `-flto` with `-fno-lto` at `release_flags =` under `[simulator_common]` in **native.ini**.
93+
Start in **Configuration.h** and change `MOTHERBOARD` to `BOARD_SIMULATED`, then disable `ENDSTOP_INTERRUPTS_FEATURE` and `PROUI_EX`:
94+
```y
95+
#ifndef MOTHERBOARD
96+
#define MOTHERBOARD BOARD_SIMULATED
97+
#endif
98+
---
99+
//#define ENDSTOP_INTERRUPTS_FEATURE
100+
---
101+
//#define PROUI_EX 1
102+
```
103+
<br>
104+
105+
Then in **platformio.ini** for `default_envs =` change to `simulator_windows` (for Windows) | `simulator_linux_release` (for Linux):
106+
```ini
107+
default_envs = simulator_windows
108+
---
109+
default_envs = simulator_linux_release
110+
```
97111

98112
For MacOS you're on your own...sorry.
99113

100-
Then you have to extract **SDL2-devel-2.32.2-mingw.zip** from /**docs**.
101-
Or for the latest releast go to [libsdl-org/SDL/releases](https://github.com/libsdl-org/SDL/releases) and look for the latest **SDL2** version (**NOT** *SDL3*)
114+
#### Install Files (Windows)
115+
If you haven't already, you must install the SDL2 library.
116+
**SDL2-devel-2.32.2-mingw.zip** is provided for in /**docs**.
117+
Or get the latest release at [libsdl-org/SDL/releases](https://github.com/libsdl-org/SDL/releases) and look for **SDL2** version (**NOT** *SDL3*)
102118
You can *either* copy/paste the files directly, or install them.
103-
It's recommended to install them, but if you have any issues, then try copy/paste method.
119+
It's recommended to install them, but if you have any issues, then try the alternative copy/paste method.
104120

105-
#### Install Files (Windows)
106121
Navigate to the extracted SDL2 directory in an *MSYS2* or *bash* terminal (Run as Administrator):
107122

108123
To install SDL for native (32-bit) development:
@@ -133,11 +148,21 @@ These are the files you need to install:
133148
- There may be other basic ones if you don't have already; like python, cmake, pip...
134149

135150
#### Using MarlinSimulator
136-
- Open the executable program found in **.pio\build\simulator_<windows/linux>**
137-
- - For Linux, enter in a terminal `./MarlinSimulator`
138-
- Under `SD Card`, under `Components` on the right side, select or load an image
139-
- Select Serial Monitor(1)
140-
- Use like a normal terminal, enter `G28` to watch it Home
151+
Before building, open a terminal and run `./buildroot/share/scripts/simulator_error.sh`, or change the following manually:
152+
- Replace `#define INVERT_E0_DIR HMI_data.Invert_E0` with `#define INVERT_E0_DIR false` (or comment it and `#undef INVERT_E0_DIR` out) in **proui/dwin_defines.h**.
153+
- Comment out `#undef Z_MIN_ENDSTOP_HIT_STATE` in **inc/Conditionals-5-post.h**.
154+
- Replace `-flto` with `-fno-lto` at `release_flags =` under `[simulator_common]` in **native.ini**.
155+
156+
157+
- Open the executable program found in **.pio\build\simulator_<windows|linux_release>**.
158+
- - For Windows, *MarlinSimulator.exe*
159+
- - For Linux, enter in a terminal: `./MarlinSimulator`
160+
161+
How to use:
162+
- Under `SD Card`, under `Components` on the right side, select or load an image.
163+
- - To simulate an actual print, you may need to use a *.img* file containing the *.gcode*.
164+
- Select Serial Monitor(1) if you do not see any output.
165+
- Use like a normal terminal, enter `G28` to watch it Home for example.
141166

142167
<br>
143168

@@ -210,7 +235,7 @@ Thanks to Reddit u/schuh8 and GitHub @whasupjohn for donating his board to help
210235
<summary>Find me</summary>
211236
On <a href="https://www.facebook.com/yoboyyy">Facebook</a>
212237

213-
On Reddit: u/<b>In*Us*2</b>
238+
On Reddit: u/<b>In*Us*2</b> - not actually, but if you know, you know
214239
</details>
215240
</p>
216241

0 commit comments

Comments
 (0)