Getting Started with the LimeNET-Micro: Difference between revisions

Democratising Wireless Innovation
Jump to navigation Jump to search
m (update to raspbian 10)
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Getting Started with LimeNET-Micro ==
= Basic setup =
=== Basic setup ===
To get LimeNET-Micro board up and running:
==== Powering the board ====
*Select how the board will be powered by placing a jumper on J27 header;
*Connect mouse and keyboard to J10 USB connectors;
*Connect monitor cable to J19 HDMI connector;
*Insert CM3 module into J13 socket (or CM3(L) module into J13 and uSD card into J16 slot);
*Flash eMMC or uSD card;
*Install LimeSuite
== Powering the board ==
LimeNET-Micro board can be powered in three ways:
LimeNET-Micro board can be powered in three ways:
*'''Power over Ethernet''' – using RJ45 connector and power sourcing equipment (PSE) such as PoE capable network switch or PoE injector. LimeNET-Micro board works with PSE supplying power in “Mode A/Endspan” as well in “Mode B/Midspan” modes;
*'''Power over Ethernet''' – using RJ45 connector and power sourcing equipment (PSE) such as PoE capable network switch or PoE injector. LimeNET-Micro board works with PSE supplying power in “Mode A/Endspan” as well in “Mode B/Midspan” modes;
Line 7: Line 13:
*'''microUSB port''' - 5V power source connected to J15 connector should be capable to provide 2A-3A current;
*'''microUSB port''' - 5V power source connected to J15 connector should be capable to provide 2A-3A current;


Power source can be selected fitting jumper in one of the three positions on J27 header (see Figure 1):
 
Power source can be selected fitting jumper in one of the three positions on J27 header:
*'''A (pins 5-6)''' – 5V micro USB;
*'''A (pins 5-6)''' – 5V micro USB;
*'''B (pins 3-4)''' – 5V external DC;
*'''B (pins 3-4)''' – 5V external DC;
*'''C (pins 1-2)''' – Power over Ethernet;
*'''C (pins 1-2)''' – Power over Ethernet;


[[File:LimeNET-Micro_2.1_power_selection .png |thumb|center|840px|Figure 12. LimeNET-Micro board power selection header  ]]
== Flashing eMMC or uSD card==
To flash eMMC or uSD card with latest Raspbian image please follow these steps:
#Download Raspbian image file by following this [https://www.raspberrypi.org/downloads/raspbian/ [link]] or [http://downloads.raspberrypi.org/ [link]]
#Choose how the board will be powered by mounting a jumper on J27 header.
#Mount “USB boot”(J14) and unmount "EXT USB"(J18) jumpers.
#Insert CM3 module into J13 socket (or CM3(L) module into J13 and uSD card into J16 slot).
#Flash Raspbian image by following this guide [https://www.raspberrypi.org/documentation/hardware/computemodule/cm-emmc-flashing.md [link]].
#Remove “USB boot”(J14) jumper and reapply power. LimeNET-Micro should now boot to newly installed Raspbian image.


To get LimeNET-Micro board up and running:
==Installing Lime Suite==
*Set “Power selection” jumper J27 to “A” position (pins 5-6, 5V micro USB power selection);
===Installing from Osmocom repository===
*Connect mouse and keyboard to J10 USB connectors;
 
*Connect monitor cable to J19 HDMI connector;
On the Raspbian Buster (10) distribution, you can install LimeSuite and Osmocom software from Osmocom repository.
*Insert CM3 module into J13 socket (or CM3(L) module into J13 and uSD card into J16 slot).
 
*Connect power adapter (5V, 2A-3A) to micro USB connector J15.
Open a terminal session, and type the following commands to add the repository and refresh the list of available packages:
 
<source lang="bash">
sudo su
wget http://download.opensuse.org/repositories/network:/osmocom:/latest/Raspbian_10/Release.key
apt-key add Release.key
rm Release.key
echo "deb http://download.opensuse.org/repositories/network:/osmocom:/latest/Raspbian_10/ ./" > /etc/apt/sources.list.d/osmocom-latest.list
apt-get update
exit
</source>
 
To install Lime Suite and its dependencies, type the following command:
 
<source lang="bash">
sudo apt install limesuite liblimesuite-dev
</source>
 
After installing reboot your device to apply udev rules.


=== FPGA programming ===  
===Installing from PPA or building from source===
LimeSuite can be installed by following the instructions on [[Installing Lime Suite on Linux]]


Intel MAX10 FPGA can be programmed using JTAG adapter such as [https://buyfpga.intel.com/PartDetail?partId=1212940 Intel FPGA USB Download Cable] (formerly known as Altera USB-Blaster download cable). LimeNET-Micro board has two different size and pin count JTAG headers (J4 - 10pin 0.05” pitch header and J3 - 7pin 0.1” pitch edge connector). Additional cable adapter is needed to connect download cable to LimeNET-Micro board because Intel FPGA USB Download Cable comes with 10-pin, 0.1” pitch female connector.  
=Updating the Firmware and Gateware=
The code running on the LimeSDR itself - known as "firmware" and "gateware" - needs to be kept up-to-date. Read [[LimeSDR Firmware Management]] to find out how to update these, and how to recover them if anything ever goes wrong.


[[File:LimeSDR-Micro_v2.1_FPGA_JTAG_pinheaders.png|thumb|center|640px|Figure 14. FPGA JTAG pinheaders ]]
=Further reading =
* [[LimeNET-Micro_v2.1_hardware_description | LimeNET-Micro v2.1 hardware description]]
* [https://www.raspberrypi.org/documentation/ Raspberry Pi documentation]
* [[LMS7002Mr3_Calibration_Using_MCU|LMS7002M (Mask 1) Transceiver Calibration]] - LMS7002Mr3 calibration guide, using internal MCU
* [[LimeSDR Made Simple]] - Demystifying using SDR in the real world and programming a simple example with confidence, through bite sized chunks (note that not all examples will work with the Mini, e.g. those using the waveform player)
* [https://github.com/myriadrf/LMS7002M-docs/blob/master/LMS7002M_Data_Sheet_v3.2r00.pdf LMS7002M Datasheet (PDF)] - LMS7002M RF transceiver datasheet
* [https://github.com/myriadrf/LMS7002M-docs/blob/master/LMS7002M_Programming_and_Calibration_Guide_v31r05.pdf LMS7002M Programming and Calibration Guide (PDF)] - LMS7002M programming and calibration guide

Latest revision as of 13:38, 28 August 2019

Basic setup

To get LimeNET-Micro board up and running:

  • Select how the board will be powered by placing a jumper on J27 header;
  • Connect mouse and keyboard to J10 USB connectors;
  • Connect monitor cable to J19 HDMI connector;
  • Insert CM3 module into J13 socket (or CM3(L) module into J13 and uSD card into J16 slot);
  • Flash eMMC or uSD card;
  • Install LimeSuite

Powering the board

LimeNET-Micro board can be powered in three ways:

  • Power over Ethernet – using RJ45 connector and power sourcing equipment (PSE) such as PoE capable network switch or PoE injector. LimeNET-Micro board works with PSE supplying power in “Mode A/Endspan” as well in “Mode B/Midspan” modes;
  • DC connector - 5V power source connected to J28 power jack should be capable to provide 2A-3A current;
  • microUSB port - 5V power source connected to J15 connector should be capable to provide 2A-3A current;


Power source can be selected fitting jumper in one of the three positions on J27 header:

  • A (pins 5-6) – 5V micro USB;
  • B (pins 3-4) – 5V external DC;
  • C (pins 1-2) – Power over Ethernet;

Flashing eMMC or uSD card

To flash eMMC or uSD card with latest Raspbian image please follow these steps:

  1. Download Raspbian image file by following this [link] or [link]
  2. Choose how the board will be powered by mounting a jumper on J27 header.
  3. Mount “USB boot”(J14) and unmount "EXT USB"(J18) jumpers.
  4. Insert CM3 module into J13 socket (or CM3(L) module into J13 and uSD card into J16 slot).
  5. Flash Raspbian image by following this guide [link].
  6. Remove “USB boot”(J14) jumper and reapply power. LimeNET-Micro should now boot to newly installed Raspbian image.

Installing Lime Suite

Installing from Osmocom repository

On the Raspbian Buster (10) distribution, you can install LimeSuite and Osmocom software from Osmocom repository.

Open a terminal session, and type the following commands to add the repository and refresh the list of available packages:

sudo su
wget http://download.opensuse.org/repositories/network:/osmocom:/latest/Raspbian_10/Release.key 
apt-key add Release.key
rm Release.key
echo "deb http://download.opensuse.org/repositories/network:/osmocom:/latest/Raspbian_10/ ./" > /etc/apt/sources.list.d/osmocom-latest.list
apt-get update
exit

To install Lime Suite and its dependencies, type the following command:

sudo apt install limesuite liblimesuite-dev

After installing reboot your device to apply udev rules.

Installing from PPA or building from source

LimeSuite can be installed by following the instructions on Installing Lime Suite on Linux

Updating the Firmware and Gateware

The code running on the LimeSDR itself - known as "firmware" and "gateware" - needs to be kept up-to-date. Read LimeSDR Firmware Management to find out how to update these, and how to recover them if anything ever goes wrong.

Further reading