https://wiki.myriadrf.org/api.php?action=feedcontributions&user=RicardoMendoza&feedformat=atomMyriad-RF Wiki - User contributions [en]2024-03-29T08:57:56ZUser contributionsMediaWiki 1.40.1https://wiki.myriadrf.org/index.php?title=PantaHub&diff=2290PantaHub2019-04-13T23:43:10Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
By default, our image lets you "'claim"' your device and control it through Pantahub.com as well as our development tools ('''pvr'''). Through this, you can choose to try out different community projects as well as be able to share your own developments and innovations with the broader community.<br />
<br />
Besides our default Pantahub-connected image, we also have one that is automatically connected to the LimeNET. Being part of the LimeNET means you can choose to automatically get all of the latest software, as well as have your device be part of our broad SDR ecosystem. If you choose to install this one, you won't have direct control via Pantahub; however, you can always flash the default image again to get control, or you can get in touch with [mailto:team@pantahub.com team@pantahub.com] to get your device released for you.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* Pantahub connected image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-unclaimed-pv-6144MiB.img.xz rpi3-unclaimed-pv-6144MiB.img.xz]<br />
<br />
* LimeNET controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with [mailto:team@pantahub.com team@pantahub.com] if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
Your first use of '''pvr''' will be when claiming your device. In order to claim your device you will need a Pantahub account, so make sure you have created one and have had it approved before the following. We are mostly interested now in the following command:<br />
<br />
'''$ pvr scan'''<br />
<br />
With this command, we will be able to discover devices in our network, both claimed and unclaimed, if they have no owner. We must begin by discovering and claiming our device:<br />
<br />
[[File:Unclaimed-pvr-windows.png]]<br />
<br />
If '''pvr''' finds a device on the local network it will present this metadata for you to claim it via the command quoted in the output. Just run that command as-is and your user should now own your device.<br />
<br />
It can take a minute or two, depending on your connection, for a device to fully show up on Pantahub's device list the first time it boots. Wait a few if it hasn't showed up, it eventually will. Once your device shows up as claimed and under your ownership, you can interact with it via '''clone''' and '''post''' commands. For example, if you '''clone''' a device you will get a checkout of the different container assets that make up this firmware revision.<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
=== LimeSCAN ===<br />
<br />
'''''DISCLAIMER''''' LimeSCAN is currently on a private Alpha; in order to get your device transmitting scan data you must get in touch with [mailto:team@pantahub.com team@pantahub.com] to request early access.<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
= Developing with Pantahub tools =<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
== SSH for Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=PantaHub&diff=2289PantaHub2019-04-13T23:41:23Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
By default, our image lets you "'claim"' your device and control it through Pantahub.com as well as our development tools ('''pvr'''). Through this, you can choose to try out different community projects as well as be able to share your own developments and innovations with the broader community.<br />
<br />
Besides our default Pantahub-connected image, we also have one that is automatically connected to the LimeNET. Being part of the LimeNET means you can choose to automatically get all of the latest software, as well as have your device be part of our broad SDR ecosystem. If you choose to install this one, you won't have direct control via Pantahub; however, you can always flash the default image again to get control, or you can get in touch with team@pantahub.com to get your device released for you.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* Pantahub connected image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-unclaimed-pv-6144MiB.img.xz rpi3-unclaimed-pv-6144MiB.img.xz]<br />
<br />
* LimeNET controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with team@pantahub.com if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
Your first use of '''pvr''' will be when claiming your device. In order to claim your device you will need a Pantahub account, so make sure you have created one and have had it approved before the following. We are mostly interested now in the following command:<br />
<br />
'''$ pvr scan'''<br />
<br />
With this command, we will be able to discover devices in our network, both claimed and unclaimed, if they have no owner. We must begin by discovering and claiming our device:<br />
<br />
[[File:Unclaimed-pvr-windows.png]]<br />
<br />
If '''pvr''' finds a device on the local network it will present this metadata for you to claim it via the command quoted in the output. Just run that command as-is and your user should now own your device.<br />
<br />
It can take a minute or two, depending on your connection, for a device to fully show up on Pantahub's device list the first time it boots. Wait a few if it hasn't showed up, it eventually will. Once your device shows up as claimed and under your ownership, you can interact with it via '''clone''' and '''post''' commands. For example, if you '''clone''' a device you will get a checkout of the different container assets that make up this firmware revision.<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
=== LimeSCAN ===<br />
<br />
'''''DISCLAIMER''''' LimeSCAN is currently on a private Alpha; in order to get your device transmitting scan data you must get in touch with the team to request early access.<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
= Developing with Pantahub tools =<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
== SSH for Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=PantaHub&diff=2288PantaHub2019-04-13T23:37:43Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
By default, our image lets you "claim" your device and control it through Pantahub.com as well as our development tools ('''pvr'''). Through this, you can choose to try out different community projects as well as be able to share your own developments and innovations with the broader community.<br />
<br />
Besides our default Pantahub-connected image, we also have one that is automatically connected to the LimeNET. Being part of the LimeNET means you can choose to automatically get all of the latest software, as well as have your device be part of our broad SDR ecosystem. If you choose to install this one, you won't have direct control via Pantahub; however, you can always flash the default image again to get control, or you can get in touch with team@pantahub.com to get your device released for you.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* Pantahub connected image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-unclaimed-pv-6144MiB.img.xz rpi3-unclaimed-pv-6144MiB.img.xz]<br />
<br />
* LimeNET controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with team@pantahub.com if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
Your first use of '''pvr''' will be when claiming your device. In order to claim your device you will need a Pantahub account, so make sure you have created one and have had it approved before the following. We are mostly interested now in the following command:<br />
<br />
'''$ pvr scan'''<br />
<br />
With this command, we will be able to discover devices in our network, both claimed and unclaimed, if they have no owner. We must begin by discovering and claiming our device:<br />
<br />
[[File:Unclaimed-pvr-windows.png]]<br />
<br />
If '''pvr''' finds a device on the local network it will present this metadata for you to claim it via the command quoted in the output. Just run that command as-is and your user should now own your device.<br />
<br />
It can take a minute or two, depending on your connection, for a device to fully show up on Pantahub's device list the first time it boots. Wait a few if it hasn't showed up, it eventually will. Once your device shows up as claimed and under your ownership, you can interact with it via '''clone''' and '''post''' commands. For example, if you '''clone''' a device you will get a checkout of the different container assets that make up this firmware revision.<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
=== LimeSCAN ===<br />
<br />
*** DISCLAIMER *** LimeSCAN is currently on a private Alpha; in order to get your device transmitting scan data you must get in touch with the team to request early access.<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
= Developing with Pantahub tools =<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
== SSH for Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=File:Unclaimed-pvr-windows.png&diff=2287File:Unclaimed-pvr-windows.png2019-04-13T23:37:20Z<p>RicardoMendoza: </p>
<hr />
<div></div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=PantaHub&diff=2286PantaHub2019-04-13T23:36:45Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
By default, our image lets you "claim" your device and control it through Pantahub.com as well as our development tools ('''pvr'''). Through this, you can choose to try out different community projects as well as be able to share your own developments and innovations with the broader community.<br />
<br />
Besides our default Pantahub-connected image, we also have one that is automatically connected to the LimeNET. Being part of the LimeNET means you can choose to automatically get all of the latest software, as well as have your device be part of our broad SDR ecosystem. If you choose to install this one, you won't have direct control via Pantahub; however, you can always flash the default image again to get control, or you can get in touch with team@pantahub.com to get your device released for you.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* Pantahub connected image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-unclaimed-pv-6144MiB.img.xz rpi3-unclaimed-pv-6144MiB.img.xz]<br />
<br />
* LimeNET controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with team@pantahub.com if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
Your first use of '''pvr''' will be when claiming your device. In order to claim your device you will need a Pantahub account, so make sure you have created one and have had it approved before the following. We are mostly interested now in the following command:<br />
<br />
'''$ pvr scan'''<br />
<br />
With this command, we will be able to discover devices in our network, both claimed and unclaimed, if they have no owner. We must begin by discovering and claiming our device:<br />
<br />
[[File:unclaimed-pvr-windows.png]]<br />
<br />
If '''pvr''' finds a device on the local network it will present this metadata for you to claim it via the command quoted in the output. Just run that command as-is and your user should now own your device.<br />
<br />
It can take a minute or two, depending on your connection, for a device to fully show up on Pantahub's device list the first time it boots. Wait a few if it hasn't showed up, it eventually will. Once your device shows up as claimed and under your ownership, you can interact with it via '''clone''' and '''post''' commands. For example, if you '''clone''' a device you will get a checkout of the different container assets that make up this firmware revision.<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
=== LimeSCAN ===<br />
<br />
*** DISCLAIMER *** LimeSCAN is currently on a private Alpha; in order to get your device transmitting scan data you must get in touch with the team to request early access.<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
= Developing with Pantahub tools =<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
== SSH for Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=PantaHub&diff=2285PantaHub2019-04-12T15:01:57Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
Our Pantahub-connect images automatically join the LimeNET, which is a managed network of LimeNET devices. By default, your device is controlled centrally but can be "released" for you to take control locally and be able to use Pantahub to drive the software that is running on your device.<br />
<br />
You can also install the alternate image, which does not automatically connect to the LimeNET controller. This image lets you follow the normal claiming process via Pantahub to take control of your device.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* LimeNET-controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with team@pantahub.com if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
By default, the image automatically boots into an "autopilot" mode, where the software on the device is managed and controlled remotely via the LimeNET. You can also control this yourself of course, to get the full benefits of being able to try different applications, monitor and control your device and also being able to share your work with others.<br />
<br />
If you want to release the device from the automatically controlled LimeNET, you can send us a request with your device-id to team@pantahub.com with the title "LimeNET Request". In order to discover your device-id, you need to run the '''pvr scan''' command. Your computer must be connected to the same local network as to which your LimeNET Micro is connected via it's ethernet port. The output of this command looks like the following, and the data in question is the ID field.<br />
<br />
[[File:Pvr-scan.png]]<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== LimeSCAN ===<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
= Developing with Pantahub tools =<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
== SSH for Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=PantaHub&diff=2284PantaHub2019-04-12T15:00:45Z<p>RicardoMendoza: </p>
<hr />
<div>= Pantahub =<br />
<br />
Pantahub is the one-stop hub for all connected devices. By choosing to use a Pantahub-connected image for your LimeNET Micro, you can begin to easily try out other developers SDR projects as well as share your own innovations with the community, so that others can try out and collaborate with ease.<br />
<br />
By getting connected to Pantahub, your devices become cloud-managed infrastructure, and through the use of our Pantahub.com dashboard and CLI tools you can remotely control the lifecycle of the software running on your device, without the need to be flashing and reflashing every time.<br />
<br />
== LimeNET ==<br />
<br />
Our Pantahub-connect images automatically join the LimeNET, which is a managed network of LimeNET devices. By default, your device is controlled centrally but can be "released" for you to take control locally and be able to use Pantahub to drive the software that is running on your device.<br />
<br />
You can also install the alternate image, which does not automatically connect to the LimeNET controller. This image lets you follow the normal claiming process via Pantahub to take control of your device.<br />
<br />
== Image Setup ==<br />
<br />
The Pantahub enabled image for LimeNET Micro can be found at:<br />
<br />
* LimeNET-controlled image: [https://s3.eu-west-2.amazonaws.com/pantahub-images/rpi3-limenet-pv-6144MiB.img.xz rpi3-limenet-pv-6144MiB.img.xz]<br />
<br />
<br />
To flash this, you can follow the instructions at [https://wiki.myriadrf.org/Getting_Started_with_the_LimeNET-Micro#Flashing_eMMC_or_uSD_card Flashing_eMMC_or_uSD_card]. Make sure to uncompress the image first with the '''unxz''' command.<br />
<br />
== Installing PVR ==<br />
<br />
Our main development tool is called '''pvr''' and it lets you interact with your Pantahub-connected device remotely. This CLI will be what you use to '''clone''' your device as well as '''post''' different demos to it for easy testing and seamless onboarding. You can download it from the following locations:<br />
<br />
* Linux (amd64): [https://gitlab.com/pantacor/pvr/uploads/d51b21e1f10fb62357164d5a062924f4/pvr-006-amd64.tar.gz pvr-006-amd64.tar.gz]<br />
: To install the Linux version you need to place the extracted binary in your '''$PATH''' and make sure it is made executable with '''chmod +x'''.<br />
<br />
* Windows (amd64): [https://gitlab.com/pantacor/pvr/uploads/8c2a619bfd568d58f2a24a3b3dead8b2/pvr-006-win10-64.zip pvr-006-win10-x64.zip]<br />
: To install the Windows version all you need is to place it in a directory to which your user has access and can run executables from. '''C:\Users\YOURUSER''' is usually a good location.<br />
<br />
Once you have it installed just calling the '''pvr''' command from your shell should show you the help menu, where you can get familiarized with the different features that it provides.<br />
<br />
== Registering user in Pantahub ==<br />
<br />
The first thing you need to do to interact with Pantahub is to register a user account on https://www.pantahub.com<br />
<br />
A user account gives you access to the full API, including the object store, and also grants you access to the dashboard.<br />
<br />
Register your user with the following command:<br />
<br />
{| class="wikitable"<br />
|$ pvr register -u youruser -p yourpassword -e your@email.tld<br />
|}<br />
<br />
This will generate a json response with the server-generated part of the credentials:<br />
<br />
{| class="wikitable"<br />
|2017/06/19 11:08:43 Registration Response: {<br/><br />
"id": "5947949b85188a000c143c2e",<br/><br />
"type": "USER",<br/><br />
"email": "your@email.tld",<br/><br />
"nick": "youruser",<br/><br />
"prn": "prn:::accounts:/5947949b85188a000c143c2e",<br/><br />
"password": "yourpassword",<br/><br />
"time-created": "2017-06-19T09:08:43.767224118Z",<br/><br />
"time-modified": "2017-06-19T09:08:43.767224118Z"<br/><br />
}<br />
|}<br />
<br />
You can also go to https://www.pantahub.com and follow the sign-up process on the web interface.<br />
<br />
Your account is not ready for use until you have followed email verification. Please get in touch with team@pantahub.com if you had any issues completing verification, or if the default storage quota is not enough for your project.<br />
<br />
== Claiming your device from the LimeNET ==<br />
<br />
By default, the image automatically boots into an "autopilot" mode, where the software on the device is managed and controlled remotely via the LimeNET. You can also control this yourself of course, to get the full benefits of being able to try different applications, monitor and control your device and also being able to share your work with others.<br />
<br />
If you want to release the device from the automatically controlled LimeNET, you can send us a request with your device-id to team@pantahub.com with the title "LimeNET Request". In order to discover your device-id, you need to run the '''pvr scan''' command. Your computer must be connected to the same local network as to which your LimeNET Micro is connected via it's ethernet port. The output of this command looks like the following, and the data in question is the ID field.<br />
<br />
[[File:Pvr-scan.png]]<br />
<br />
= Applications =<br />
<br />
The default image comes with a pre-installed set of applications. Some of these are helpers for management and Pantahub operations, but the two main applications are the interesting ones that drive LimeSDR stack in order to turn the LimeNET Micro into a GSM toolbox.<br />
<br />
=== LimeSCAN ===<br />
<br />
This is a GSM and Power Spectrum scanner that feeds scan data to the limescan.net website.<br />
<br />
To enable the LimeSCAN platform use following key/value in user-meta:<br />
<br />
* key: lime.gsmstation.mode<br />
* value: scan<br />
<br />
You will also have to set your limescan.ini in user-meta:<br />
<br />
* key: limescan-config.ini<br />
* value: <ini file><br />
<br />
Once configured your results will be fed to https://limescan.net/<br />
<br />
=== Osmocom GSM ===<br />
<br />
Osmocom NITB and LMS transmitter middleware that turns your LimeNET Micro into a GSM basestation.<br />
<br />
To enable osmo platform use following key/value in user-meta:<br />
<br />
key: lime.gsmstation.mode<br />
value: osmo<br />
Also the following keys exist that allow you to overwrite our default config files for the services '''nitb''', '''bts-trx''' and '''trx-lms''':<br />
<br />
* key: lime.gsmstation.osmo.config.nitb<br />
* value: <full config file used by osmo-nitb service><br />
<br />
* key: lime.gsmstation.osmo.config.bts<br />
* value: <full config file used by osmo-bts-trx service><br />
<br />
* key: lime.gsmstation.osmo.config.trx<br />
* value: <full config file used by osmo-trx-lms service><br />
<br />
Deleting the keys will make platform go back to default configs.<br />
<br />
== Pantahub services ==<br />
<br />
In addition to the SDR applications, the device comes preinstalled with a set of services that mediate access and discovery via the Pantahub controller.<br />
<br />
* alpine-base platform - auto connects your system through DHCP enabled ethernet<br />
* ph-vpn - pantahub vpn platform (experimental)<br />
* ph-avahi - find and claim your (local) devices with pvr scan and claim<br />
* pvr-auto-follow - make your device automatically track updates from another device<br />
<br />
You can access your device in Pantahub at https://www.pantahub.com/u/<your-user>/devices/<your-device-id><br />
<br />
Pantahub provides a fully fledged monitoring interface so that you can interact with your account's own device and object registry. This let's you visualize the current state of each device, how they are walking through available updates as well as doing introspection on the details of each step, including a README file, the objects that make it up, changelog, and cloud-backed logging and metadata.<br />
<br />
== Developer Access ==<br />
<br />
Right now you can access the following platforms as user root, via ssh, through following ports:<br />
<br />
* alpine-base-device: 22 (user: root pass: pantacor)<br />
* limescan-device: 7022 (user: root pass: pantalime)<br />
* lime-osmocom-device: 7024 (user: root pass: pantalime)<br />
* pvr-auto-follow: 8022 (user: root pass: pantasdk)<br />
<br />
''Note'': Root password login is only allowed through console.<br />
<br />
To log in via ssh you have to set the following user-meta key in Pantahub:<br />
<br />
* key: pvr-sdk.authorized_keys<br />
* value: <the authorized_keys file you want grant root login privilege to><br />
<br />
== Using Pantahub for development ==<br />
<br />
For normal use of '''pvr''' and https://www.pantahub.com to control your device, as well as the concepts of "cloning" and "sharing" your work with other people, you can refer to the [https://gitlab.com/pantacor/docs/blob/master/get-started-limesdr-rpi3.md Panthub + Lime SDR Documentation]<br />
<br />
<br />
'''Enjoy!'''</div>RicardoMendozahttps://wiki.myriadrf.org/index.php?title=File:Pvr-scan.png&diff=2282File:Pvr-scan.png2019-04-12T14:38:45Z<p>RicardoMendoza: </p>
<hr />
<div></div>RicardoMendoza