Direct Energy Partners allows customers to develop their own applications for microgrids. By creating an Energy Management System (EMS) or Power Management System (PMS),
customers can customize solutions to fit their specific energy needs. This guide details the process of developing custom applications using the NATS protocol to interact with the DCIDE Controller.To assist customers in starting their application development, we have created a starter repository called dep-ppl-app.
This repository includes all the necessary files and examples to help you get started. Below, you will find detailed instructions on how to fork, clone and modify the files in the repository,
as well as how to run the application and write custom code using the built-in functions.
This is a live document and is updated regularly. For the latest version, always refer to the online documentation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DCIDE Controller Documentation","colors":{"primary":"#26A9E0","light":"#26A9E0","dark":"#26A9E0"},"logo":{"light":"https://mintcdn.com/directenergypartners/GRZeYba0GypZc-XC/logo/dcide_controller_logo_black.svg?fit=max\u0026auto=format\u0026n=GRZeYba0GypZc-XC\u0026q=85\u0026s=aea9e1b855eda8649eb8a80bed74b169","dark":"https://mintcdn.com/directenergypartners/GRZeYba0GypZc-XC/logo/dcide_controller_logo_white.svg?fit=max\u0026auto=format\u0026n=GRZeYba0GypZc-XC\u0026q=85\u0026s=9743c74c634428ee99ff977325abaedf"},"favicon":"https://mintcdn.com/directenergypartners/U69FgpALENZ6o9ub/favicon.svg?fit=max\u0026auto=format\u0026n=U69FgpALENZ6o9ub\u0026q=85\u0026s=9e1453db5da84f0a1a3d12f12da0bd99","navbar":{"links":[{"href":"mailto:pplsupport@directenergypartners.com","label":"Support"}],"primary":{"type":"button","label":"Learn More","href":"https://directenergypartners.com/controller"}},"footer":{"socials":{"website":"https://directenergypartners.com/controller","linkedin":"https://www.linkedin.com/company/direct-energy-partners","youtube":"https://www.youtube.com/@dcmicrogriddesignandengine5189"}},"seo":{"metatags":{"og:title":"DCIDE Controller Documentation","og:description":"Complete documentation for the DCIDE Controller - installation, configuration, custom applications, and commissioning guides."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"directenergypartners","hasAudioNarration":false,"actualSubdomain":"directenergypartners","customDomains":["docs.directenergypartners.com"],"gitSource":{"type":"github","owner":"direct-energy-partners","repo":"ppl-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac8d7caed8c5d5a673a2df5","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"File Configuration","count":32},{"language":"default","tag":"Device Types","count":19},{"language":"default","tag":"Custom Applications","count":11},{"language":"default","tag":"Devices File","count":10},{"language":"default","tag":"Address Map Files","count":9},{"language":"default","tag":"Installation","count":9},{"language":"default","tag":"Commission","count":8},{"language":"default","tag":"PPL-BASE Repository","count":6},{"language":"default","tag":"Settings","count":6},{"language":"default","tag":"Getting Started","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"custom-applications","slug":"/custom-applications","pageMetadata":{"title":"Introduction","description":null,"href":"/custom-applications/index"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Direct Energy Partners allows customers to develop their own applications for microgrids. By creating an `,_jsx(_components.strong,{children:`Energy Management System (EMS)`}),` or `,_jsx(_components.strong,{children:`Power Management System (PMS)`}),`,\ncustomers can customize solutions to fit their specific energy needs. This guide details the process of developing custom applications using the `,_jsx(_components.strong,{children:`NATS`}),` protocol to interact with the DCIDE Controller.`]}),`\n`,_jsxs(_components.p,{children:[`To assist customers in starting their application development, we have created a starter repository called `,_jsx(_components.code,{children:`dep-ppl-app`}),`.\nThis repository includes all the necessary files and examples to help you get started. Below, you will find detailed instructions on how to fork, clone and modify the files in the repository,\nas well as how to run the application and write custom code using the built-in functions.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`This is a live document and is updated regularly. For the latest version, always refer to the online documentation.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Introduction","description":null,"href":"/custom-applications/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"directenergypartners","siteName":"DCIDE Controller Documentation","title":"DCIDE Controller Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T15:09:14.145Z","originalFileLocation":"custom-applications/index.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"DCIDE Controller Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"DCIDE Controller Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Complete documentation for the DCIDE Controller - installation, configuration, custom applications, and commissioning guides.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DCIDE Controller Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.directenergypartners.com/custom-applications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://directenergypartners.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Introduction\u0026amp;theme=e65adbd682a0369dc859b3a5\u0026amp;signature=5d402e3e9c66dcf6f029c8b2e3071440b1d0b81a293b54a7836530621b6e7dbe\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"DCIDE Controller Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Complete documentation for the DCIDE Controller - installation, configuration, custom applications, and commissioning guides.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://directenergypartners.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Introduction\u0026amp;theme=e65adbd682a0369dc859b3a5\u0026amp;signature=5d402e3e9c66dcf6f029c8b2e3071440b1d0b81a293b54a7836530621b6e7dbe\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/directenergypartners/S-ynqS2wzs2juhvd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DCIDE Controller Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#26A9E0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.directenergypartners.com/custom-applications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/custom-applications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.directenergypartners.com/#organization\",\"name\":\"DCIDE Controller Documentation\",\"url\":\"https://docs.directenergypartners.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/directenergypartners/GRZeYba0GypZc-XC/logo/dcide_controller_logo_black.svg?fit=max\u0026auto=format\u0026n=GRZeYba0GypZc-XC\u0026q=85\u0026s=aea9e1b855eda8649eb8a80bed74b169\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.directenergypartners.com#website\",\"name\":\"DCIDE Controller Documentation\",\"url\":\"https://docs.directenergypartners.com\",\"publisher\":{\"@id\":\"https://docs.directenergypartners.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.directenergypartners.com/custom-applications#webpage\",\"url\":\"https://docs.directenergypartners.com/custom-applications\",\"name\":\"Introduction\",\"dateModified\":\"2026-10-08T15:09:14.145Z\",\"isPartOf\":{\"@id\":\"https://docs.directenergypartners.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.directenergypartners.com/custom-applications#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.directenergypartners.com/custom-applications#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"DCIDE Controller Documentation\",\"item\":\"https://docs.directenergypartners.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.directenergypartners.com/custom-applications\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.directenergypartners.com/custom-applications#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"url\":\"https://docs.directenergypartners.com/custom-applications\",\"mainEntityOfPage\":{\"@id\":\"https://docs.directenergypartners.com/custom-applications#webpage\"},\"dateModified\":\"2026-10-08T15:09:14.145Z\",\"publisher\":{\"@id\":\"https://docs.directenergypartners.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.directenergypartners.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DCIDE Controller Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DCIDE Controller Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/custom-applications.md","siteName":"DCIDE Controller Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Installation","pages":[{"title":"Installation","href":"/installation"}]},{"tab":"File Configuration","pages":[{"title":"File Configuration","href":"/configure"}]},{"tab":"Custom Applications","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/custom-applications"},{"title":"What is NATS?","description":null,"href":"/custom-applications/nats"}]},{"group":"PPL-APP Repository","pages":[{"title":"Introduction","href":"/custom-applications/repository/index"},{"title":"Fork Repository","href":"/custom-applications/repository/fork"},{"title":"Clone Repository","href":"/custom-applications/repository/clone"}]},{"group":"Custom Application","pages":[{"group":"Write Application","pages":[{"title":"Main Script","href":"/custom-applications/application/write/boilerplate"},{"title":"Module Functions","href":"/custom-applications/application/write/module-functions"},{"title":"Integrations","href":"/custom-applications/application/write/integrations"}]},{"group":"Run Application","pages":[{"title":"On Local Machine","href":"/custom-applications/application/run/local"},{"title":"On DCIDE Controller","href":"/custom-applications/application/run/controller"}]}]},{"group":"Examples","pages":[{"title":"Target SOC","href":"/custom-applications/examples/target-soc"}]}]},{"tab":"Commission","pages":[{"title":"Commission","href":"/commission"}]}]},"basePath":"","title":"DCIDE Controller Documentation","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}