Getting Started with the LimeNET-Micro: Difference between revisions

Democratising Wireless Innovation
Jump to navigation Jump to search
m (update to raspbian 10)
 
(8 intermediate revisions by 2 users not shown)
Line 14: Line 14:




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==
== Flashing eMMC or uSD card==
To flash eMMC or uSD card with latest Raspbian image please follow these steps:
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]].
#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.
#Choose how the board will be powered by mounting a jumper on J27 header.
#Mount “USB boot”(J14) and unmount "EXT USB"(J18) jumpers.
#Mount “USB boot”(J14) and unmount "EXT USB"(J18) jumpers.
Line 31: Line 28:
#Remove “USB boot”(J14) jumper and reapply power. LimeNET-Micro should now boot to newly installed Raspbian image.
#Remove “USB boot”(J14) jumper and reapply power. LimeNET-Micro should now boot to newly installed Raspbian image.


=Installing Lime Suite=
==Installing Lime Suite==
After booting to the latest Raspbian image you can install LimeSuite by following the instructions on [[Getting Started with 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:
 
<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.
 
===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=
=Updating the Firmware and Gateware=
Line 39: Line 61:
=Further reading =
=Further reading =
* [[LimeNET-Micro_v2.1_hardware_description | LimeNET-Micro v2.1 hardware description]]
* [[LimeNET-Micro_v2.1_hardware_description | LimeNET-Micro v2.1 hardware description]]
* [https://www.raspberrypi.org/documentation/ Raspberry Pi documentation] - Raspberry Pi documentation database
* [https://www.raspberrypi.org/documentation/ Raspberry Pi documentation]
* [[LMS7002Mr3_Calibration_Using_MCU|LMS7002M (Mask 1) Transceiver Calibration]] - LMS7002Mr3 calibration guide, using internal MCU
* [[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)
* [[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.1r00.pdf LMS7002M Datasheet (PDF)] - LMS7002M RF transceiver datasheet
* [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
* [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