GNU Tools | User Guide© 2015-2017 CyberTHOR Studios Ltd. All Rights Reserved.

GNU Tools | User Guide
A user’s guide to using the GNU Tools website
by CyberTHOR Studios Ltd.

This manual is a user’s guide to using the GNU Tools website. It includes visual examples of
all functionality throughout the site and provides insights into various topics not covered byregular navigation.

ii

Contents

1

General Overview

1.1
1.2
1.3

1.4

2

2.2

2.3

1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.1.1 Finding User Information . . . . . . . . . . . . . . . . . . . . . .
2.1.2 Personalizing Your Avatar . . . . . . . . . . . . . . . . . . . . . .
2.1.3 Understanding statistics . . . . . . . . . . . . . . . . . . . . . . .
Submitting Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2.1 Responding to queries . . . . . . . . . . . . . . . . . . . . . . . .
2.2.2 Following topics of interest . . . . . . . . . . . . . . . . . . . . .
2.2.3 Following activity of users . . . . . . . . . . . . . . . . . . . . .
Commenting On Responses . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.1 Voting responses . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.2 Flagging questions . . . . . . . . . . . . . . . . . . . . . . . . . .

Support Requests

3.1
3.2

3.3
4

Accessing The Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Accessing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Registration Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.1 Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3.2 Logging Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Changing Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.4.1 Switching between languages . . . . . . . . . . . . . . . . . . . . 10

Discussion Forum

2.1

3

2

1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Opening a Ticket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.1 Responding To Tickets . . . . . . . . . . . . . . . . . . . . . . . .
3.2.2 Closing a ticket . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing and searching tickets . . . . . . . . . . . . . . . . . . . . . . . .

Toolchains

4.1
4.2
4.3
4.4

2
7
9
11
12
15
17
18
19
20
20

2
3
5
7
8
1

GNU Renesas toolchains use the GPL License . . . . . . . . . . . . . .
Activation code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Toolchain installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Toolchain integration in e2studio IDE . . . . . . . . . . . . . . . . . . .

iii

1
2
3
9

Chapter 1

Chapter 1

1 General Overview

Welcome to the GNU Tools website!
This User Guide has been created keeping in mind the regular user for the website,
and tries to describe the various use-case scenarios that the website may be used for.

2

1.1 Accessing The Website
The website may be currently accessed at the following URL: https://gccrenesas.com/

The website uses SSL throughout its entire domain, and all HTTP requests aretransferred through HTTPS, for permanent encrypted traffic and enhanced log-in
security.

3

Chapter 1

1 General Overview

1.2 Accessing Content
Accessing content throughout the website may be done in multiple ways. Latest
news/posts/updates will always be visible in the front-page:

There are two menus which facilitate access to the website’s functionality andfeatures. The primary menu is the one at the top of the page and contains the mostcommon links and topics of interest for visitors:

The second menu is the one just below the primary menu above, and contains
a more detailed layout structure of the website, including links to various content
which is not accessible from the primary menu:

4

Chapter 1

1 General Overview

1.3 Registration Process
The registration process for the website becomes mandatory whenever a visitor
would like to either:• post comments to any page;• ask questions, vote up or down, add comments to the discussion forum;• submit support requests through the Support area.
For example, to be able to download the latest version of the GCC for Renesas,
here is how the page would look like:• Active targets: refers to up-to-date toolchain versions.
• Legacy Targets: refers to the availability of older toolchain versions.
• Download: to download the latest toolchain version available for Windows.
If they attempt to log in, they will be prompted with the log in screen.

5

Chapter 1

1 General Overview

1.3.1 Logging In

If they attempt to log in, they will be prompted with the log in screen.

If the visitor does not have an account, they can click the Register link in the log
in screen (see picture above) and they will be able to subscribe to our system:

6

Chapter 1

1 General Overview

Registration requires the following data to be entered: an adequate usernamechosen by the user, an e-mail to use throughout the website, a password, somecontact details such as: the user’s telephone number, personal address, country ofresidence, company name, company address, company telephone number, company
URL, company position.
Some technical details: host operating system, target OS, ‘if’ other target OS, target
hardware and the purpose of the registration: application domain, the purposeof using CyberTHOR GNU Tools (for example non-commercial use, commercial
product-development).
To complete the registration process please agree, by checking the I agree to bebound by this website’s Terms of Use box and insert the random generated code andclick on the Register button.
The username is the one they will use when logging in to the site in the future.
Once they complete the registration, they will receive an email with a confirmation
link, to create a password and activate their account.

7

Chapter 1

1 General Overview

You should receive an e-mail in the following format:

After the activation, you will receive an email with your contact details:

Once the user has logged in, they will be taken to the website again, however thistime a permanent menu will appear at the top of the website, granting them accessto various features only available to registered users:

8

Chapter 1

1 General Overview

1.3.2 Logging Out

Logging out of the website can be easily done by accessing the top right menu of
the site (after logging in) and choosing the Log Out option:

1.4 Changing Language
The site has been designed and built to support multiple languages. At thismoment, English and Japanese are the only two languages which have been added
into the system (however, more languages can be easily supported, should they beneeded).
To change the language, once can proceed in various way:
• choose the adequate language from the primary menu of the site, right at the
top of the page:• choose the language from the navigational menu to the right side of thescreen (only available on certain pages, usually those containing content or
information):

9

Chapter 1

1 General Overview

1.4.1 Switching between languages

Switching between languages allows the visitors to view the appropriate content intheir native language. For example, switching to Japanese (see Changing Language)
will display all relevant content in Japanese:

10

Chapter 1

1 General Overview

Chapter 2

The discussion forum is a place where registered users may post questions,
may read about other user’s issues and potentially respond to them, or may offer
assistance with the responses provided by other people (through a built-in voting
system).

1

Chapter 2

2 Discussion Forum2 Discussion Forum

2.1 Overview• About Our Support (here you find information about our response timedepending on the reported problem: bugs, bug fix);• New Support Query (for technical support, you may open a new support
ticket, providing some information about the type of the issue);• My Support Requests (here you can manage your support requests, checktheir status);• Forum (for technical discussions and general questions);• if the user wishes to see all questions in the discussion forum, not pertaining
to any specific category, they can choose the Forum option in the SUPPORT
menu (part of the secondary menu) which contains:– Ask A Question;– View All Topics;– View All Questions;– Topics.

2

Chapter 2

The discussion forum is accessible in various ways, depending on the topics ofinterest to the user. The SUPPORT menu contains the following options:2 Discussion ForumSUPPORT - Forum
Ask A Question. There are two ways to submit a query.
Chapter 2

1. Directly from the SUPPORT - Forum - Ask A Question;

2. By clicking red Ask question button, while in one of the Topics. This canonly be done while in one of the Topics (General, Toolchain Support, Binutils
Support and so on).

3

2 Discussion ForumSUPPORT - Forum - View All Topics

Chapter 2User can access each category for a more filtered approach to discussions on
the Forum.

By selecting a category user will be accessing the section seen in the print screen
below:

4

2 Discussion Forum

Chapter 2

Additionally, once in the discussion forum, you can choose to sort the content
based on category by clicking the Sort by button: SUPPORT - Forum - Topics General - Sort by.

There are two ways of reaching the different categories:
1. Support - Forum - Topics - General - Category;

2. The Forum option also acts as a sub-menu for the different categories ofinterest to the users, in which case the user may simply choose to view only aspecific topic of the discussion forum, by choosing it from the sub-menu thatappears:5

2 Discussion Forum

Chapter 2

SUPPORT - Forum - View All Questions

6

2 Discussion Forum
2.1.1 Finding User Information

Chapter 2

To find information about the registered users who post questions, answers orcomments in the forum, simply hover your mouse over their avatar:

Additional information may be found by clicking the small image avatar of thatcertain user:

In the About area (above), you can observe various statistics about the user’s
reputation and statistics. A user’s reputation is computed based on his performancein the forum - reputation increases with the following activities of that registereduser:• if the user has a lot of valid responses (responses which receive many thumbsup);• if the user has responded correctly to numerous questions;• if the user has a lot of activity on the forum.

7

2 Discussion Forum

Chapter 2

By the same logic, a user’s reputation will drop if they perform the opposite actionsof those which are accounted for increasing the reputation.
In the same page, you can find information about how the user’s reputation wasachieved, with detailed analysis, by clicking Reputation:

The list of questions that the user has posted is available in the Questions area:

8

2 Discussion Forum

Chapter 2

The list of questions that the user has posted is available in the Questions area:

2.1.2 Personalizing Your Avatar

Personalizing a user’s avatar is easy. First, you need to be registered on the siteand logged in. After that, you need to open the profile page of your own user (seeFinding User Information):

To personalize your avatar’s image, click the upload button to the left of the circle:

9

2 Discussion Forum

Chapter 2

After you do so, your avatar will become available:

You can also personalize the background of your profile page, by clicking the
upload button to the top left of your background image:The different statistics are explained in the Understanding Statistics topic.
This shows the list of your active subscriptions (topics of interest):

10

2 Discussion Forum

Chapter 2

2.1.3 Understanding statistics

Each question that a user posts has various details which are relevant to analyse:• clarity/relevance of question (through the thumbs up/down voting system);• usefulness of the topic;• capacity to reproduce the same issue by one or more users (through the voting& commenting system);• last time the user who had posted the question was online (through the Active
row in the Question stats information box);• the interest in the topic (through the Views row in the Question stats informationbox);• the number of answers offered by other registered users (through the Answers
row in the Question stats information box);• express interest in the topic discussed (through the Followers row in the Question stats information box);

11

2 Discussion Forum

2.2 Submitting QueriesThis will allow them to enter the details of the question. If the user is not logged
in, they will see a page asking them to log in:

Otherwise, if the user is already logged in, the following page will appear:

The user can choose a title for the question, a category for the forum in whichto place the question, a description of the problem/issue (editable in a WYSIWYG
manner), and can also choose to make the question visible to the admin/moderator
only (private question). Private questions are not visible to the public, only to theuser that has initially posted the question and to the site administrator/ moderator
team. Once ready to post the question, user can click Post question and the question
will be listed.

12

Chapter 2

Submitting queries in the forum is simple. After accessing the forum page (seeOverview), the user can click the SUPPORT - Forum - Ask question button to ask
a new question.

2 Discussion Forum

Chapter 2

After submitting the question, the new question posted will appear in its own
dedicated page:In this page, the user can perform various tasks. In the picture above, the JohnDoe
user has posted a private question, which is also detailed in a small grey box justbelow the question itself. The user can change the status of the question, from
Private to Open (public) by clicking the Status link, which will show the following
menu:

13

2 Discussion Forum

Chapter 2

Marking question as Open will cause the display to change and the user to be
notified of the change:

14

2 Discussion Forum
2.2.1 Responding to queries

Chapter 2

Responding to queries is only possible to registered and logged in users. To
respond to a certain question, user needs to click the question in the Forum and asimilar page to the following will appear:

The list of answers/comments made by the other registered users will be available
here. At the end of the page, there will be an option to post a response as well:15

2 Discussion Forum

Chapter 2

To answer, simply write the text in the edit field provided (and mark the answer asprivate, if it is only for the administrator/moderator to see), then click Post answer.
After posting, the list will be updated automatically with the answer:

16

2 Discussion Forum
2.2.2 Following topics of interest

To follow a question/topic of interest in the forum, click the Follow question linkin the question page:

After following the topic, each comment/answer posted to this question will besent in a notification email to the registered user’s email address (the one used toregister on the site):This allows users to be able to get instant notifications of all updates to the topics
of interest for them.

17

Chapter 2

Following topics of interest is easy, however only available to registered users,
after logging in. If the user is not logged in, an appropriate message telling themthat they need to log in will be displayed in the site.

2 Discussion Forum
2.2.3 Following activity of users

Chapter 2

To follow all the activity that a user performs in the discussion forum, open theuser’s profile thumbnail (see Finding User Information):and click the Follow button that appears:

From this point forward, the user will be notified by e-mail of all activity that theuser followed performs.

18

2 Discussion Forum

2.3 Commenting On Responses

Chapter 2

Commenting on a question or on an answer can be done directly from the pageof the question, by clicking the Comment button:

A popup will open, allowing the user to enter their comment:

After they enter it in the edit field provided, after clicking Comment the comment
will immediately be visible:

If the comment is awaiting moderation (depending on the topics of interest), it
will only become available to all other registered users to the forum after being
approved by a moderator).

19

2 Discussion Forum

Voting responses allows registered users to express their opinions on other people’s suggestions or answers to the issues raised by other community members.
This can be accomplished directly from the question page, by clicking the thumbs
up/down buttons accordingly:

After voting, the vote becomes instantly visible to all other community members
and site visitors:

2.3.2 Flagging questions

Flagging questions is a useful method for drawing attention to the site administrator/moderators of any inappropriate or irrelevant content posted in the forum.
Flagging may be done directly from the question page, by registered users only, by
clicking the ... (More action) button:

In the menu that appears, click the Flag option, after which a confirmation
message will appear:

20

Chapter 2

2.3.1 Voting responses

Chapter 3

Support requests are a good way to ask for assistance from the site administrators/moderators, without exposing your code/issue to the wide public. Althougha similar functionality is provided in the forum, the purpose of having separate
support requests is to allow the user to track down the progress of the issue intimately and observe the various stages it goes through as it is being addressed by
the administrators/moderators.
Only registered users may issue support requests.
There are two ways to issue support requests:• the easiest way is to click the Support button, which is permanently visible
throughout the website in the top right corner:• the second approach is to select the My Support Requests option from the
SUPPORT menu in the secondary menu of the site:

1

Chapter 3

3 Support Requests

3 Support Requests

3.1 Overview
After opening the support request area, the user will be able to see a dashboard
where they can:• open a new ticket;

Chapter 3• view list of open tickets.

All ticket-pertaining operations (opening, closing, responding to tickets) are
implying an instant e-mail notification of the user in question. This ensures that
registered users receive feedback in real-time, as their raised issues are being
addressed.

2

3 Support Requests

3.2 Opening a Ticket

This will show a new window, where you should enter the details of the ticket:

3

Chapter 3

To open a new ticket, click the Open Ticket button in the My Support Requests
area of the site:3 Support Requests
The following information is required:• the email of the user submitting the ticket (will be automatically populatedwith the email of the registered user);• a name of the user submitting the query (required; it is not the same as theusername in the Registration Process);• the department to which this ticket is addressed to;• a summary of the issue;• any relevant attachments for the ticket (various file types are supported, andthese are fully configurable in the administrator backend; file sizes of up to 256
MB are acceptable, but this is also configurable in the administrator backend);• to add more files when uploading content, just click the Add More File button.
Once the user has finished writing the relevant information, they must press theSave Ticket button to create the ticket. The ticket will become immediately available
in the list of open tickets for that user.

4

Chapter 3• the priority of the ticket (Low/Normal/High/Urgent) a subject of the ticket;

3 Support Requests
3.2.1 Responding To Tickets

To respond to a ticket, click the subject line of that ticket:

Chapter 3This will show a window where you can see the entire feedback for your ticket:

53 Support Requests

Chapter 3

At the bottom of the page for that ticket, there is the reply option:

Replies can also contain attachments. To close the ticket after replying, check the
Close on reply box accordingly, then click Post Reply.

6

3 Support Requests
3.2.2 Closing a ticket

Closing a ticket can be done in two ways:• by closing the ticket with a reply (see Responding To Tickets);• by closing the ticket directly from the list of tickets open.

Next, in the ticket window, click the Close Ticket option to the right of the ticket
status:After closing the ticket, it will be visible in the Closed tickets area of the My
Support Requests page:

7

Chapter 3

To close a ticket directly without replying, first click the ticket’s subject line inquestion:3 Support Requests

3.3 Viewing and searching tickets

This will open up a window similar to the following:This page allows the user to quickly access the open tickets (Open), the closed
ones (Closed), those which have been answered already (Answered), or all tickets inthe system (My Tickets).

8

Chapter 3

The list of tickets may be access by clicking the My Tickets button in the My
Support Requests area of the site:3 Support Requests

Chapter 3

Each ticket may be sorted by subject (Subject column), priority (Priority column),
ticket ID (Ticket ID column), answer status (Status column) and time of submission(Created column). Additionally, it shows the current status of the tickets:

To search tickets by ticket ID, subject, email or subject, use the search feature at
the top:If you click the + button to expand the contents, you will be able to perform
advanced searches (based on ticket ID, from/email fields, department, priority,
subject, starting and ending dates):

To reset the search form, click the Reset button. To begin the search and list all
relevant tickets, click Search.

9Chapter 44 Toolchains

4.1 GNU Renesas toolchains use the GPL License
GNU Tools, GNU toolchains for Renesas microcontrollers are free, user-friendly
products and they use the GNU General Public License (GPL).
For more information about the GPL license terms, please click on the links below:• GNU General Public License version 3:

https://opensource.org/

licenses/GPL-3.0• FAQ: https://www.gnu.org/licenses/gpl-faq.html

Terms of Use of GNU Tools website
At registration please read carefully the website’s (gcc-renesas.com) Terms of Use:
https://gcc-renesas.com/privacy-policy/

1

Chapter 4• Licenses: https://www.gnu.org/licenses/licenses.en.html

4 Toolchains

4.2 Activation code
You may find the toolchain activation code at GNU Tools - Dashboard.

Here you can find the new and the legacy activation code in order to install thetoolchains. If the new activation code does not work, then please use the legacy one
to install the toolchains or contact us.
For more information about the activation code, you may find the FAQ section at
gcc-renesas.com: Help - FAQ, https://gcc-renesas.com/help/faq/.

2

Chapter 4

Note: Please be sure you are logged in, otherwise log in at: https://gcc-renesas.
com/wp-login.php.

4 Toolchains

4.3 Toolchain installation
Download the toolchains from: gcc-renesas.com

The toolchains are available for Windows and Linux OS.
Download the latest RX Windows Toolchain: GCC for Renesas 4.8.4.201701GNURX Toolchain
Note: you can also download some older legacy toolchains too: Products - RX Download toolchains - Legacy toolchains.
Install the toolchain:

3

Chapter 4

To download the latest toolchains, for example the latest RX toolchains, go to:
Products - RX - Download toolchains - Latest toolchains.

4 ToolchainsIf you are not a registered user, please click on the Register button:

Chapter 4

If you are a registered user, check the “I am a registered user” checkbox.

Introduce your authentication information:44 Toolchains
Read and accept the Terms of Use:

Chapter 4

Select the toolchain’s installation location:

You may select the components you want to install:5

4 Toolchains
Select Start Menu Folder:

Chapter 4

Ready to install:

Installing. . .

6

4 Toolchains
Here you can find the toolchain’s Release Notes:

Chapter 4

After the toolchain’s installation:

7

4 Toolchains

Chapter 4

After the toolchain’s installation go to the Start Menu and checkout the installed
components:

8

4 Toolchains

4.4 Toolchain integration in e2studio IDE

To create a simple new project in e2studio, go to: Help - Cheat Sheets - e2studiodevelopment - Create project using GCC Compiler - GCC Compiler for RX andfollow the project generation steps.

9

Chapter 4

In the screenshot below, there are two newly installed toolchains which can be
integrated in e2studio.