Skip to main content


SwiftIO board reset repeatedly

There is a maximum current limit for the USB port of your devices, while some modules connected to the board may require a larger one. Thus the board reset over and over again.

You can try these ways:

  1. Connect the board to the USB port that can output larger power.‌

  2. Connect both the download port and the serial port on the board to USB ports.

  3. Use a power bank to supply the board.

USB driver can't be mounted

This problem may be due to these reasons:

  1. Bad-quality USB cable. There are so many bad-quality USB cables in the market. Some of them can only charge your device without communication feature : (

  2. Incompatible MicroSD card.

  3. Incompatible USB hub or incompatible USB-C to USB-A adapter.

  4. There is a known issue with USB compatibility on Mac. There are already a lot of discussions about it on Reddit, apple.

To solve problems 1 and 2, we offer a high-quality USB cable and a Kingston microSD card along with our board. But we still got feedback that the USB drive did not appear. In this situation, there is a temporary solution: use a USB card reader to copy the .bin file. At the same time, we’ll continue to improve the compatibility of the firmware.

Cannot open and build your project


If you use MadMachine IDE and see the message as below:

IDE error message

or use the MadMachine for VS Code and see similar messages as below when building your project:

/Applications/ error: failed to build module 'Combine' from its module interface; the compiler that produced it, 'Apple Swift version 5.5.2 (swiftlang-1300.0.46.202 clang-1300.0.29.30)', may have used features that aren't supported by this compiler, 'Swift version 5.4.2 (swift-5.4.2-RELEASE)'
// swift-interface-format-version: 1.0

It is due to version incompatibility. Our SDK now supports Swift 5.4, but the latest version of Xcode doesn't support it.


We now find two temporary solutions:

  1. The Xcode 13.0 supports Swift 5.4. You could download and reinstall the Xcode 13.0 if it's convenient for you.

  2. If you're familiar with git, you could fork this project and then edit your own project. The project would be compiled automatically into an executable file after you push it to Github. It will take several minutes. You could then download the generated bin file to your computer and copy it to the SD card in your SwiftIO board.

We're trying to solve this problem. Really sorry for such great inconvenience😫