> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/web-portal-3-3/hardware/new-hardware/adding-telecom-hardware.md).

# Adding Telecom Hardware

#### ***Applies to version v3.0***

When you receive a new system, at least one hardware configuration is available (by default) in the Toolpack application server. To add other hardware devices, use the Tmedia [Web Portal](/tmedia-documentation/other-pages/other/web-portal.md).

In order to add one or more additional hardware devices to the Toolpack system configuration, their serial numbers must be registered with the Toolpack application server.

**To add a hardware device:**

1- Click **Hardware Units** in the navigation panel

![Hardware 0 A](https://docs.telcobridges.com/w/images/a/ae/Hardware_0_A.png)

2- Click **Create New Unit**, to add a new hardware device

![Hardware 1 A](https://docs.telcobridges.com/w/images/e/e9/Hardware_1_A.png)

3- Enter information for the following parameters:

* Enter a **name** for the hardware device
* Enter the **serial number** of the new hardware device (filling in the Serial Number field will cause auto-completion of the field to occur).
* Select the appropriate **hardware device** from the Type field.
* Enter the location in which the hardware device is installed.
* Enter a meaningful description about the use or purpose of the hardware device.
* Select **Enabled** from the Target State field.
* Select the type of TDM lines that the hardware device will support.
* Indicate if the device will operate as a backup in an 1+1 or N+1 configuration. If this is the first device being added, leave this field empty.
* Provide the amount of time in seconds, that the system will wait for calls to complete before shutting down for an upgrade.
* Click **Create**

![Hardware 2 B](https://docs.telcobridges.com/w/images/5/57/Hardware_2_B.png)

**NOTE** The following image shows the 1+1 Backup field set. This is done for the addition of a secondary device that will operate as the designated 1+1 backup in a 1+1 or N+1 group.

![Hardware 3 B](https://docs.telcobridges.com/w/images/d/d8/Hardware_3_B.png)

4- Verify that the **Unit was successfully created** message appears, and that the newly added hardware device appears in the **Hardware List**.

![Hardware 4 A](https://docs.telcobridges.com/w/images/c/c9/Hardware_4_A.png)

**Path**

```
/configurations/@[configuration_name]/hardware_units/@[hardware_name]
```

**Parameters (text)**

```
/configurations/@[configuration_name]/hardware_units/@[hardware_name]
description              = ""
graceful_upgrade_timeout = 0
is_np1_backup            = false
location                 = ""
name                     = "@[hardware_name]"
serial_number            = "@[serial_number]"
target_state             = "Enabled"
tdm_line_type            = "E1_T1_J1"
type                     = "TDM/IP Gateway"

/configurations/@[configuration_name]/hardware_units/@[hardware_name]/advanced_parameters
casr2_cpu0_load                = 50
dsp_reserved_for_play_record   = 1
enable_http                    = true
enable_mgmt_port_redundancy    = true
enable_telnet                  = true
enable_v34                     = false
enable_vbd_autoswitch          = false
isdn_primary_cpu_load_percent  = 50
load_cas_on_secondary_cpu      = false
load_isdn_on_secondary_cpu     = false
load_iua_on_secondary_cpu      = true
load_lapd_on_secondary_cpu     = true
load_m2pa_on_secondary_cpu     = true
load_m2ua_on_secondary_cpu     = true
load_m3ua_on_secondary_cpu     = true
load_sip_on_secondary_cpu      = true
sip_cong_start_thresh          = 2
sip_cong_stop_thresh           = 4
sip_critical_cong_start_thresh = 1
sip_critical_cong_stop_thresh  = 3
sip_dynamic_mem_size           = "0 KB"
sip_event_mem_size             = "0 KB"
sip_extra_mem                  = true
sip_reduced_timer_start_thresh = 4
sip_reduced_timer_stop_thresh  = 5
sip_signal_mem_size            = "0 KB"
sip_signal_sizes               = ""
tdm_companding                 = "aLaw"
voip_codec_AMR                 = 0
voip_codec_ECHO_H              = 0
voip_codec_ECHO_L              = 0
voip_codec_ECHO_M              = 0
voip_codec_EFR                 = 0
voip_codec_EVRC                = 0
voip_codec_FR                  = 0
voip_codec_G711_5              = 0
voip_codec_G711_10             = 0
voip_codec_G711_20             = 0
voip_codec_G722_2              = 0
voip_codec_G723                = 0
voip_codec_G726_10             = 0
voip_codec_G726_20             = 0
voip_codec_G728                = 0
voip_codec_G729A               = 0
voip_codec_G729EG_8            = 0
voip_codec_G729EG_11_8         = 0
voip_codec_ILBC13              = 0
voip_codec_ILBC15              = 0
voip_codec_mode                = "Mixed Mode"
voip_codec_QCELP8              = 0
voip_codec_QCELP13             = 0
voip_codec_SMV                 = 0
voip_codec_T38                 = 0

/configurations/@[configuration_name]/hardware_units/@[hardware_name]/call_rate_limiting
maximum_cas_call_burst         = 0
maximum_cas_calls_per_second   = 0
maximum_isdn_call_burst        = 0
maximum_isdn_calls_per_second  = 0
maximum_sip_call_burst         = 0
maximum_sip_calls_per_second   = 0

/configurations/@[configuration_name]/hardware_units/@[hardware_name]/congestion_threshold
nb_calls_per_period = 10
period_duration     = "1 minute"
```

**Parameters (json)**

```
{
  "advanced_parameters" : {
    "casr2_cpu0_load" : 50,
    "dsp_reserved_for_play_record" : 1,
    "enable_http" : true,
    "enable_mgmt_port_redundancy" : true,
    "enable_telnet" : true,
    "enable_v34" : false,
    "enable_vbd_autoswitch" : false,
    "isdn_primary_cpu_load_percent" : 50,
    "load_cas_on_secondary_cpu" : false,
    "load_isdn_on_secondary_cpu" : false,
    "load_iua_on_secondary_cpu" : true,
    "load_lapd_on_secondary_cpu" : true,
    "load_m2pa_on_secondary_cpu" : true,
    "load_m2ua_on_secondary_cpu" : true,
    "load_m3ua_on_secondary_cpu" : true,
    "load_sip_on_secondary_cpu" : true,
    "sip_cong_start_thresh" : 2,
    "sip_cong_stop_thresh" : 4,
    "sip_critical_cong_start_thresh" : 1,
    "sip_critical_cong_stop_thresh" : 3,
    "sip_dynamic_mem_size" : "0 KB",
    "sip_event_mem_size" : "0 KB",
    "sip_extra_mem" : true,
    "sip_reduced_timer_start_thresh" : 4,
    "sip_reduced_timer_stop_thresh" : 5,
    "sip_signal_mem_size" : "0 KB",
    "sip_signal_sizes" : "",
    "tdm_companding" : "aLaw",
    "voip_codec_AMR" : 0,
    "voip_codec_ECHO_H" : 0,
    "voip_codec_ECHO_L" : 0,
    "voip_codec_ECHO_M" : 0,
    "voip_codec_EFR" : 0,
    "voip_codec_EVRC" : 0,
    "voip_codec_FR" : 0,
    "voip_codec_G711_5" : 0,
    "voip_codec_G711_10" : 0,
    "voip_codec_G711_20" : 0,
    "voip_codec_G722_2" : 0,
    "voip_codec_G723" : 0,
    "voip_codec_G726_10" : 0,
    "voip_codec_G726_20" : 0,
    "voip_codec_G728" : 0,
    "voip_codec_G729A" : 0,
    "voip_codec_G729EG_8" : 0,
    "voip_codec_G729EG_11_8" : 0,
    "voip_codec_ILBC13" : 0,
    "voip_codec_ILBC15" : 0,
    "voip_codec_mode" : "Mixed Mode",
    "voip_codec_QCELP8" : 0,
    "voip_codec_QCELP13" : 0,
    "voip_codec_SMV" : 0,
    "voip_codec_T38" : 0
  },
  "call_rate_limiting" : {
    "maximum_cas_call_burst" : 0,
    "maximum_cas_calls_per_second" : 0,
    "maximum_isdn_call_burst" : 0,
    "maximum_isdn_calls_per_second" : 0,
    "maximum_sip_call_burst" : 0,
    "maximum_sip_calls_per_second" : 0,
    "maximum_ss7_call_burst" : 0,
    "maximum_ss7_calls_per_second" : 0,
    "maximum_total_call_burst" : 0,
    "maximum_total_calls_per_second" : 0
  },
  "congestion_threshold" : {
    "nb_calls_per_period" : 10,
    "period_duration" : "1 minute"
  },
  "description" : "",
  "graceful_upgrade_timeout" : 0,
  "is_np1_backup" : false,
  "location" : "",
  "name" : "@[hardware_name]",
  "serial_number" : "@[serial_number]",
  "target_state" : "Enabled",
  "tdm_line_type" : "E1_T1_J1",
  "type" : "TDM/IP Gateway",
  "bondings" : {
  },
  "cas_stacks" : {
  },
  "ethernet_ports" : {
  },
  "ip_interfaces" : {
  },
  "isdn_stacks" : {
  },
  "iua_stacks" : {
  },
  "m2pa_stacks" : {
  },
  "m2ua_stacks" : {
  },
  "mtp2_stacks" : {
  },
  "rtp_port_ranges" : {
  },
  "sctp_stacks" : {
  },
  "tdm_line_interfaces" : {
  },
  "tunnels" : {
  },
  "virtual_ports" : {
  }
}
```

### List of Parameters

* [Name](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/m3ua#n)
* [Serial](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#s)
* [Type](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#a)
* [Location](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#l)
* [Description](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#d)
* [Target State](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#t)
* [TDM Lines Type](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#t)
* [Is N+1 Backup](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#i)
* [Graceful Upgrade Timeout](https://tmediadocs.telcobridges.com/telecom-references/parameter-reference/hardware#g)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/web-portal-3-3/hardware/new-hardware/adding-telecom-hardware.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
