AMD-AOCC-Extension-v-1.0.0

Initial release

AMD-AOCC-Extension-v-1.0.0 for Visual Studio Code

This release of the AMD-AOCC-Extension-v-1.0.0 is for Linux 64-bit and it adds C/C++/Fortran support to Visual Studio Code which can be used with AOCC compiler.

Overview and getting started

AMD-AOCC-Extension-v-1.0.0 overview

C/C++/Fortran support for Visual Studio Code is provided by a AMD-AOCC-Extension-v-1.0.0 to enable C, C++ and Fortran development on Linux using AOCC compiler.

Getting started

C/C++/Fortran compiler

The AMD-AOCC-Extension-v-1.0.0 does not include a C/C++/Fortran compiler. You will need to install these tools or use those already installed on your computer. Eg: AOCC compiler

Link for aocc compiler https://developer.amd.com/amd-aocc/

Note : Make sure AOCC compiler binary is sourced in platform path so the extension can find it.

Install the AMD-AOCC-Extension-v-1.0.0

1. Open VS Code.
2. Click the 'Extensions' icon on the Sidebar (Ctrl+Shift+X).
3. Click on 'Views and More Actions' icon (…) which is on the right side, select 'Install from VSIX' option and select the amd-aocc-extension-v-1.0.0.vsix file.
4. Click Install.

Note : If you have missed sourcing the AOCC compiler path before the extension is installed then you can source the path in terminal or in extension settings and you can reload the extension.

Using the AMD-AOCC-Extension-v-1.0.0

Get started with C/C++/Fortran and VS Code with Hello World tutorials for your environment:

Create Hello World

From the terminal window, create an empty folder called projects to store your VS Code projects. Then create a subfolder called helloworld, navigate into it, and open VS Code in that folder by entering the following commands:

mkdir projects; cd projects; mkdir helloworld; cd helloworld; code .

The code . command opens VS Code in the current working folder, which becomes project "workspace". And you will be able to see .vscode folder containing the below file in the workspace.

tasks.json (compiler build settings)

Create helloworld program and save. Eg: helloworld-c.c, helloworld-cpp.cpp, helloworld-f90.f90

Build helloworld program

Click the 'Extensions' icon on the Sidebar (Ctrl+Shift+X) and you will able to view the AMD-AOCC-Extension-v-1.0.0 under enabled menu and click on 'Manage' icon and select 'Extension Settings'.

Under the User tab you can find aocc compiler specific settings, If user changes any settings they can reload the extension

1. Bin path - clang, clang++ and flang

   User can also change the bin path if they have not sourced the path before installing the extension

2. AMD machine architecture platform optimization flag

   User can select specific machine architecture optimization flag

3. Optimization flags – clang, clang++ and flang

   User can provide specific optimization flags separated by space

4. Include path

   User can change the include path if they have not sourced the path before installing the extension

5. Library path

   User can change the library path if they have not sourced the path before installing the extension

Running the build

1. Go back to helloworld-cpp.cpp. Your task builds the active file and you want to build helloworld-cpp.cpp

2. To run the build task defined in tasks.json , press Ctrl+Shift+B or from the 'Terminal' main menu choose 'Run Build Task' and select respective task 'clang++ build active file' and select 'Continue without scanning the task output'. Eg: for .c file clang build active file and for .f90 file flang build active file

3. When the task starts, you should see the Integrated Terminal panel appear below the source code editor. After the task completes, the terminal shows output from the compiler that indicates whether the build succeeded or failed. For a successful clang++ build, the output looks something like this:

Executing task: /home/compiler/aocc-compiler/bin/clang++ -o3 -march=znver2 /home/projects/helloworld/helloworld-cpp.cpp -o /home/projects/helloworld/helloworld-cpp < Terminal will be reused by tasks, press any key to close it. 4. From the 'Terminal' main menu choose 'Run Task' and select task 'Run active file'. Executing task: /home/projects/helloworld/helloworld-cpp < Hello C++ world using VS CODE Terminal will be reused by tasks, press any key to close it.