=============================================================================
          MOXA UPort 1100 Series Device Driver Installation Guide
                         for macOS 10.12 ~ 10.15
                       Copyright (C) 2020, Moxa Inc.
=============================================================================
Content

1. Introduction
2. System Requirements
3. Installation
   3.1 Driver Installation   
   3.2 Device Naming Convention
   3.3 Verifying Driver Installation
   3.4 Change the default interface
4. Troubleshooting

-----------------------------------------------------------------------------
1. Introduction
   The UPort 1100 Series macOS driver supports the following UPort devices:
   UPort 1100
   UPort 1130/1130I
   UPort 1150/1150I

-----------------------------------------------------------------------------
2. System Requirements
   Hardware platform: Intel x86/x64 machine
   USB Standard: USB 1.1/2.0 compliant
   OS version: macOS 10.12 to 10.15

-----------------------------------------------------------------------------
3. Installation
             
   3.1 Driver Installation

       Before installing the driver, your Mac will need to enter
       "Recovery Mode" to be able to install. Please refer to the 
       "Troubleshooting" section to learn how to enter Recovery Mode.

       The released driver is named
       "driv_macOS_up11x0_vX.Y_build_yymmddhh.pkg"
       Double-click the driver package and follow the wizard to install the
       UPort driver.

       Note: X.Y=version, yy=year, mm=month, dd=day, hh=hour 
 

   3.2 Device Naming Convention

       Dial-in and callout ports
       -----------------------
       This driver remains traditional serial device properties. Each serial
       port has its own special file name. The dial-in port is named
       "tty.USBx" while the callout port's is named "cu.USBx".

       Use the command below to view the relevant information regarding the
       dial-in port of the UPort:

         $ mxstty -v

   3.3 Verifying Driver Installation

       Open the Applications/Utilities/System Information
       (or System Profiler). In Software-Extensions, find mxu11x0 extension
       in the "Extension Name" column, and its information should be
       displayed.

   3.4 Change the default interface

       The default interface depends on the UPort model's description below:
         UPort 1110/1150/1150I  - RS-232 mode
         UPort 1130/1130I       - RS-485 2-wired mode
       
       The interface will reset after the USB has been re-plugged or the
       system has been restarted. Users may specify the interface when the
       device is starting up. Use the command below to change the UPort
       interface:

         $ mxstty -i RS4852W /dev/tty.USB0

       The detailed usage is displayed by the command below:

         $ mxstty -h

-----------------------------------------------------------------------------
4. Troubleshooting
   Turn off System Integrity Protection (SIP)
   1. Reboot the Mac and hold command ⌘+R, entering Recovery Mode.
   2. Launch the terminal
   3. Type 'csrutil disable'
   4. Reboot the Mac again and return to Normal Mode
   5. Relaunch the UPort driver installer and complete the installation.

   After the UPort driver has been installed successfully, you may want to
   re-enable the protection with the following steps:
   1. Reboot the Mac and hold command ⌘+R, entering Recovery Mode.
   2. Launch the terminal
   3. Type 'csrutil enable'
   4. Reboot the Mac again and return to Normal Mode

   If you cannot install the driver on macOS 10.15 successfully, starting
   with macOS 10.15 Catalina, Apple has introduced a new read-only protection
   and does not allow users to install directly in the kernel folder..
   To solve this issue, please type the following command in Terminal before
   installation:

     $ sudo mount -uw /
