Notes When Installing on macOS

Notes when installing the TWELITE STAGE APP on macOS

macOS

Environment

The development and operation have been confirmed in the following environments.

macOS 10.14 (Mojave, Intel)
macOS 12 (Monterey, Apple Silicon)

Installing Rosetta 2

Rosetta 2 is required for building applications for the BLUE / RED series.


/usr/sbin/softwareupdate --install-rosetta --agree-to-license

The build for the BLUE / RED series uses toolchains such as ba-elf-gcc, but Apple Silicon binaries are not available.

Therefore, please use macOS 27 or earlier when building for the BLUE / RED series.

Dependent Software and Warning Dialogs

If the following issues occur, permission to execute or installation is required for the operation of TWELITE_Stage.command.

Although the toolchain is code-signed, if the code signature is not properly verified, you may be prompted to allow execution individually for each executable in the build toolchain (such as ba-elf-gcc).
The downloaded archive is not signed. At runtime, security warnings may appear indicating that the application was downloaded from the Internet.
You may be asked to allow execution from the path where TWELITE_Stage.command is installed.
A dialog for installing the make utility may appear during build execution.

Additional Installation of make Utility

In some cases, you may need to install the make utility.

Depending on the macOS version and other factors, a different procedure may be necessary.

If an error occurs when running make from the command line (zsh), install the Command Line Tools.


xcode-select --install

Once the installation is complete, enter make and check for the following output message.


make
make: *** No targets specified and no makefile found.  Stop.

Handling Serial Ports

MONOSTICK and TWELITE R series are equipped with USB serial converter ICs (FT230/FT232 series) from FTDI (https://www.ftdichip.com). To use these, device driver installation may be required.

If the serial port does not appear even after launching TWELITE_Stage.command, please unload (disable) the FTDI driver.

This utility not only suppresses loading of the OS standard device driver when MONOSTICK or TWELITE R is inserted, but also suppresses loading of device drivers for other devices with the same USB ID.

You can download D2xxHelper from https://www.ftdichip.com/Drivers/D2XX.htm. The same is also included in the TWELITE_Stage/INSTALL folder of the TWELITE STAGE SDK.

Reference: Manual Unloading of FTDI Device Driver

To unload FTDI-related drivers, execute the following command.


sudo kextunload -b com.apple.driver.AppleUSBFTDI