Template for adding default 3GHz frequencies to SMs for CBRS

This template is to add all the 2.5MHz rasters from 3555MHz to 3695Mhz for use with CBRS on PMP450/PMP450b SMs.

The template also enables all the frequencies in the scan list and enables 10,15,20,30,40MHz channel bandwidths for scanning.

To add the template to your cnMaestro account, go to Configuration > Templates and click "Add Template".

Select "PMP" as Type and "SM" as Device mode. Add a friendly name for the template and select the JSON template file and then click "Save".

template-add.jpg


To apply the template to already OnBoarded SMs in cnMaestro, go to the Manage > Configuration tab.

Select the network or Tower site with the devices you want to apply the template to.
In the Template drop-down menu, select the template.

Select the SM(s) you want to apply the template to and then click "Apply Configuration to x device(s)", this will send down the template and enable all the frequencies and channel bandwidths for scanning on the SMs you have selected.

template-use-01.jpg

Additionally, you can apply this template during onboarding of the device in cnMaestro, To do this, before approving the device to be OnBoarded into cnMaestro, click the "Configure Device" button on the SM and select the template from the pulldown list and then click "Save", this will apply the template to the SM during the OnBoarding process.
template-use-02.jpg

Evan,

5 Likes

Please post here if you find this useful.

1 Like

Thanks for putting this out.  I ended up creating my own already.  The difference I didn't add the 15MHz option as I don't believe that the SAS's will authorize 5MHz channels.  Here's the template I used if it helps

{
	"userParameters": {
                 "radioConfig": {
                 "customFrequencies": [
			    3555000,
                            3557500,
                            3560000,
                            3562500,
                            3565000,
                            3567500,
                            3570000,
                            3572500,
                            3575000,
                            3577500,
                            3580000,
                            3582500,
                            3585000,
                            3587500,
                            3590000,
                            3592500,
                            3595000,
                            3597500,
                            3600000,
                            3602500,
                            3605000,
                            3607500,
                            3610000,
                            3612500,
                            3615000,
                            3617500,
                            3620000,
                            3622500,
                            3625000,
                            3627500,
                            3630000,
                            3632500,
                            3635000,
                            3637500,
                            3640000,
                            3642500,
                            3645000,
                            3647500,
                            3650000,
                            3652500,
                            3655000,
                            3657500,
                            3660000,
                            3662500,
                            3665000,
                            3667500,
                            3670000,
                            3672500,
                            3675000,
                            3677500,
                            3680000,
                            3682500,
                            3685000,
                            3687500,
                            3690000,
                            3692500,
                            3695000,
                            3697500
                            ]
                          },
		"smRadioConfig": {
			"powerUpMode": 0,
			"frequencyScanList": [
			    3555000,
                            3557500,
                            3560000,
                            3562500,
                            3565000,
                            3567500,
                            3570000,
                            3572500,
                            3575000,
                            3577500,
                            3580000,
                            3582500,
                            3585000,
                            3587500,
                            3590000,
                            3592500,
                            3595000,
                            3597500,
                            3600000,
                            3602500,
                            3605000,
                            3607500,
                            3610000,
                            3612500,
                            3615000,
                            3617500,
                            3620000,
                            3622500,
                            3625000,
                            3627500,
                            3630000,
                            3632500,
                            3635000,
                            3637500,
                            3640000,
                            3642500,
                            3645000,
                            3647500,
                            3650000,
                            3652500,
                            3655000,
                            3657500,
                            3660000,
                            3662500,
                            3665000,
                            3667500,
                            3670000,
                            3672500,
                            3675000,
                            3677500,
                            3680000,
                            3682500,
                            3685000,
                            3687500,
                            3690000,
                            3692500,
                            3695000,
                            3697500
			],
			"maxTxPowerEnable": 0,
			"apSelection": 1,
			"maxTxPower": 25,
			"bandwidthScanList": [
                                100,
				200,
                                300,
                                400
			]
		}
	}
}
2 Likes

MSImax,
The SASs can actually issue a 15MHz Channel Bandwidth request.

They will issue a half channel next to a 10MHz center frequency, i.e: 3557.5MHz, 3562.5Mhz, 3567.5MHz, etc

This behavior, however, may vary by SAS Administrator (i.e. Federated Wireless may make a different assignment than Google or CommScope). Further, they may calculate interference (once the coexistence measures are taken into account) with this choice.

I tend to fall into the camp that you want to stick to 10 MHz channel raster in CBRS.

This document helped me a lot after Vernon pointed me toward it. Does anyone know if the Color Code on the SMs make any difference? I am merging two sectors into one, and of course they have different color codes. Will they be able to find their new AP without specifying what color codes to scan for?

1 Like

RP1:
The SMs that are moving to the new AP will need to have the new color code added to connect to the new AP.

I made the following template for use in cnMaestro for a similar situation.
This template has two variables in it that will set the new primary color code (${New_Color_Code}) and one to put the original color code as a secondary (${Old_Color_Code}) as a fall back.

**Be aware that when moving the SMs between APs, they will perform a re-registration and request a new grant. If you are in an area that requires devices to go through CPAS, this could cause a loss of service.

{
  "userParameters": {
    "smRadioConfig": {
      "colorCodeList": [
        {
          "colorCode": ${New_Color_Code},
          "priority": 1
        },
        {
          "colorCode": ${Old_Color_Code},
          "priority": 2
        }
      ]
    }
  },
 "cfgUtcTimestamp": "2020-06-19T00:00:00Z",
    "configFileParameters": {
        "rebootIfRequired": true,
        "setToDefaults": false
    },
    "cfgFileString": "Canopy configuration file",
    "cfgFileVersion": "1.0"
}

PMP450-SM-Color-Code-v0.1.zip (411 Bytes)

Thanks, Evan. I’ll give it a try tonight on two different cuts and let you know how it goes!

OK, apparently I have done something wrong–I have attached two .jpgs. I simply replaced the markers that read New_Color_Code and Old_Color_Code with the values 1 for New Color and 5 for Old. Guess I don’t understand how to modify .json files or sumthin’?

Hmmm, well, I can’t find a place to attach the screenshots–OK, so the error message I got when I try to add the template to a selection of SMs is:

“Error: Please configure replacement variables. If variables do not have default values, then device values are mandatory.”

I’m sure I’m overlooking something very obvious–can you assist?

To attach a screenshot in your reply, click the “upload” button… (looks like a PC with an UP arrow).

Regarding your actual question, I will ask Evan to take a look.

(You can also copy and paste images directly into the composer window)

OK, thanks! I’ve attached the two

.jpgs.

RP1:
To see the variable options for the template you can click on the “View Variables” and to set the variables you will see a little “Gear” logo over on the right-hand side

You will need to configure the “Old_Color_Code” and the “New_Color_Code” variables for each device

Once this is set for each device and saved, it will push the configured variables down to the SM.

Alternatively, you can remove the variable altogether and replace the ${New_Color_Code} with the new color code number and ${Old_Color_Code} with the old color code number like this:
image

Regards
Evan,

OK, I see the syntax error now. Thanks. I’ll give it a try tonight on a cut.

1 Like