This repository contains the Arduino BSP for the Circuitrocks Alora boards:

• Circuitrocks Alora ISP4520

This BSP is based on the Adafruit_nRF52_Arduino and adapted for the ISP4520 from Insight SIP.

The main reason why the orignal BSP from Adafruit cannot be used is because of the integrated Semtech SX1262/1 LoRa transceiver chip that occupies some GPIOs that are not available. It was as well necessary to integrated a matching library for the Semtech SX1262 LoRa chip.

The Circuitrocks Alora ISP4520 board is based on the ISP4520 from Insight SIP, an SOC that integrates a Nordic nRF52832 and a Semtech SX1262/1 LoRa transceiver.

There are two methods that you can use to install this BSP. We highly recommend the first option unless you wish to participate in active development of this codebase via Github.

1. Download and install the Arduino IDE (At least v1.6.12)
2. Start the Arduino IDE
3. Go into Preferences
4. Add https://beegee-tokyo.github.io/package_circuitrocks_index.json as an 'Additional Board Manager URL'
5. Restart the Arduino IDE
6. Open the Boards Manager from the Tools -> Board menu and install 'Circuitrocks Alora by Circuitrocks'
7. Once the BSP is installed, select 'Circuitrocks Alora ISP4520 Feather' from the Tools -> Board menu, which will update your system config to use the right compiler and settings for the ISP4520.

1. Install BSP via Board Manager as above to install compiler & tools.
2. Delete the core folder nrf52 installed by Board Manager in Adruino15, depending on your OS. It could be

• macOS : ~/Library/Arduino15/packages/circuitrocks/hardware/nrf52
• Linux : ~/.arduino15/packages/circuitrocks/hardware/nrf52
• Windows: %APPDATA%\Local\Arduino15\packages\circuitrocks\hardware\nrf52

3. cd <SKETCHBOOK>, where <SKETCHBOOK> is your Arduino Sketch folder:

• macOS : ~/Documents/Arduino
• Linux : ~/Arduino
• Windows: ~/Documents/Arduino

4. Create a folder named hardware/circuitrocks, if it does not exist, and change directories to it
5. Clone this repo: git clone https://github.com/beegee-tokyo/Circuitrocks_ISP4520_Arduino.git
6. Restart the Arduino IDE
7. Once the BSP is installed, select 'Circuitrocks Alora ISP4520 Feather' from the Tools -> Board menu, which will update your system config to use the right compiler and settings for the ISP4520.

adafruit-nrfutil (derived from Nordic pc-nrfutil) is needed to upload sketch via serial port.

• For Windows and macOS, pre-built executable binaries are included in the BSP at tools/adafruit-nrfutil/. It should work out of the box.

• Linux user need to run follow command to install it from PyPi

  $ pip3 install adafruit-nrfutil --user
  

• SiLabs CP2104 driver is required for USB to Serial when using with Feather nRF52832

Bluefruit's Bootloader is self-upgradable, you could upgrade to the latest Bootloader + Softdevice using the serial port within Arduino IDE.

• Select Tools > Board > Circuitrocks Alora ISP4520 Feather
• Select Tools > Programmer > Bootloader DFU for Circuitrocks Alora ISP4520
• Select Tools > Burn Bootloader
• WAIT until the process complete ~30 seconds

Note: close the Serial Monitor before you click "Burn Bootloader". Afterwards, you shouldn't close the Arduino IDE, unplug the Feather, launch Serial Monitor etc ... to abort the process. There is a high chance it will brick your device! Do this with care and caution.

To burn the bootloader from within the Arduino IDE, you will need the following tools installed on your system and available in the system path:

• Segger JLink Software and Documentation Pack
• Nordic nRF5x Command Line Tools

Check to make sure you can run nrfjprog from your terminal/command prompt

macOS Note At present, you will need to create a symlink in /usr/local/bin to the nrfjprog tool wherever you have added it. You can run the following command, for example:

$ ln -s $HOME/prog/nordic/nrfjprog/nrfjprog /usr/local/bin/nrfjprog

Once the tools above have been installed and added to your system path, from the Arduino IDE:

• Select Tools > Board > Circuitrocks Alora ISP4520
• Select Tools > Programmer > J-Link for Circuitrocks Alora ISP4520
• Select Tools > Burn Bootloader with the board and J-Link connected

If you wish to modify bootloader to your own need, check out its repo here Circuitrocks_ISP4520_Bootloader

The bootloader hex file can be found at bin/bootloader run the command as follows:

$ nrfjprog -e -f nrf52
$ nrfjprog --program feather_nrf52832_bootloader.hex -f nrf52
$ nrfjprog --reset -f nrf52

This core is based on Adafruit_nRF52_Arduino by Adafruit,which in turn is based on the Arduino-nRF5 by Sandeep Mistry, which in turn is based on the Arduino SAMD Core.

The following libraries are used:

• adafruit-nrfutil is based on Nordic Semiconductor ASA's pc-nrfutil
• freeRTOS as operating system
• tinyusb as usb stack
• nrfx for peripherals driver
• littlefs for internal file system