> For the complete documentation index, see [llms.txt](https://docs.gxc.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gxc.io/docs/network-configuration-and-operations-guides/5g-onyx-portal-4.x-operations/manage-equipment/manage-access-points.md).
# Manage Access Points
The AP (eNodeB in 4G networks and gNodeB function in 5G networks) handles the air interface for the UE. For core services, each AP connects to an Onyx Edge. For SAS-based spectrum access, a CBSD (Citizens Broadband Radio Service Device) resource is created for each AP. The AP represents the radio (gNodeB), while the CBSD represents the same radio in the SAS ecosystem for spectrum coordination. Each CBSD is associated with a single AP. CBSDs do not directly contact the SAS; the Domain Proxy communicates with SAS on behalf of CBSDs, handling registration, spectrum inquiry, grant requests, and heartbeat messages.
**CBSD vs AP**
* **AP (Access Point / gNodeB)**
* Handles radio transmission and UE connectivity
* Part of the mobile network (RAN)
* **CBSD**
* Represents the AP in the SAS ecosystem
* Handles:
* Registration
* Spectrum inquiry
* Grant management
* **Relationship**
* One AP ↔ One CBSD
* CBSD gets spectrum grants from SAS
* AP uses those grants to transmit
* **Domain Proxy (DP)**
* Communicates with SAS on behalf of CBSDs
## Carrier Modes
{% hint style="info" %}
**NOTE:** In the current release, Dual Carrier (DC) and Carrier Aggregation (CA) modes are not supported in 5G networks. 5G APs support only Single Carrier (SC) mode.
{% endhint %}
**Single Carrier (SC) Mode** – In SC mode, APs use a single carrier frequency, making it suitable for smaller networks or areas with lower traffic where bandwidth needs can be met with one frequency. SC mode is often used for basic services with lower data rates. While it performs well in environments with limited spectrum, it may become less effective as data demands grow. APs in SC mode operate as a single cell (single carrier) and support up to 96 active UE per AP.
{% hint style="info" %}
**NOTE:** All carrier mode configurations required on the AP equipment Local Configuration Interface (LCI) are managed by GXC. For queries, please contact GXC Technical Support.
{% endhint %}
## Suspended Grant Handling
When a grant is suspended, spectrum inquiry is initiated to seek a new grant. If a new grant is chosen, the suspended grant is relinquished immediately, and a grant request is sent for the chosen new grant.
* In single grant scenarios:
* If a new grant is available, it is chosen, and the suspended grant is relinquished.
* If no new grant is available, the suspended grant is maintained.
* In dual grant scenarios:
* If both grants are suspended:
* If two new grants are available, they are both chosen, and the suspended grants are relinquished.
* If only one new grant is available, the new grant is chosen. Depending on the best compatibility with this new grant:
* The better of the two suspended grants is retained, and the other relinquished. Here, better is the one that is first larger in bandwidth size and then contiguous. Preference order or power of grants is not used here to keep the implementation simple. If both grants are equal with respect to both bandwidth size and contiguity, then the lower frequency is chosen first.
* If none of the suspended grants is compatible with the new grant, both the suspended grants are relinquished. If no new grants are available, both suspended grants are retained.
* If only one grant is suspended:
* If at least two new grants are available:
* Of the possible choice of grants, the best compatible two are chosen (new grant + the existing authorized grant).
* The suspended grant is relinquished.
* If it is not part of the chosen two, the existing authorized grant is also relinquished.
* If only one new grant is available and it is compatible with the existing authorized grant, it is chosen, and the suspended grant is relinquished.
* If no such new grant is available, the suspended grant is maintained.
{% hint style="info" %}
**NOTE:** The suspended grant is relinquished immediately, and a grant request is sent for the chosen new grant. However, the SAS may reject the grant request, leaving the CBSD bereft of grants.
{% endhint %}
{% hint style="info" %}
**NOTE:** It is expected that the SAS does not include currently issued grants (be it granted, authorized, or suspended) as part of available channels, especially when it is suspended. If the suspended grant is part of the available channel, then the same suspended channel/grant may be chosen. It is also possible that some other channel will be chosen. There is no guarantee that another channel will be tried instead of the suspended grant.
{% endhint %}
{% hint style="info" %}
**NOTE:** Since Spectrum Inquiry is now initiated as long as there are suspended grants, to avoid continuous Spectrum Inquiry, a Spectrum Inquiry is sent only five minutes after the previous Spectrum Inquiry.
{% endhint %}
## View AP Details
This section describes how to:
* [*View Summary Details of All APs*](#view-summary-details-of-all-aps)
* [*View an AP’s Details*](#view-details-of-an-ap)
### View Summary Details of All APs
**To view the summary details of all APs in the network:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
* The AP's service status.
*  (green) – Indicates the RF Tx status is on.
*  (red) – Indicates the RF Tx status is off.
*  (grey) – Indicates the AP is offline.
* **Name** – The AP's name.
Hovering your cursor over the AP's name displays the AP equipment's vendor-assigned serial number.
* **Venue** – The name of the venue hosting the AP.
* **B/W (MHz)** – The AP's operating bandwidth in MHz.
* **Center Freq (MHz)** – The AP's operating frequency in MHz.
* **Cell Local ID** – The cell's unique ID within the network.
* **PCI** – The Physical Cell ID. The PCI is used for cell identity during cell selection procedure, and is used by UE to decode physical layer data being transmitted by the AP.
* **Pwr (dBm)** – The AP's current transmit power in dBm. This reflects the actual operating (SAS granted) power and may differ from the configured preferred power.
* **Online** – Indicates the AP's online status, which is determined by its reachability from the Onyx Portal.
*  (green) – Indicates the AP has checked-in with the Onyx Portal in the last five minutes.
*  (red) – Indicates the AP has not checked-in with the Onyx Portal in the last five minutes. Or, the time reported is older than five minutes.
*  (grey) – Indicates the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the last check-in timestamp.
* **Interface Status** – Indicates the AP's fronthaul interface status.
*  (green) – Indicates the AP fronthaul interface is connected.
*  (red) – Indicates the AP fronthaul interface is disconnected.
*  (grey) – Indicates the AP is offline or the fronthaul interface status is unavailable.
Hovering your cursor over the "Interface Status" icon displays the fronthaul status.
* **Sync Status** – Indicates the AP’s time synchronization state with its configured clock source (such as GPS or PTP). Accurate synchronization is critical for proper radio operation, including frame alignment, interference management, and UE connectivity.
*  (green) – Indicates the AP is in sync with the clock source.
*  (amber) – Indicates the sync is degraded.
*  (red) – Indicates the AP is not in sync.
*  (grey) – Indicates the Sync status is not available or the AP is offline.
* **Actions** – Options to view details, edit, and delete APs.
To include or exclude additional details from the list, click (additional details) and select or clear from the following additional parameters:
* **IP Address** – The AP's IP address.
* **Model** – The AP equipment's model.
* **Software Version** – The AP's software version.
* **Up Time** – The duration for which the AP has been continuously operational without any downtime or interruptions.
* **Subscribers** – The number of active UE sessions connected to each AP.
{% endstep %}
{% endstepper %}
### View an AP's Details
**To view an AP's details:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
To view the details of a particular AP, click its name.
The ***\*** page displays the AP's details.
* **Overview** tab:
* **Access Point Details**:
* **Name** – The AP's name.
* **Serial Number** – The AP equipment's vendor-assigned serial number.
* **Description** – The AP's description.
* **Venue** – The name of the venue hosting the AP.
* **Hardware Address** – The AP's MAC address.
* **Upgrade Status** – Status of the previous AP software upgrade.
NOTE: The Upgrade Status parameter is displayed only during an upgrade and for one hour after the upgrade.
To view details, click the status.
The **Upgrade Status** dialog box displays the following details:
* **Description** – Description of the last upgrade's status.
* **Old Version** – The AP software version before the upgrade.
* **New Version** – The new AP software version.
* **Updated At** – Timestamp at which the last upgrade completed.
* **Start Time** – Timestamp at which the last upgrade started.
* **Online** – Indicates the AP's online status, which is determined by its reachability from the Onyx Portal. To view the last check-in timestamp, hover your cursor over the "Online Status" icon.
*  (green) – Indicates the AP has checked-in with the Onyx Portal in the last five minutes.
*  (red) – Indicates the AP has not checked-in with the Onyx Portal in the last five minutes. Or, the time reported is older than five minutes.
*  (grey) – Indicates the associated Onyx Edge is offline.
* **Interface Status** – Indicates the AP's fronthaul interface status.
*  (green) – Indicates the AP fronthaul interface is connected.
*  (grey) – Indicates the interface is not connected or is unavailable.
Hovering your cursor over the "Interface Status" icon displays the fronthaul status.
* **Service Status** – Indicates the AP's service status. 5G AP operates as a single cell (Single Carrier mode).
Cell states per cell:
RF Tx Desired
RF Tx Actual
“Service Status” Icon
Cell State
On
On
(green)
Healthy
Off
Off
(grey)
Shutdown, the AP is offline, or the associated Onyx Edge is offline.
On
Off
(red)
Service Down
Off
On
(amber)
Unwarranted Transmission
Hovering your cursor over the "Service Status" icon displays the cell's RF Tx status and cell's desired status.
* **Sync Status** – Indicates the AP's time reference synchronization status with the primary clock source.
*  (green) – AP is in sync with the clock source.
*  (amber) – AP sync with the clock source is degraded.
*  (red) – AP is not in sync with the clock source.
*  (grey) – Any of the following:
* The AP is offline.
* The Onyx Edge associated with the AP is offline.
* The AP's Sync Mode is set to "Free Running".
* The AP's sync status is not available.
* **AP Properties**:
* **Model** – The AP equipment's model.
* **Software Version** – The AP's software version.
* **IP Address** – The AP's IP address.
* **Up Time** – The duration for which the AP has been continuously operational without any downtime or interruptions.
* **Reported Time** – The timestamp at which the AP's data was last reported.
* **FSM State** – The AP's Finite State Machine (FSM) state indicating the AP's operational state.
* **SAS Status** – (Displayed only if SAS is enabled.) Indicates the CBSD's lifecycle state with SAS—Registered, Granted, or Authorized.\
All green indicates fully operational spectrum usage.
To view the grant state, hover your cursor over the "SAS Status" icons.
In SC mode, displays the grant state of the only cell.
"SAS Status" icon color coding:
* Registered icon:
* Green – All CBSDs are registered.
* Amber – Some CBSDs are registered, and some are not registered.
* Red – No CBSDs are registered.
* Granted icon:
* Green – Required number of grants are available.
* Amber – Some grants are available but not the required number.
* Red – No grants are available.
* Grey – No CBSDs are registered.
* Authorized icon:
* Green – Required number of grants are authorized.
* Amber – Some grants are authorized but not the required number.
* Red – No grants are authorized.
* Grey – No grants are available.
* **RAN**:
* **SAS** – Indicates whether SAS-based spectrum coordination is enabled for the AP—**Enabled** or **Disabled**.
* **Cell Local ID** – The unique identifier for the cell within the local network (used for distinguishing cells in the same network).
* **Transmit** – The AP's RF transmission status—**Enabled** or **Disabled**.
* **PCI** – The Physical Cell ID (PCI) of a cell in the physical layer. The PCI is used for cell identity during the cell selection procedure, and is used by UE to decode physical layer data being transmitted by the AP.
* **DL/UL Distribution (SA)** – Indicates the downlink/uplink slot ratio. “--” indicates system-managed.
* **SAS Configuration** – (Displayed only if SAS is enabled.)
NOTE: These parameters are used for CBSD registration with SAS and are derived from the AP hardware configuration.
* **CBSD Category** – The CBSD's power class under CBRS regulations—Category A (devices that operate at maximum 30 dBm EIRP), Category B (devices that operate at maximum 47 dBm EIRP).
* **User ID** – The SAS account's user ID for SAS registration and authentication.
* **No. of Antenna** – The number of physical antennas reported by the CBSD to SAS.
* **Antenna Gain (dBi)** – The antenna gain reported for CBSD registration, measured in decibels relative to an isotropic antenna (dBi). Higher gain focuses energy more effectively but may have stricter deployment requirements.
* **Preferred Max Pwr (dBm)** – The preferred maximum transmit power (in dBm), constrained by device class limits.
* **Preferred BW (MHz)** – The requested bandwidth (in MHz) (supports 10 / 20 / 40 MHz+ depending on device class).
* **Preferred Freq (MHz)** – The preferred operating frequency in the CBRS band (in MHz); it must comply with device band and bandwidth constraints.
* **Strict Freq Preference** – If enabled, restricts SAS to preferred frequency; may fallback to lower bandwidth on same frequency.
NOTE: Usable frequency range reduces as bandwidth increases due to guard band requirements.
* **SAS Status**:
NOTE: These values represent spectrum grants issued by SAS to the CBSD and used by the associated AP for transmission.
* **BW (MHz)** – The actual bandwidth the SAS has granted or is in the process of granting to the CBSD.
* **Freq (MHz)** – The specific frequency center or range that the SAS has granted to the CBSD or is considering.
* **Max Tx Pwr (dBm)** – The maximum transmit power level that the SAS allows the CBSD to use on the granted frequency.
* **Heartbeat Interval** – Interval at which the device must communicate with SAS to maintain its grant.
* **Grant Expire Time** – Time when the spectrum grant expires if not renewed.
* **Transmit Expire Time** – Deadline after which transmission must stop if SAS heartbeat/grant conditions are not met.
* **Subscribers (n)** – The count and list of active UE sessions attached to the AP.
NOTE: Subscriber connectivity is handled by the AP (gNodeB). The CBSD does not participate in UE connectivity and is only used for spectrum authorization.
Also, in the subscriber details, you can view the specific cells that individual subscribers are attached to (Onyx Portal > **Subscribers** > subscribers list > **Access Point Cell ID** column).
* **Status** – The subscriber's service state—**Active** or **Inactive**.
* **Name** – The subscriber account's name.
* **IMSI** – The subscriber's IMSI number.
* **Subscriber Group Name** – The subscriber group to which the subscriber belongs.
{% endstep %}
{% step %}
Click the **Events & Alerts** tab.
* **Alerts** – Details of AP and SAS-related alerts based on the selected severity level. You can select the alert severity level from **All**, **Major**, **Minor**, **Critical**, or **Others**.
* **Date** – The alert's creation timestamp.
* **Status** – The alert's status.
* **Alert Name** – The alert's name.
* **Severity** – The alert's severity level.
* **Events** – Details of AP and SAS related events for the selected duration:
* **Timestamp** – The timestamp at which the event occurred.
* **Module** – The specific module or source from which the event originated. To filter events based on module, click the **Module** column header and select one or more modules.
* **Event Type** – The event's type. To filter the events based on the event type, click the **Event Type** header and select one or more event types.
* **Event Description** – The event's description.
* To view the details of a particular event, click the corresponding (view details) icon.
{% endstep %}
{% step %}
Click the **Logs** tab.
* **Logs** – The total number and list of log events for the AP in the selected duration.
* **Timestamp** – The timestamp at which the log was generated.
* **Severity** – The severity of the log message.
* **Message** – The actual information logged by the system.
To change the date and time range, select the required timestamps in the date/time fields. The logs list automatically updates to display the corresponding logs.
NOTE: Your selections must fall within a seven-day range.
To download the logs in .csv format, in the field, enter the number of logs to be included in the .csv file, then click (download). Default value: 5000. The downloaded .csv file includes details such as the timestamp, service, tag, type, and log text.
NOTE: You can download a maximum 5000 logs.
* **DP Logs (n)** – The total number and list of Domain Proxy (DP) log events between the selected entities—**DP**, **ACS**, **CBSD**, and **SAS**.
To change the selected entities, click the corresponding dropdown.
* **Timestamp** – The timestamp at which the log was generated.
* **From** – The source or origin of the data.
* **To** – The destination or target of the data.
* **Type** – The type of the log entry.
* **Message** – The actual information logged by the system.
{% endstep %}
{% step %}
The **Actions** button in the upper-right corner of the page provides the following options:
* **Delete** – (Super Administrator and Administrators only.) To delete the AP, in the upper-right corner of the page, click **Actions** > **Delete**. For more information, see [*Delete APs*](#delete-aps).
* **Reboot** – (Super Administrator and Administrators only.) To reboot the AP, in the upper-right corner of the page, click **Actions** > **Reboot**. For more information, see [*Reboot APs*](#reboot-aps).
* **Upgrade** – (Super Administrator and Administrators only.) To upgrade the AP software running on the APs, in the upper-right corner of the page, click **Actions** > **Upgrade**. For more information, see [*Manage AP Software Upgrades*](#manage-ap-software-upgrades).
{% endstep %}
{% endstepper %}
## Add APs
This section describes how to add APs.
{% hint style="info" %}
**NOTE:** You can add APs only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
{% hint style="info" %}
**NOTE:** In this release, IPSec is not supported on APs in 5G networks.
{% endhint %}
{% hint style="info" %}
**NOTE:** In this release, 5G APs support only Single Carrier mode.
{% endhint %}
**To add an AP to a 5G network:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
In the upper-right corner of the page, click **Add Node** > **Add Access Point**.
The **Create Access Point** page is displayed.
{% endstep %}
{% step %}
Enter the following details:
* **Name** – (Required) The AP's name.
* **Serial Number** – (Required) The AP equipment's vendor-assigned serial number.
* **MAC Address** – (Required) The AP's MAC address.
* **Device Class** – (Required) Click to select the AP equipment's model from the following. Default value: G105-n48F.
* **G105-n48F** – Band 48 Indoor AP
* **G105-n48P** – Band 48 Indoor AP
* **G105-n77** – Band 77 Indoor AP
* **G105-n78F** – Band 78 Indoor AP
* **G105-n78P** – Band 78 Indoor AP
* **G227** – Indoor AP
* **G228** – Outdoor AP
* **G244** – Outdoor AP
* **G505-n48P** – Band 48 Outdoor AP
* **G506-n77** – Band 77 Outdoor AP
* **G506-n78** – Band 78 Medium-power Outdoor AP
* **G509-n79** – Band 79 Outdoor AP
For detailed information on these 5G APs, refer to the corresponding Specification Sheets or Hardware Installation Guides.
* **Max Tx Pwr (dBm)** – (Required) The maximum allowed radio transmit power for this AP in dBm.
* **Tx-Enabled** – Click the toggle switch to enable or disable the AP's transmission. Default setting: enabled.
* **Description** – (Required) The AP's description.
{% endstep %}
{% step %}
To save the AP, in the upper-right corner of the page, click **Save Access Point**.
{% endstep %}
{% endstepper %}
## Edit APs
{% hint style="info" %}
**NOTE:** You can edit AP details only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
**To edit an AP in a 5G network:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
For the node that you want to edit, in the **Actions** column, click the corresponding ⋮ (options) icon, then click **Edit**.
The **Edit Access Point** page displays the equipment's details.
{% endstep %}
{% step %}
Edit the AP's details as required.
* **Name** – (Required) The AP's name.
* **Serial Number** – (Read-only) The AP equipment's vendor-assigned serial number. This field cannot be edited.
* **MAC Address** – (Read-only) The AP's MAC address. field cannot be edited.
* **Device Class** – (Read-only) The AP equipment's model. This field cannot be edited.
For detailed information on 5G APs, refer to the corresponding Specification Sheets or Hardware Installation Guides.
* **Max Tx Pwr (dBm)** – (Required) The maximum allowed radio transmit power for this AP in dBm.
* **Tx-Enabled** – Click the toggle switch to enable or disable the AP's transmission. Default setting: enabled.
* **Description** – (Required) The AP's description.
{% endstep %}
{% step %}
To save your edits, in the upper-right corner of the page, click **Save Access Point**.
{% endstep %}
{% endstepper %}
## Reboot APs
{% hint style="info" %}
**NOTE:** You can reboot APs only if you are a Super Administrator or an Administrator.
{% endhint %}
{% hint style="info" %}
**NOTE:** When you reboot an AP, it will temporarily deactivate any active networks and disconnect any UE that are connected to those networks.
{% endhint %}
**To reboot an AP:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
Click the name of the AP that you want to reboot.
The ***\*** page displays the AP's details.
{% endstep %}
{% step %}
In the upper-right corner of the page, click **Actions**, then click **Reboot**.
A confirmation dialog box is displayed.
{% endstep %}
{% step %}
To confirm rebooting the AP, click **Yes**.
{% endstep %}
{% endstepper %}
## Delete APs
{% hint style="info" %}
**NOTE:** You can delete APs only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
**To delete an AP:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
For the equipment that you want to delete, in the **Actions** column, click the corresponding ⋮ (options) icon, then click **Delete**.
A confirmation dialog box is displayed.
{% endstep %}
{% step %}
To confirm deleting the AP, click **Yes**.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.gxc.io/docs/network-configuration-and-operations-guides/5g-onyx-portal-4.x-operations/manage-equipment/manage-access-points.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
(additional details) and select or clear from the following additional parameters:
* **IP Address** – The AP's IP address.
* **Model** – The AP equipment's model.
* **Software Version** – The AP's software version.
* **Up Time** – The duration for which the AP has been continuously operational without any downtime or interruptions.
* **Subscribers** – The number of active UE sessions connected to each AP.
{% endstep %}
{% endstepper %}
### View an AP's Details
**To view an AP's details:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **Access Points** tab.
The **Equipment** page > **Access Points** tab displays the summary details of all APs configured in the network.
{% endstep %}
{% step %}
To view the details of a particular AP, click its name.
The ***\
(green)
(grey)
(red)
(amber)
(view details) icon.
{% endstep %}
{% step %}
Click the **Logs** tab.
* **Logs** – The total number and list of log events for the AP in the selected duration.
* **Timestamp** – The timestamp at which the log was generated.
* **Severity** – The severity of the log message.
* **Message** – The actual information logged by the system.
To change the date and time range, select the required timestamps in the 
date/time fields. The logs list automatically updates to display the corresponding logs.
field, enter the number of logs to be included in the .csv file, then click 
(download). Default value: 5000. The downloaded .csv file includes details such as the timestamp, service, tag, type, and log text.
