background image

patchutils python screen texinfo unzip zlib1g-dev

7.2.2

Clone the freedom-u-sdk Repository

After installing the prerequisite packages, clone and initialize the

freedom-u-sdk

with these

commands:

git clone https://github.com/sifive/freedom-u-sdk.git
cd freedom-u-sdk
git checkout v1_0
git submodule update --init --recursive

Note: this command can take up to thirty minutes or one hour to complete.

7.2.3

Build the System

Once the repository has been cloned and its sub-modules initialized, you are ready to build the
system. Simply issue a

make

command from the

freedom-u-sdk

directory:

unset RISCV
make

Note: this command can take several hours on a fast machine.

7.2.4

Copy the System to an SD Card

Assuming all prerequisite packages were installed and the

freedom-u-sdk

repository’s sub-

modules were successfully initialized, the

make

command from the previous step

should

com-

plete with a message describing how to copy the boot image to an SD card.

Before executing this command, you will need to know the device name of your SD card. You
will also need to delete Master Boot Record (MBR) partitions from the SD card and create a
GUID Partition Table with no partitions defined.

Under current revisions of Ubuntu Linux, it is not uncommon for SD cards to be auto-mounted
upon insertion if they contain a valid partition table and file system. You may use the

mount

command to determine if this is the case. They should be unmounted before proceeding.

For example purposes, we will assume the device name of your SD card is

/dev/exb

. (This is

almost certainly

not

the name of an actual device; you will need to substitute the name of your

actual SD card device for

/dev/exb

in the commands which follow.)

If your SD card was auto-mounted when you inserted it, you can likely find the device name by
running the

mount

command. You may also find the name of the device by running the

dmesg

command and looking for log entries with the word "mounted".

If this is the first time you have installed a

freedom-u-sdk

image onto an SD card, it likely still

has a legacy partition table in the Master Boot Record. Before proceeding, you must delete par-

16

Summary of Contents for HiFive Unleashed

Page 1: ...SiFive HiFive Unleashed Getting Started Guide v1p2 SiFive Inc ...

Page 2: ...infringement SiFive does not assume any liability rising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation indirect incidental spe cial exemplary or consequential damages SiFive reserves the right to make changes without further notice to any products herein Release Information Version Date Changes v1p2 February 18...

Page 3: ...he HiFive Unleashed 12 5 4 HiFive Unleashed Boot 12 6 Firmware Update 14 7 Software Development Flow 15 7 1 Supported Platforms 15 7 2 Software Development with the Freedom Unleashed SDK 15 7 2 1 Install Prerequisite Packages 15 7 2 2 Clone the freedom u sdk Repository 16 7 2 3 Build the System 16 7 2 4 Copy the System to an SD Card 16 8 Connector Pinout 19 8 1 FMC Connector 19 8 2 Low Speed I O E...

Page 4: ...8 4 MicroSD Card Connector 24 8 5 JTAG Connector 24 2 ...

Page 5: ...I Flash a Gigabit Ethernet port and a MicroSD card slot for more external stor age Additionally the HiFive Unleashed supports adding new features such as PCI Express PCIe through the FMC connector and low speed I O expansion connectors 1 1 HiFive Unleashed Components 1 2 HiFive Unleashed Schematics Schematics and design files for HiFive Unleashed are available at https www sifive com products hifi...

Page 6: ... be used to interface with the HiFive Unleashed http store digilentinc com usb a to micro b cable 12V DC Power Wall Adapter The HiFive Unleashed Development Kit requires an external 12V 2A power supply When not powering directly from the FMC expansion module a 12V DC Wall Adapter with a 5 5 outer diameter 2 5 mm center positive barrel plug must be plugged into DC power jack on the HiFive Unleashed...

Page 7: ...nality can be added to the HiFive Unleashed Development Kit through the FMC connector The FMC expansion carrier card typically has an FPGA to enable third party developers to add new logic to the development kit The HiFive Unleashed Development Kit can be directly powered from the FMC expansion car rier card When powering from the FMC expansion carrier card do not plug in the 12V DC adapter into t...

Page 8: ... prepare the board for use follow these steps Unplug the HiFive Unleashed and switch the power off red button sticking out The board is still powered even when the switch is off so handle with care whenever power is applied 6 ...

Page 9: ...nsure the fan is plugged in Set all pins in the DIP switch block to the LEFT The ON position 0 therefore this sets MSEL to mode 1111 See the boot modes table in next section for more information on MSEL 7 ...

Page 10: ...8 ...

Page 11: ... GUID type 2E54B353 1271 4842 806F E436D6AF6985 If available connect the board to a network switch The board will run DHCP on boot and start an ssh server The MAC address is 70 b3 d5 92 fX XX where X XX is replaced by the board number converted to hexadecimal For example if the board is H5U 00063 then the last digits of the MAC address are 0 3f 9 ...

Page 12: ...s two serial interfaces The first contains the linux console running at 115200Hz The second provides JTAG suitable for use with openocd Plug in the HiFive Unleashed the fan should begin to spin Turn on the HiFive Unleashed after 30s a LED should begin to regularly blink a heartbeat 10 ...

Page 13: ... board number converted to hexadecimal Ask your network administrator which IP address your board has obtained Add the following to your ssh config filling in the IP address Host hifiveu HostName xxx yyy zzz aaa User root StrictHostKeyChecking no UserKnownHostsFile dev null To connect run ssh hifiveu The password is sifive 5 2 Connecting with USB console With a USB cable connected to the HiFive Un...

Page 14: ...BL The media is expected to be formatted with a GPT parti tion table even on SPI flash The entire contents of the first partition with GUID type 5B193300 FC78 40CD 8002 E86C45580B47 are downloaded into the L2 side band memory and execution transfers there ROM1 contains a hard coded DTB block passed in a1 to the FSBL which ignores it 3 FSBL 0x800_0000 Initialize core PPLs DDR and Ethernet PHY Decod...

Page 15: ...0000 loops forever waiting for debugger 0001 jump directly to 0x2000_0000 memory mapped SPI0 0010 jump directly to 0x3000_0000 memory mapped SPI1 0011 jump directly to 0x4000_0000 uncached ChipLink 0100 jump directly to 0x6000_0000 cached ChipLink 0101 SPI0 x1 SPI0 x1 0110 SPI0 x4 SPI0 x4 Rescue image from flash preprogrammed 0111 SPI1 x4 SPI1 x4 1000 SPI1 SD SPI1 SD 1001 SPI2 x1 SPI2 x1 1010 SPI0...

Page 16: ...ns the FSBL DTB and recovery kernel 2 hifive unleashed a00 A B YYYY MM DD bin an image which may optionally be written to the SD card This contains the default user kernel To upgrade follow these steps 1 Switch the MSEL DIP switches to 0110 2 Power on the board 3 Copy the two files to the board with scp 4 Execute flashcp v hifive unleashed a00 A B YYYY MM DD gpt dev mtd0 to upgrade the contents of...

Page 17: ...at some details in Chapters 4 5 6 and 7 of this document are specific to the Buildroot ver sion 7 1 Supported Platforms This document assumes you are running on a modern Linux system It has been tested on bare metal Linux systems and Linux systems running as a virtual machine The process docu mented here was tested using Ubuntu 16 04 4 and this operating system is the only version which is guarant...

Page 18: ... this command you will need to know the device name of your SD card You will also need to delete Master Boot Record MBR partitions from the SD card and create a GUID Partition Table with no partitions defined Under current revisions of Ubuntu Linux it is not uncommon for SD cards to be auto mounted upon insertion if they contain a valid partition table and file system You may use the mount command...

Page 19: ... partition table overlaps the last partition by 33 blocks You will need to delete this partition or resize it in another utility Command for help p Disk dev exb 61440 sectors 30 0 MiB Logical sector size 512 bytes Disk identifier GUID E2725DE1 5C7D 47A4 AADB 1C87907A1E50 Partition table holds up to 128 entries First usable sector is 34 last usable sector is 61406 Partitions will be aligned on 2048...

Page 20: ...mpleted successfully Once the MBR partition table and it s partitions have been deleted you can continue with the process of writing the system to the SD card sudo make DISK dev exb format boot loader This command is known to fail with slower USB SD card devices It should succeed if repeated The SD card should now contain a bootable linux image Refer to previous chapters for instruc tions in how t...

Page 21: ...C HPC connector Samtec ASP 134602 01 to connect to an FPGA on an FMC carrier card mating connector Samtec ASP 134486 01 The communication interface between the HiFive Unleashed and the FPGA is ChipLink The HiFive Unleashed can be powered directly from the FMC carrier card through the FMC connector 19 ...

Page 22: ... H28 CHIPLINK_RX_DAT15 1 8V INPUT H29 CHIPLINK_RX_DAT16 1 8V INPUT G27 CHIPLINK_RX_DAT17 1 8V INPUT G28 CHIPLINK_RX_DAT18 1 8V INPUT D26 CHIPLINK_RX_DAT19 1 8V INPUT D27 CHIPLINK_RX_DAT20 1 8V INPUT C26 CHIPLINK_RX_DAT21 1 8V INPUT C27 CHIPLINK_RX_DAT22 1 8V INPUT H31 CHIPLINK_RX_DAT23 1 8V INPUT H32 CHIPLINK_RX_DAT24 1 8V INPUT G30 CHIPLINK_RX_DAT25 1 8V INPUT G31 CHIPLINK_RX_DAT26 1 8V INPUT H34...

Page 23: ...NK_TX_DAT20 1 8V OUTPUT C14 CHIPLINK_TX_DAT21 1 8V OUTPUT C15 CHIPLINK_TX_DAT22 1 8V OUTPUT H16 CHIPLINK_TX_DAT23 1 8V OUTPUT H17 CHIPLINK_TX_DAT24 1 8V OUTPUT G15 CHIPLINK_TX_DAT25 1 8V OUTPUT G16 CHIPLINK_TX_DAT26 1 8V OUTPUT D17 CHIPLINK_TX_DAT27 1 8V OUTPUT D18 CHIPLINK_TX_DAT28 1 8V OUTPUT C18 CHIPLINK_TX_DAT29 1 8V OUTPUT C19 CHIPLINK_TX_DAT30 1 8V OUTPUT H19 CHIPLINK_TX_DAT31 1 8V OUTPUT H2...

Page 24: ... HiFive Unleashed CHIPLINK_RX_SEND ChipLink Receive Send strobe from the FMC carrier card to HiFive Unleashed CHIPLINK_RX_DATA 31 0 ChipLink Receive Data bus from the FMC carrier card to HiFive Unleashed CHIPLINK_TX_CLK ChipLink Transmit Clock from HiFive Unleashed to the FMC carrier card CHIPLINK_TX_RST ChipLink Transmit Reset from HiFive Unleashed to the FMC carrier card CHIPLINK_TX_SEND ChipLin...

Page 25: ...Pin Name Net Name GND GND 1 2 GND GND No Connect UART0_CTS 3 4 PWR_BTN_N PWR_BTN_N UART0_TX UART0_TXD 5 6 RST_BTN_N RESET_N UART0_RX UART0_RXD 7 8 SPI0_SCLK QSPI1_SCK No Connect UART0_RTS 9 10 SPI0_DIN QSPI1_DQ1 UART1_TX UART1_TXD 11 12 SPI0_CS QSPI1_CS0 UART1_RX UART1_RXD 13 14 SPI0_DOUT QSPI1_DQ0 I2C0_SCL I2C0_SCL 15 16 PCM_FS No Connect I2C0_SDA I2C0_SDA 17 18 PCM_CLK No Connect No Connect I2C1...

Page 26: ...ansion Connector Pinout 8 3 MicroUSB Connector The MicroUSB connector provides a connection to UART0 and JTAG from a Host PC If needed drivers for the FTDI FT2232H can be found at http www ftdichip com FTDrivers htm 8 4 MicroSD Card Connector The MicroSD card connector enables adding more storage with an external MicroSD card The connector is accessible from the Freedom U540 through SPI0 8 5 JTAG ...

Page 27: ...Pin Name Pin Name TCK 1 2 GND TDO 3 4 VCC TMS 5 6 SRSTn NC 7 8 TRSTn NC TDI 9 10 GND Table 5 JTAG Connector Pinout 25 ...

Reviews: