User Tools

Site Tools


mac-en

Differences

This shows you the differences between two versions of the page.


Previous revision
mac-en [2023/11/09 09:36] (current) rjversluis
Line 1: Line 1:
 +====== Apple macOS on Intel & Apple Silicon ======
 +[[:english|{{  rocrail-logo-35.png}}]]
 +[[:english|Content]] -> [[:english#getting started|Getting Started]]
 +  * [[:supported-os-en|Supported Operating Systems]]
 +    * ** macOS** 
 +
 +
 + \\
 +
 +=====Install & Run=====
 +  - Download the __**[[https://launchpad.net/rocrail/+download|Rocrail-revno-macos.app.zip]]**__ fitting to the installed macOS.
 +  - Double click on the Rocrail.app after the file has been unzipped. (Safari will unzip it automatically after download.)
 +  - A directory, "~/rocrail", is automatically created with the default rocview.ini and plan.xml after the first start of the Rocrail App. 
 +  - Open a __**[[:workspaces-en|Workspace]]**__ in this directory: "~/rocrail", or just select: \\ **File -> Demo Workspace**
 +
 +//(The tilde "**~**" represents the user home directory: **/Users/<username>**)//\\
 +====App Content====
 +<code>
 +Rocrail.app
 +└───Contents
 +    ├───MacOS
 +    |   ├───*.dylib (controllers and wxWidgets)
 +    |   ├───rocrail
 +    |   ├───rocview
 +    |   └───Run
 +    ├───Resources
 +    |   ├───rocrail.icns
 +    |   └───icons
 +    └───rocdata
 +        ├───svg
 +        ├───trace
 +        ├───images
 +        ├───web
 +        ├───decspecs
 +        ├───stylesheets
 +        └───plan.xml
 +</code>
 +
 +====User directory====
 +After the first application start, a rocrail directory will be created, in the users home, with the following content:
 +<code>
 +~/rocrail
 +├───plan.xml
 +├───images
 +├───decspecs
 +├───stylesheets
 +├───svg (symbolic link to Rocrail.app/rocdata/svg)
 +└───web (symbolic link to Rocrail.app/rocdata/web)
 +</code>
 +
 + \\
 +=====Security General=====
 +==== macOS Lion====
 +Select "Anywhere" to allow installation on macOS Lion+:\\
 +{{:osx:osx-gatekeeper.png?400}}\\
 +
 +==== macOS Sierra====
 +Starting with macOS Sierra there is no longer an option "Anywhere" available.\\
 +{{:mac:sierra-security.jpg}}\\
 +==== How to start the Rocrail.app if macOS blocks it. ====
 +^ How to start the Rocrail.app if macOS blocks it. ^^^
 +| {{:mac:mac-unidentdev.png}} | {{:mac:mac-open-by-context.png?0x200}} | {{:mac:mac-open-security.png?0x200}} | 
 +| 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:
 +  * {{:mac:howtorunappsthatarenotfromtheappstoreinmacossierra_public_beta_macworld.pdf}}
 +
 +
 +
 + \\
 +
 +===== USB to Serial Driver =====
 +Check the manual of the product which Chipset is used for selecting the right device driver.\\
 +^ Device driver ^ Remark ^ Products ^
 +| [[http://www.ftdichip.com/Drivers/VCP.htm|FTDI Virtual COM Port Drivers]] | Updates available.  | [[http://www.sprog-dcc.co.uk/|SPROG II]], [[http://www.rr-cirkits.com/|LocoBuffer USB]], [[http://digital-plus.de/|LI-USB]] |
 +| [[https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx|CP210x]] | Updates available. | - |
 +| http://www.prolific.com.tw/eng/downloads.asp?ID=31 | PL-2303 | |
 +
 + \\
 +Use the **''/dev/tty.*''** device instead of the **''/dev/cu.*''**!
 +
 + \\
 +Just use following command in a **[[http://en.wikipedia.org/wiki/Terminal_%28Mac_OS_X%29|Terminal]]** window to check your system for available serial devices:
 +<code>
 +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
 +</code>
 +In this case there are two serial devices listed:
 +  * /dev/tty.usbserial-00001124
 +  * /dev/tty.usbserial-A10048Md
 + \\
 +====System Information====
 +Alternatively the **[[http://en.wikipedia.org/wiki/System_Information|System Information]]** utility can be used to check the USB device name.\\
 +
 + \\
 +