Content → Getting Started

• Supported Operating Systems
  • macOS

1. Download the Rocrail-revno-macos.app.zip fitting to the installed macOS.
2. Double click on the Rocrail.app after the file has been unzipped. (Safari will unzip it automatically after download.)
3. A directory, "~/rocrail", is automatically created with the default rocview.ini and plan.xml after the first start of the Rocrail App.
4. Open a Workspace in this directory: "~/rocrail", or just select:
   File → Demo Workspace

(The tilde "~" represents the user home directory: /Users/<username>)

Rocrail.app
└───Contents
    ├───MacOS
    |   ├───*.dylib (controllers and wxWidgets)
    |   ├───rocrail
    |   ├───rocview
    |   └───Run
    ├───Resources
    |   ├───rocrail.icns
    |   └───icons
    └───rocdata
        ├───svg
        ├───trace
        ├───images
        ├───web
        ├───decspecs
        ├───stylesheets
        └───plan.xml

After the first application start, a rocrail directory will be created, in the users home, with the following content:

~/rocrail
├───plan.xml
├───images
├───decspecs
├───stylesheets
├───svg (symbolic link to Rocrail.app/rocdata/svg)
└───web (symbolic link to Rocrail.app/rocdata/web)

Select "Anywhere" to allow installation on macOS Lion+:

Starting with macOS Sierra there is no longer an option "Anywhere" available.

How to start the Rocrail.app if macOS blocks it.
After a double click on the Rocrail.app this exception will occur.	Open the context menu of the Rocrail.app and click on Open.	The same exception popup occurs, but this time with an Open button.

If macOS refuses to open the Rocrail.app please check:

• howtorunappsthatarenotfromtheappstoreinmacossierra_public_beta_macworld.pdf

Check the manual of the product which Chipset is used for selecting the right device driver.

Use the /dev/tty.* device instead of the /dev/cu.*!

Just use following command in a Terminal window to check your system for available serial devices:

macbook:~ jack$ ls -l /dev/tty.*
crw-rw-rw-  1 root  wheel   17,   8 26 Feb 20:01 /dev/tty.Bluetooth-Modem
crw-rw-rw-  1 root  wheel   17,   4 26 Feb 20:01 /dev/tty.Bluetooth-PDA-Sync
crw-rw-rw-  1 root  wheel   17,   0 26 Feb 20:01 /dev/tty.usbserial-00001124
crw-rw-rw-  1 root  wheel   17,   2 26 Feb 20:01 /dev/tty.usbserial-A10048Md

In this case there are two serial devices listed:

• /dev/tty.usbserial-00001124
• /dev/tty.usbserial-A10048Md

Alternatively the System Information utility can be used to check the USB device name.