Applicable printers

• Support MCU: STM32F446Z or GD32F4xx

• Version: 2.18.0

  1	2	3	4	5	6
  GEMINIS	GEMINIX	GEMINIXS	GEMINID1	GEMINID3

How to compile

1. Warning: current source code supports bootloader version 1.58 and above, when you restart the machine, the upper left corner of screen should display the bootloader version, if it doesn't display or the version is lower than 1.58, you can't use this firmware.

2. Install vscode, and install platformio plugin in the vscode extension.

3. Download this firmware and unzip it, you will get a firmware folder. Run vscode -> file -> Open Folder, select the firmware folder, open it.

4. Check the model on the machine: Start the printer, enter the System ->Info interface, and when the firmware version is above 2.16, you can view the relevant information of the current model, as shown in the following figure.

   

5. If the applicable model listed on this page does not have your model, please download another appropriate firmware

6. Open Marlin/TronxyMachine.h, Find #define TRONXY PROJ, change the following project name to PROJ XXX (XXX represents your printer model).

   • Note: The modified project name must be a name defined above the file(TronxyMachine.h). If there is no such name, contact customer service for handling. e.g. your model is XY2_PRO:

7. Try compiling, and the compiler will automatically download relevant dependent libraries. If an error occurs, please refer to the FAQ for solutions.

8. Open file: .platformio\packages\framework-arduinoststm32\system\Middlewares\ST\STM32_USB_Host_Library\Core\Src\usbh_core.c

   • Find function USBH StatusTypeDef USBH Init(...)
   • Add a statement below the statement 'USBH_LL_Init(phost);' : 'USBH_LL_Disconnect(phost);'

9. Compile the firmware. The first compilation may take a long time. The compiled target file is placed in the 'update' folder

10. Copy the 'update' folder into the root directory of the SD card, insert the card into the printer, restart, and the machine will automatically update the firmware. After that, the machine will run the current firmware.

FAQ

1. If you want to switch back to the original interface of Marlin, just define "#define TRONXY_UI" in "Marlin/TronxyMachine.h" as UI_MARLIN_DEFAULT

   • Note: Remember the current UI name, otherwise, when you want to switch back to the factory interface, you will forget which UI it is, because different UI correspond to different resolution screens. If you switch incorrectly, an exception will be displayed.

2. When you burn the firmware you compiled into the machine and report an error all the time, you should pay attention to: by default, the main control chip corresponding to this firmware is STM32F446ZET, but in fact, because another chip GD32F4 may be used on the same machine, you need to confirm which chip your machine is.There are two confirmation methods:

   • 2.1 Enter System ->Info to view. If there is 'GD32' in it, it means GD32 series chips. If there is no GD32, it means STM32 series chips
   • 2.2 Open the chassis directly and check the screen print of the main control chip on the control board, which will be marked with GD32 or STM32

   When GD32 series chips are confirmed, you need to modify:

   • In the "platformio.ini" file, find Section [my_board], where there is a "DMCU_TYPE=0", change it to "DMCU_TYPE=4"

   • In the platformio installation directory, find the function uint32_t analogRead(uint32_t ulPin) in the .platformio\packages\framework-arduinoststm32\cores\arduino\wiring_analog.c, Add some code under the statement "value = adc_read_value(p, _internalReadResolution)",like this:

     value = adc_read_value(...

     if MCU_TYPE == 4

     if ADC_RESOLUTION == 12

     elif ADC_RESOLUTION == 10

     value >>= 2;

     value &= 0x03FF;

     elif ADC_RESOLUTION == 8

     value >>= 4;

     value &= 0x00FF;

     else

     error "The adc does not support the resolution"

     endif

     endif

     value = mapResolution(value...

     

   After modification, recompile and burn. At this time, it becomes the firmware of GD32

3. If you encounter problems like " multiple definition of 'EXTI1_IRQHandler' " as shown below, please find the location of the file in the figure below

   

   open the file and comment out “void EXTI1_IRQHandler(void)”(according to the error message) function, as shown in the figure.