{"id":7580,"date":"2022-04-13T13:14:43","date_gmt":"2022-04-13T11:14:43","guid":{"rendered":"https:\/\/playembedded.org\/?p=7580"},"modified":"2024-02-04T12:17:32","modified_gmt":"2024-02-04T11:17:32","slug":"chibistudio-overview","status":"publish","type":"post","link":"https:\/\/playembedded.org\/blog\/chibistudio-overview\/","title":{"rendered":"ChibiStudio Overview"},"content":{"rendered":"

Introduction<\/h2>\n\n\n\n

The first time using ChibiStudio can be intimidating for a new user due to a large number of buttons and windows. This article aims to provide a general overview of ChibiStudio as a tool and its overall structure, in order to make it easier for the user to navigate and understand how it can improve their workflow.<\/p>\n\n\n\n

What is ChibiStudio<\/h2>\n\n\n\n

ChibiStudio <\/strong>is a development environment for ChibiOS\/RT<\/strong>, a free and open-source real-time operating system (RTOS<\/strong>). It is based on Eclipse <\/strong>and includes the ChibiOS distribution, tools such as the GCC toolchain for ARM<\/strong> and OpenOCD<\/strong>, and provides a preconfigured environment for developing, debugging and deploying applications.<\/p>\n\n\n\n

It simplifies the process of developing on ChibiOS\/RT by providing a user-friendly interface and allows developers to focus on their application development rather than configuring the environment. <\/p>\n\n\n\n

As it is based on Eclipse, many of the concepts in ChibiStudio are inherited from Eclipse architecture, but this article aims to highlight the most important points.<\/p>\n\n\n\n

TReaders who wish to delve deeper into the topic can refer to the Eclipse documentation<\/a>.<\/p>\n\n\n\n

Workbench and Workspace<\/h2>\n\n\n\n

ChibiStudio is structured into Workbenches<\/strong>, which can be thought of as the main window. Each workbench functions as a “bench” where various programming tools are organized, such as views and editors. These are the individual tools that you can use to navigate, edit and debug code. They can be opened and closed as needed and can be placed anywhere on the workbench as required.<\/p>\n\n\n\n

All the settings, variables, perspectives, history, and imported projects related to the workbench are saved as metadata in a location called the Workspace<\/strong>. The Workspace is a designated area on your computer where Eclipse stores all the configuration information for your development environment. <\/p>\n\n\n\n

By default, the fresh ChibiStudio installation comes with several workspaces: a trunk workspace<\/strong> (located under [ChibiStudio Root]\\workspace_trunk<\/em>), a user workspace<\/strong> (located under [ChibiStudio Root]<\/em>\\workspace_user<\/em>) and several workspaces corresponding to various ChibiOS releases that are coming with ChibiStudio as well as workspaces where different demo project from PLAY Embedded can be found. The user workspace is the default workspace allocated to new users, but additional workspaces can be created at any time to better organize one’s work. <\/p>\n\n\n\n

A key takeaway before moving further:<\/p>\n\n\n\n

\n

The workspace is an actual directory on the file system accessible via Explorer, while workbenches are part of the GUI of ChibiStudio and can only be interacted with while actively using the software.<\/p>\n<\/blockquote>\n\n\n\n

Current workspace<\/h3>\n\n\n\n

As ChibiStudio comes with many workspaces, it is important to understand how to recognize the current workspace. This can be done by looking at the top name bar of Eclipse: it includes information such as the version of ChibiStudio, the version of ChibiOS being used in that workspace, and the path of the workspace.<\/p>\n\n\n\n

\"\"
Where to look for the current workspace location in ChibiStudio<\/figcaption><\/figure>\n\n\n\n

If we open this path in the file explorer, we will notice that a workspace is simply a folder that contains projects and a subfolder named “.metadata” that holds all the settings and information needed by Eclipse.<\/p>\n\n\n

\n
\"\"
A screenshot of a ChibiStudio workspace in Explorer<\/figcaption><\/figure>\n<\/div>\n\n\n

When creating new projects by duplicating the default one, they will be located here. This is the folder that you may want to back up if you decide to update to a new version of ChibiStudio or switch computers.<\/p>\n\n\n\n

Switching between workspaces<\/h3>\n\n\n\n

Switching between workspaces in ChibiStudio can be useful when working on multiple projects or configurations. It allows you to easily switch between different projects or configurations without having to manually close and open different instances of the software. The process for switching between workspaces in ChibiStudio is relatively straightforward and can be done by following these steps:<\/p>\n\n\n\n

    \n
  1. Go to File<\/strong><\/li>\n\n\n\n
  2. Select Switch workspace<\/strong><\/li>\n\n\n\n
  3. Choose one of the folders from the existing list or navigate to a custom location via Other…<\/strong><\/li>\n<\/ol>\n\n\n\n
    \"\"
    How to switch workspace in ChibiStudio<\/figcaption><\/figure>\n\n\n\n

    ChibiStudio will close the current workspace and open the selected one. It’s also worth noting that it is good practice to back up the workspace folder, to avoid losing any important work or configurations.<\/p>\n\n\n\n

    Perspectives<\/h2>\n\n\n\n

    The workbench organization in ChibiStudio can be set, saved and recalled at any time to better assist and optimize the development flow. These setups are known as perspectives<\/strong>. A perspective is a layout of views and editors that is tailored to specific tasks and activities. For example, in ChibiStudio, there is a “Debug” perspective that includes views and tools that are relevant for debugging.<\/p>\n\n\n\n

    Perspectives can be switched using the button located in the top right corner of the Workbench, as highlighted in the figure below. It is also possible to add other perspectives, save or reset the current one to default through the drop-down menu “Window” located in the menu bar. Note that switching perspectives is a matter of organizing one’s view and will not have any impact on the code or files. You can switch perspectives as needed or desired without any concern.<\/p>\n\n\n\n

    The default perspectives that are available at first launch are:<\/p>\n\n\n\n

      \n
    1. C\/C++<\/strong>– designed to facilitate code development<\/li>\n\n\n\n
    2. Debug<\/strong>– which provides quick and easy access to the most used debugging tools<\/li>\n<\/ol>\n\n\n\n
      \"\"
      Toggling perspectives in ChibiStudio<\/figcaption><\/figure>\n\n\n\n

      The two perspectives reflect the way in which the code development process is split. Code editing is only a phase of the whole development process and having successfully compiled code is not enough for a project to be deemed successful. Therefore the development process could be split into two specific parts, corresponding to the two default perspectives.<\/p>\n\n\n\n

      C\/C++ Perspective<\/h3>\n\n\n\n

      The software development process encompasses a wide range of tasks, including creating new projects, editing code, compiling, and resolving errors and warnings. The C\/C++ Perspective<\/strong> in ChibiStudio provides a specialized layout of views and tools that are specifically designed to assist with these tasks. The majority of the screen is dedicated to the code editor, as it is a crucial component for writing and editing code. This perspective is optimized to streamline the development process and make it as efficient and effective as possible.<\/p>\n\n\n\n

      Windows overview<\/h4>\n\n\n\n

      The following figure highlights the visible windows from the C\/C++ Perspective of ChibiStudio:<\/p>\n\n\n\n

        \n
      1. The Project Explorer<\/strong>, located on the left side of the screen, displays all the projects belonging to the currently active workspace, whether they are open or closed. It also allows for easy navigation within an open project’s folders and files. It’s worth noting that the Project Explorer is populated by two dummy projects by default, ChibiOS Tools<\/em> and Documents<\/em>, which contain the documentation and tools used by ChibiStudio and should always be present and opened in the workspace.<\/li>\n\n\n\n
      2. The Text Editor<\/strong>, occupying the majority of the center screen, is where the actual code writing and editing are done.<\/li>\n\n\n\n
      3. The Outline<\/strong>, located on the right side of the screen, provides a blueprint of the structure of the files that are open in the editor area.<\/li>\n\n\n\n
      4. At the bottom of the screen, multiple tabs such as Console <\/strong>or Problems <\/strong>provide information about the build process and highlight syntax warnings and errors as a result. These tools play a crucial role in code syntax validation and help developers quickly identify and fix any issues with their code<\/li>\n<\/ol>\n\n\n
        \n
        \"\"
        A screenshot of the C\/C++ perspective in ChibiStudio<\/figcaption><\/figure>\n<\/div>\n\n\n

        Ribbon bar – basic buttons<\/h4>\n\n\n\n

        The figure below highlights some of the basic and most commonly used buttons in the C\/C++ perspective ribbon of ChibiStudio:<\/p>\n\n\n\n

          \n
        1. The Build <\/strong>button is used to compile the code before it is run.<\/li>\n\n\n\n
        2. The Debug <\/strong>button is useful for testing and deploying the project on a platform. The debug options, also known as Launch Configurations<\/strong>, can be accessed by clicking the black arrow on the right side of the button.<\/li>\n\n\n\n
        3. The External Tools<\/strong> button provides a variety of functionalities necessary before flashing and running the project on a platform. These functionalities can be accessed by clicking the downward-facing black arrow on the right side of the button, instead of clicking the button directly.<\/li>\n<\/ol>\n\n\n
          \n
          \"\"
          The ribbon in the C\/C++ perspective of ChibiStudio<\/figcaption><\/figure>\n<\/div>\n\n\n

          Debug Perspective<\/h3>\n\n\n\n

          Debugging is an essential step in the software development process that involves testing code functionality, identifying unexpected behavior, and evaluating software performance and consistency. The Debug Perspective<\/strong> in ChibiStudio is specifically designed to support these tasks and provides additional windows and tools to explore code, memory, and variables, evaluate expressions, connect to a terminal, and much more. This section provides an overview of the perspective and some of its most commonly used functionalities. For more detailed information on how to debug in ChibiStudio, please refer to the accompanying article<\/a>.<\/p>\n\n\n\n

          Windows overview<\/h4>\n\n\n\n

          The figure below highlights the visible windows in the Debug Perspective of ChibiStudio:<\/p>\n\n\n\n

            \n
          1. The Debug <\/strong>window, located in the upper left corner of the screen, is where the currently active execution session can be tracked.<\/li>\n\n\n\n
          2. The upper right corner of the screen features multiple tabs, each providing a unique utility for debugging code. Some of the most commonly used tabs include:\n