Longan NanoがPlatformIOで使えなくなっているので、なんとかする話

Last updated at 2026-04-27Posted at 2024-09-13

【2026年1月26日更新】

本記事で紹介していたSourceForge上のファイルにアクセスできなくなっていることを確認したため、取得先をSipeedのMEGAリンクに変更しました。

はじめに

秋月で購入した Sipeed Longan Nano を使ってみようと意気込んでいたのですが、Sipeed公式サイトで紹介されている PlatformIOを利用した開発環境の構築がうまく動かないことに気づきました…。

調べてみたところ、2023年7月頃からPlatformIO 向けの必要ファイルの配信が停止されており、公式の手順通りでは環境構築ができない状態になっているようです。

ただし、必要なファイルを別途入手して手動で導入すれば、PlatformIO上での開発は可能です。本記事では、その具体的な導入方法について解説します。

必要なもの

Sipeed Longan Nano本体
USB Type-Cケーブル
Windows PC（windows10/11）

VSCodeとPlatformIOのインストール

※すでに導入済みの方は、この章はスキップしてください。

まずは、Visual Studio Codeをインストールします。

インストール後に VSCode を起動し、左側の「拡張機能」タブを開きます。

検索欄に「PlatformIO」と入力し、表示された「PlatformIO IDE」をインストールしてください。インストールには少し時間がかかります。

完了すると、左側に虫のアイコンが追加されます。

新しいプロジェクトの作成

次に、PlatformIO のホーム画面から「+ New Project」をクリックします。

Name：任意（例：longan-blink）
Board / Framework：あとで変更するので仮でOKです
- Board：Arduino Uno
- Framework：Arduino

設定後、「Finish」を押してプロジェクトを作成します。

必要ファイルのダウンロード

現在、PlatformIO が参照している公式のダウンロード先が利用できないため、開発に必要なファイルを手動で取得し、配置する必要があります。

以下は Sipeed の公式サイトに掲載されているリンクですが、ファイルのダウンロードは自己責任で行ってください。

まず、Sipeed の公式サイトに掲載されている MEGA のリンクにアクセスします。
https://dl.sipeed.com/shareURL/LONGAN/Nano/Tools

MEGA を開いたら、以下の順にフォルダを移動してください。
「LONGAN」→「platformio」→「dl-packages」

このフォルダ内にある、次の4つのファイルをダウンロードします。

framework-gd32vf103-sdk-v1.0.0.tar.gz
tool-gd32vflash-v0.1.0-win.tar.gz
tool-openocd-gd32v-v0.1.1-win.tar.gz
toolchain-gd32v-v9.2.0-win.tar.gz

ダウンロードが完了したら、それぞれのファイルを解凍してください。

フォルダ配置

解凍した4つのフォルダを、さきほど作成したプロジェクトのフォルダ内に移動させます。

プロジェクトフォルダはデフォルトであれば、次のパスにあるはずです。
C:\Users\ユーザー名\Documents\PlatformIO\Projects\プロジェクト名

プロジェクトフォルダ内に「packages」という名前のフォルダを新しく作成し、解凍した4つのフォルダを中に移動します。

現時点でフォルダ構成は以下のようになっているはずです。

├─.pio
│  └─build
├─.vscode
├─include
├─lib
├─packages
│  ├─framework-gd32vf103-sdk-v1.0.0
│  ├─tool-gd32vflash-v0.1.0-win
│  ├─tool-openocd-gd32v-v0.1.1-win
│  └─toolchain-gd32v-v9.2.0-win
├─src
└─test

`platformio.ini`の編集

VSCodeでplatformio.iniを開き、以下のように書き換えます。
platform_packagesで、先ほど配置したフォルダのパスを指定しています。

[env:sipeed-longan-nano]
platform = https://github.com/sipeed/platform-gd32v.git
board = sipeed-longan-nano
framework = gd32vf103-sdk
platform_packages = framework-gd32vf103-sdk @ file://packages/framework-gd32vf103-sdk-v1.0.0
                    toolchain-gd32v @ file://packages/tool-gd32vflash-v0.1.0-win
                    tool-openocd-gd32v @ file://packages/tool-openocd-gd32v-v0.1.1-win
                    tool-gd32vflash @ file://packages/toolchain-gd32v-v9.2.0-win
upload_protocol = dfu

Lチカプログラムの作成

次に、src/main.cを開き、以下のLチカ用プログラムに書き換えます。
もしmain.cppになっている場合は、main.cに変更してください。

#include "gd32vf103.h"
#include <stdio.h>

/* BUILTIN LED OF LONGAN BOARDS IS PIN PC13 */
#define LED_PIN GPIO_PIN_13
#define LED_GPIO_PORT GPIOC
#define LED_GPIO_CLK RCU_GPIOC

void delay_1ms(uint32_t count)
{
  uint64_t start_mtime, delta_mtime;

  // Don't start measuruing until we see an mtime tick
  uint64_t tmp = get_timer_value();
  do
  {
    start_mtime = get_timer_value();
  } while (start_mtime == tmp);

  do
  {
    delta_mtime = get_timer_value() - start_mtime;
  } while (delta_mtime < (SystemCoreClock / 4000.0 * count));
}

void longan_led_init()
{
  /* enable the led clock */
  rcu_periph_clock_enable(LED_GPIO_CLK);
  /* configure led GPIO port */
  gpio_init(LED_GPIO_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, LED_PIN);

  GPIO_BC(LED_GPIO_PORT) = LED_PIN;
}

void longan_led_on()
{
  /*
   * LED is hardwired with 3.3V on the anode, we control the cathode
   * (negative side) so we need to use reversed logic: bit clear is on.
   */
  GPIO_BC(LED_GPIO_PORT) = LED_PIN;
}

void longan_led_off()
{
  GPIO_BOP(LED_GPIO_PORT) = LED_PIN;
}
/*!
    \brief      main function
    \param[in]  none
    \param[out] none
    \retval     none
*/
int main(void)
{
  longan_led_init();

  while (1)
  {
    /* turn on builtin led */
    longan_led_on();
    delay_1ms(1000);
    /* turn off uiltin led */
    longan_led_off();
    delay_1ms(1000);
  }
}