This chapter describes the Code Composer Studio installation process.
There are 6 different installation programs provided for Code Composoer Studio. There are web and offline installers provided for each of Windows, Linux and macOS.
The web installer is a lightweight installation program. The initial download is very small and enables the selection of features and device support to install. Once the selections are made the installer will then download the appropriate packages to complete the desired selection.
The offline installer, or full installer, is a larger installation program. The download contains all of the available installation options. This installer does not require internet connectivity to run.
Each version of Code Composer Studio describes its list of System Requirements. If your system does not meet these requirements you may experience poor performance, or the inability to run the application.
The [System Requirements](ccs_overview.html#System-Requirements) section in the Overview chapter has more information on the requirements for this release.
During the installation of Code Composer Studio there may be packages downloaded from the internet and installed. Some anti-virus and security software detects this and will block the installation. As a result it is recommended that such software be disabled during installation of Code Composer Studio. This is not a requirement but if the installation fails it is recommended to try again with the security software disabled. The full/offline installation is less susceptible to these issues.
Depending on what debug probes are selected during installation there will be device drivers that need to be installed on the system. In order to complete this step the appropriate permissions on the system will be required. On Linux this involves running an installation script as sudo at the end of the installation.
Overall the installation process is the same across Windows, Linux and macOS. Where there are differences this will be noted in the installation steps.
The installation images for Code Composer Studio can be obtained fron the [CCS Download Site](https://processors.wiki.ti.com/index.php/Download_CCS).
Select the image that matches the host operating system of the computer that it will be installed on.
##Running the Installer
Note that most of the installers are provided inside archive files such as a zip file. It is necessary to extract the archive file before proceeding with installation.
For Linux users it is recommended to install as a normal user and not sudo/root.
The Code Composer Studio installation is dependent on other software packages. For Windows and macOS users these packages will be installed automatically as part of the installation. For Linux users the installer will attempt to identify which packages are missing and display this list. On Linux the dependencies should be installed prior to continuing with installation. More informaiton on dependecies is provide in the [Linux Host Support](https://software-dl.ti.com/ccs/esd/documents/ccsv8_linux_host_support.html) article.
When it first launches the installer will check the system to see if it meets the requirements for installation. Any issues that need to be addressed will be displayed. Disabling security software is recommended but optional.
![alt text](images/install_systemcheck.png "System Check")
The end user license agreement is displayed. The agreement can be printed if desired. The license agreement must be accepted to continue.
![alt text](images/install_license.png "End User License Agreement")
Choose a location to install Code Composer Studio. This location must not already contain a Code Composer Studio installation. If multiple versions of Code Composer Studio will be installed then it is recommended to install them in versioned folders.
![alt text](images/install_location.png "Location for installation")
This screen is used to configure which device families to install support for. When a family is selected on the left hand side a short description will be displayed on the right. This is useful to help determine which selections to make. As families are checked the Installation Size displayed at the bottom right will be updated.
![alt text](images/install_devicesupport.png "Devices selection")
Note that it is possible to add support for families after installation by running the installer again and pointing it at the existing installation.
###Debug Probe Support
The software to enable a variety of Debug Probes is included with the Code Composer Studio installation. Depending on the device families selected on the previous screen some of the options may be mandatory.
![alt text](images/install_debugprobes.png "Debug Probe Selection")
As the installation proceeds the progress screen will show what the installer is doing. Depending on how many device families were selected the installation may take a significant amount of time. The web installer will take additional time as it needs to download the required components from the internet.
![alt text](images/install_progress.png "Installation Progress")
Windows only. If you have Windows Defender enabled, at the beginning of this process the alert below will be displayed. Click on "Allow Access" to properly install CCS.
![alt text](images/install_windows_sec_alert.png "Windows security alert")
Windows only. If Blackhawk or Spectrum Digital driver install option was chosen, close to the end of the install process the warnings below may be shown.
![alt text](images/install_BH_driver_warning.png "Blackhawk driver install warning")
![alt text](images/install_SD_driver_warning.png "Spectrum Digital driver install warning")
If installing on Linux as a normal user a screen will be shown that provides the location of the driver installation script. It is necessary to run the indicated script as sudo/root. This will ensure that the drivers for the debug probes are installed correctly.
The last screen shown during installation is the successful completion screen. This screen provides options to launch Code Composer Studio and to create a desktop shortcut.
![alt text](images/install_complete.png "Installation Complete")
To uninstall CCS: exit CCS, navigate to <CCSInstallRoot>/ccsv[x] directory and run the uninstall_ccs executable.
To uninstall the entire installation (including other components like xdctools): delete the entire installation directory.