The USP protocol agent (UspPa) is normally disabled in RDK-B.<\/p>\n\n\n\n
To enable it, add the following line to your target device bit bake layer:<\/p>\n\n\n\n
DISTRO_FEATURES_append = \" usppa\"<\/pre>\n\n\n\nUspPa is currently enabled in the RaspberryPI build of RDK-B.<\/p>\n\n\n\n
To disable it, comment out, or remove the above line from meta-cmf-raspberrypi\/conf\/distro\/include\/rdk-rpi.inc.<\/em><\/p>\n\n\n\n
USP Database<\/h2>\n\n\n\n
The configuration settings for UspPa are stored in a database.<\/p>\n\n\n\n
On the device, the database is located at “\/nvram\/usp-pa.db”.<\/p>\n\n\n\n
Modifying the factory reset file<\/h2>\n\n\n\n
The factory reset file contains the default configuration settings. <\/p>\n\n\n\n
If no USP database exists when UspPa starts, then a USP database will be created using the values in the factory reset file.<\/p>\n\n\n\n
You will need to modify it to point to the USP Controller that you are using.<\/p>\n\n\n\n
On the device, the factory reset file is located at “\/etc\/usp-pa\/usp_factory_reset.conf”.<\/p>\n\n\n\n
After making changes to this file, you must (IMPORTANT<\/strong>) delete the USP database, then restart UspPa, in order for the changes to take effect.<\/p>\n\n\n\n
Adding to the USP trust store<\/h2>\n\n\n\n
When connecting to a USP Controller, TLS may be used.<\/p>\n\n\n\n
UspPa validates the Controller’s TLS certificate using the CA certs located in “\/etc\/usp-pa\/usp_truststore.pem”. You can add CA certs to this file. After adding certs, you must restart UspPa for the changes to take effect.<\/p>\n\n\n\n
Command Line Tool<\/h2>\n\n\n\n
UspPa may be invoked as a command line tool using the ‘-c’ option.<\/p>\n\n\n\n
For example you can get parameters, query the supported data model or stop the UspPa daemon process.<\/p>\n\n\n\n
To see a list of commands supported in CLI mode use:<\/p>\n\n\n\n
$ UspPa -c help<\/pre>\n\n\n\nTroubleshooting<\/h2>\n\n\n\n
CCSP_ERR_INVALID_PARAMETER_NAME<\/h3>\n\n\n\n
If a USP Get results in the following error:<\/p>\n\n\n\n
err_msg: \"RDK_GetGroup: CcspBaseIf_getParameterValues() failed (9005 - CCSP_ERR_INVALID_PARAMETER_NAME)\"<\/pre>\n\n\n\nThis error is caused by a mismatch between the supported data model in UspPa (as defined by UspPa’s config files) and the supported data model in RDK-B. Most likely some parameters in RDK-B have been removed or renamed.
UspPa can discover the RDK-B data model at bootup and regenerate the data model config files.
To regenerate the files, on the device, delete out the following files from the directory \/etc\/usp-pa:<\/p>\n\n\n\nusp_dm_comps.conf\nusp_dm_objs.conf\nusp_dm_params.conf<\/pre>\n\n\n\n
When UspPa starts up again, it will regenerate the files. You could then copy the files back into your build environment at meta-rdk-broadband\/recipes-rdkb\/usp-pa\/conf.<\/em><\/p>\n\n\n\nIf you are still having problems:<\/em><\/p>\n\n\n\n
When performing a ‘get’ operation UspPa attempts to get all specified parameters using a single RDK bus message. This is more efficient than requesting each parameter individually, however it has the downside that if the ‘get’ of any single parameter fails, all fail (the RDK response message does not provide a partial response in this case). So if you try to get all parameters of an object using a a partial path, and get the CCSP_ERR_INVALID_PARAMETER_NAME error, you need to determine which one is causing the error. You can use the GET_GROUPED_PARAMETERS_INDIVIDUALLY and SET_GROUPED_PARAMETERS_INDIVIDUALLY defines in vendor_defs.h to change the behaviour of UspPa to request parameters individually, and determine which parameter is actually causing the problem. You can then omit this parameter from usp_dm_params.conf.<\/p>\n\n\n\n
For problems with get use:<\/p>\n\n\n\n
UspPa -c get \"Device.\"<\/pre>\n\n\n\nUspPa will print the value of all parameters. If it failed to get a parameter, then it will print an error message of the form:<\/p>\n\n\n\n
ERROR: [error-code] retrieving [parameter-name] ([textual-error-message])<\/pre>\n\n\n\nFor problems with set, you can consult the logs (obtained with -p option enabled) to determine which parameter is causing problems, or use ‘UspPa -c set’, to try setting each parameter in turn.<\/p>\n\n\n\n
WARNING: No instances in Device.LocalAgent.Controller<\/strong><\/p>\n\n\n\n
WARNING: No enabled MTPs in Device.LocalAgent.MTP. USP Agent may only be usable via the CLI<\/strong><\/p>\n\n\n\n
If you get these errors, it means that UspPa does not have a valid configuration database. To fix this, delete out \/nvram\/usp-pa.db, and ensure that the first invocation of UspPa after that includes the ‘-r’ option specifying the factory reset database to apply (The system daemon invocation uses this option). If the first invocation of UspPa after deleting the database is ‘UspPa -c’, make sure that you include the ‘-r’ option, otherwise you will end up with an empty database again.<\/p>\n\n\n\n
Questions<\/h2>\n\n\n\n
Why doesn’t ‘dmcli eRT getv Device.LocalAgent.’ work ?<\/strong><\/p>\n\n\n\n
dmcli is used to explore the data model provider components on the RDK bus.
UspPa does not currently export USP Specific configuration parameters to the RDK bus, they only exist in the USP Agent.
<\/p>\n\n\n\nWhy isn’t Device.LocalAgent in <\/strong>usp_dm_objs.conf and usp_dm_params.conf ?<\/strong><\/p>\n\n\n\n
The usp_dm_objs.conf and usp_dm_params.conf files are used to define which RDK data model provider components are imported into the USP Agent.<\/p>\n\n\n\n
Device.LocalAgent (and a number of other data model objects) exist only in the USP Agent and so do not need to be imported. If you want to remove any of these USP-Agent-only objects, this must be done at compile time using the defines in vendor_defs.h (Example: REMOVE_DEVICE_TIME).<\/p>\n","protected":false},"excerpt":{"rendered":"
The USP protocol agent (UspPa) is normally disabled in RDK-B. To enable it, add the […]<\/p>\n","protected":false},"author":659,"featured_media":0,"parent":207,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-10608","page","type-page","status-publish","hentry"],"yoast_head":"\n
Including UspPa in a device - RDK Documentation Portal | Support<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Including UspPa in a device - RDK Documentation Portal | Support\" \/>\n<meta property=\"og:description\" content=\"The USP protocol agent (UspPa) is normally disabled in RDK-B. To enable it, add the […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/\" \/>\n<meta property=\"og:site_name\" content=\"RDK Documentation Portal | Support\" \/>\n<meta property=\"article:modified_time\" content=\"2026-02-16T11:25:23+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/\",\"url\":\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/\",\"name\":\"Including UspPa in a device - RDK Documentation Portal | Support\",\"isPartOf\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/support\/#website\"},\"datePublished\":\"2026-02-16T11:25:07+00:00\",\"dateModified\":\"2026-02-16T11:25:23+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/developer.rdkcentral.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/developer.rdkcentral.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Articles\",\"item\":\"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Including UspPa in a device\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/developer.rdkcentral.com\/support\/#website\",\"url\":\"https:\/\/developer.rdkcentral.com\/support\/\",\"name\":\"RDK Documentation Portal | Support\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/developer.rdkcentral.com\/support\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Including UspPa in a device - RDK Documentation Portal | Support","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/","og_locale":"en_US","og_type":"article","og_title":"Including UspPa in a device - RDK Documentation Portal | Support","og_description":"The USP protocol agent (UspPa) is normally disabled in RDK-B. To enable it, add the […]","og_url":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/","og_site_name":"RDK Documentation Portal | Support","article_modified_time":"2026-02-16T11:25:23+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/","url":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/","name":"Including UspPa in a device - RDK Documentation Portal | Support","isPartOf":{"@id":"https:\/\/developer.rdkcentral.com\/support\/#website"},"datePublished":"2026-02-16T11:25:07+00:00","dateModified":"2026-02-16T11:25:23+00:00","breadcrumb":{"@id":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/including-usppa-in-a-device\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/developer.rdkcentral.com\/support\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/developer.rdkcentral.com\/support\/"},{"@type":"ListItem","position":3,"name":"Articles","item":"https:\/\/developer.rdkcentral.com\/support\/support\/articles\/"},{"@type":"ListItem","position":4,"name":"Including UspPa in a device"}]},{"@type":"WebSite","@id":"https:\/\/developer.rdkcentral.com\/support\/#website","url":"https:\/\/developer.rdkcentral.com\/support\/","name":"RDK Documentation Portal | Support","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/developer.rdkcentral.com\/support\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/pages\/10608","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/users\/659"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/comments?post=10608"}],"version-history":[{"count":1,"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/pages\/10608\/revisions"}],"predecessor-version":[{"id":10609,"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/pages\/10608\/revisions\/10609"}],"up":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/pages\/207"}],"wp:attachment":[{"href":"https:\/\/developer.rdkcentral.com\/support\/wp-json\/wp\/v2\/media?parent=10608"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}