Get Started with the Notecard and Cellular IoT on June 8th !

Blues Developers
Search
Documentation Results
End of results
Community Results
End of results
What’s New
Blues.io
Notehub.io
Shop
Sign In
What’s New
Blues.io
Notehub.io
Shop
×
HomeSwan
Introduction to Swan
Swan QuickstartSwan Datasheet
Using STM32CubeIDE with Swan
Using Arduino IDE with Swan
Using CircuitPython with Swan
Recovering the STM32L4R5

Using the Arduino IDE with Swan

Installation Prerequisites

  1. Download and install STM32CubeIDE and STM32CubeProgrammer if you don't already have them installed. Be sure to follow these installation notes when installing STM32CubeProgrammer.
Linux only setup required for accessing the device in DFU mode and virtual COM port.
  1. Create a /etc/udev/rules.d/ rule for the device in DFU mode.

    (echo '# DFU (Internal bootloader for STM32 MCUs)';  echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE="0664", GROUP="plugdev"') | sudo tee /etc/udev/rules.d/49-stdfu-permissions.rules > /dev/null
  2. Create a /etc/udev/rules.d/ rule for the device's virtual COM port.

    (echo '# Virtual COM Port for STM32 MCUs'; echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", MODE="0664", GROUP="plugdev"') | sudo tee /etc/udev/rules.d/49-stvcp-permissions.rules > /dev/null
  3. Add active user to plugdev group in /etc/group.

    sudo usermod -aG plugdev $USER

Installing STM32duino in the Arduino IDE

  1. Add the following URL to the Additional Boards URL in Preferences: https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json

    Update ArduinoIDE preferences

  2. After restarting Arduino, go to the Tools > Boards > Boards Manager... menu option, search for "STM32 MCU based boards", and install version 2.1.0 or greater.

  3. Restart Arduino.

Using STM32duino in the Arduino IDE

  1. Under Tools > Board, select "STM32 Boards groups", and then "Blues Wireless boards."

    Select STM32 Board

  2. Next, under Tools > Board Part Number, select "Swan R5."

    Select STM32 Board Part

  3. Lastly, under Tools > USB support (if available), select "CDC (generic 'Serial' supersede U(S)ART)."

Programming Swan with Arduino IDE

To program Swan in the Arduino IDE, you can use a programmer like the STLINK-V3MINI or program via a USB cable connected to your computer.

Programming Swan with the STLink-V3Mini (Recommended)

  1. Under Tools > Upload method, select "STM32CubeProgrammer (SWD)."

  2. Plug the STLink-V3Mini into your computer over USB.

  3. Plug the Swan into a power source (e.g. a LiPo battery or your computer via USB to use the serial monitor).

  4. Plug the Cortex-Debug connector from the STLink-V3Mini into the Swan.

    swan to stlink

  5. Skip to the Blink the Onboard LED instructions below.

Programming Swan without the STLink-V3Mini

  1. Under Tools > Upload method, select "STM32CubeProgrammer (DFU)."

  2. Connect the Swan's Micro USB port to your computer with a USB cable.

    swan micro usb

  3. Press and hold the BOOT button on the Swan, press and release RESET, then release BOOT to cause the Swan to jump into its bootloader. This sequence must be done every time you want to upload firmware to the Swan.

  4. Proceed to the Blink the Onboard LED instructions below.

Blink the Onboard LED

  1. In the Arduino IDE, use File > New to create a new sketch.

  2. Overwrite the provided boilerplate code with the following to cause the onboard LED to blink repeatedly:

    // the setup function runs once when you press reset or power the board
    void setup() {
      // initialize digital pin LED_BUILTIN as an output.
      pinMode(LED_BUILTIN, OUTPUT);
    }
    
    // the loop function runs over and over again forever
    void loop() {
      digitalWrite(LED_BUILTIN, HIGH);   // turn the LED on (HIGH is the voltage level)
      delay(1000);                       // wait for a second
      digitalWrite(LED_BUILTIN, LOW);    // turn the LED off by making the voltage LOW
      delay(1000);                       // wait for a second
    }
  3. Upload this sketch to the Swan.

Can we improve this page? Send us feedback
© 2023 Blues Inc.Terms & ConditionsPrivacy
blues.ioTwitterLinkedInGitHubHackster.io
Disconnected
Notecard Disconnected
Having trouble connecting?

Try changing your Micro USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Advanced Usage

The help command gives more info.

Connect a Notecard
Use USB to connect and start issuing requests from the browser.
Try Notecard Simulator
Experiment with Notecard's latest firmware on a Simulator assigned to your free Notehub account.

Don't have an account? Sign up