{"id":960,"date":"2020-11-07T21:57:51","date_gmt":"2020-11-07T20:57:51","guid":{"rendered":"https:\/\/next-hack.com\/?p=960"},"modified":"2020-11-08T18:43:29","modified_gmt":"2020-11-08T17:43:29","slug":"setting-up-atmel-studio-for-usvc","status":"publish","type":"post","link":"https:\/\/next-hack.com\/index.php\/2020\/11\/07\/setting-up-atmel-studio-for-usvc\/","title":{"rendered":"Setting up Atmel Studio for uSVC"},"content":{"rendered":"\n

The first steps\u2026<\/strong><\/h3>\n\n\n\n

Instead of discussing and explaining a lot of functions, our opinion is that starting with a step-by-step example is the best way to get into uSVC programming. In the last news, we provided you with a template project<\/a>, which already has the kernel library and essential files, as well as the compiler settings and linker script. In this way, you don\u2019t have to do all the tedious settings, each time, from scratch. The experienced developers are also encouraged to analyze the project to already understand how it works (beginners: we will explain it later!), and the different debug and release settings, with particular emphasis on the linker script.<\/p>\n\n\n\n

However, before we start coding, we need to setup everything, and in particular our main development tool for uSVC: Atmel Studio 7.<\/p>\n\n\n\n

Installing uChip Drivers<\/strong><\/h3>\n\n\n\n

If you use Windows 10, no drivers are required.<\/p>\n\n\n\n

Otherwise:<\/p>\n\n\n\n

  1. Download the latest uChip package from here https:\/\/github.com\/ITACAInnovation\/uChip<\/a><\/li>
  2. Unzip the file somewhere.<\/li>
  3. In the drivers\/ subfolder find and execute uchip_driver_installer.exe<\/li><\/ol>\n\n\n\n

    Please note, that some antivirus might recognize uchip_driver_installer.exe as a virus, due to their too much sensitive heuristic configuration. This is of course a false positive!<\/p>\n\n\n\n

    Setting up Atmel Studio<\/strong><\/h3>\n\n\n\n

    After you download and install Atmel Studio from Microchip\u2019s website, you should download and install BOSSA 1.91 or later from here: https:\/\/github.com\/shumatech\/BOSSA\/releases<\/a> (e.g. https:\/\/github.com\/shumatech\/BOSSA\/releases\/download\/1.9.1\/bossa-x86-1.9.1.msi<\/a>). After installation, you should integrate it for uSVC programming. Here is how to do it:<\/p>\n\n\n\n

    1. Find the directory of where \u201cBossac.exe\u201d has been installed. If you have installed the x86 version (32-bit version), then bossac.exe should be (by default) in \u201cC:\\Program Files (x86)\\BOSSA\\bossac.exe\u201d. Instead if the x64 version (64-bit version) has been installed, then BOSSAc will be in \u201cC:\\Program Files\\BOSSA\\bossac.exe\u201d. Note this directory down.<\/li>
    2. Open Atmel Studio, go to menu  \u201cTools\u201d and select \u201cExternal Tools\u201d. A window like that one below should appear:<\/li><\/ol>\n\n\n\n
      \n\n\n\n
      \"\"<\/figure><\/div>\n\n\n\n
      \n\n\n\n
      1. Click on Add. On \u201cTitle\u201d choose something meaningful. For instance \u201cuSVC Debug Upload\u201d.<\/li>
      2. On Command, put the directory on which you found bossac.exe. In our case \u201cC:\\Program Files (x86)\\BOSSA\\bossac.exe\u201d.<\/li>
      3. On Arguments, put:<\/li><\/ol>\n\n\n\n

        -d -i -e -w  -o 0x2000 -R \"$(ProjectDir)\\Debug\\$(TargetName).bin\"<\/code><\/p>\n\n\n\n

        Warning! It is extremely important to specify \u2013o 0x2000<\/code>, otherwise you might corrupt the bootloader!<\/strong><\/p>\n\n\n\n

        The window should now look like this one:<\/p>\n\n\n\n

        \n\n\n\n
        \"\"<\/figure><\/div>\n\n\n\n
        \n\n\n\n
        1. Finally, press “OK”.<\/li><\/ol>\n\n\n\n

          A new entry, named \u201cUSVC Debug UPLOAD\u201d should appear on the menu \u201cTools\u201d. This entry will be used to test the games. What about creating game packages to be put in the SD? Well, this is for another tutorial!<\/p>\n\n\n\n

          Uploading games in debug mode to uSVC<\/strong><\/h3>\n\n\n\n

          Throughout the next tutorials, we will ask you several times to \u201cupload the game to uSVC in debug mode\u201d. Here is how to do this.<\/p>\n\n\n\n

          In uSVC, games are typically loaded from the SD card. This would require you to create a game package (as we will discuss in a future tutorial) and put them in the SD, which is a rather long sequence of operations.<\/p>\n\n\n\n

          However, if you are just programming your own game, a much faster way to test your code is to upload directly the game to uChip. Warning: this will overwrite the uSVC game loader! You can restore it later by opening the uSVC_Game_Loader project and using the same upload procedure.<\/p>\n\n\n\n

          To upload the game in debug mode:<\/p>\n\n\n\n