zephyr-dfu
Version:
The Capacitor plugin provides an implementation of the McuManager protocol supported by Zephyr.
147 lines (97 loc) • 12.2 kB
Markdown
# zephyr-dfu
This Capacitor plugin provides an implementation of the McuManager protocol supported by Zephyr.
It is based on the following libraries:
Android: https://github.com/NordicSemiconductor/Android-nRF-Connect-Device-Manager
iOS: https://github.com/NordicSemiconductor/IOS-nRF-Connect-Device-Manager
## Install
```bash
npm install zephyr-dfu
npx cap sync
```
Any questions? Mail me at: info@rickgroenewegen.nl
## API
<docgen-index>
* [`updateFirmware(...)`](#updatefirmware)
* [`getVersion(...)`](#getversion)
* [Interfaces](#interfaces)
* [Type Aliases](#type-aliases)
</docgen-index>
<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
### updateFirmware(...)
```typescript
updateFirmware(options: { fileURL: string; deviceIdentifier: string; }, callback: firmwareUpdateCallback) => Promise<CallbackID>
```
| Param | Type |
| -------------- | ------------------------------------------------------------------------- |
| **`options`** | <code>{ fileURL: string; deviceIdentifier: string; }</code> |
| **`callback`** | <code><a href="#firmwareupdatecallback">firmwareUpdateCallback</a></code> |
**Returns:** <code>Promise<string></code>
--------------------
### getVersion(...)
```typescript
getVersion(options: { deviceIdentifier: string; }) => Promise<string>
```
| Param | Type |
| ------------- | ------------------------------------------ |
| **`options`** | <code>{ deviceIdentifier: string; }</code> |
**Returns:** <code>Promise<string></code>
--------------------
### Interfaces
#### String
Allows manipulation and formatting of text strings and determination and location of substrings within strings.
| Prop | Type | Description |
| ------------ | ------------------- | ------------------------------------------------------------ |
| **`length`** | <code>number</code> | Returns the length of a <a href="#string">String</a> object. |
| Method | Signature | Description |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **toString** | () => string | Returns a string representation of a string. |
| **charAt** | (pos: number) => string | Returns the character at the specified index. |
| **charCodeAt** | (index: number) => number | Returns the Unicode value of the character at the specified location. |
| **concat** | (...strings: string[]) => string | Returns a string that contains the concatenation of two or more strings. |
| **indexOf** | (searchString: string, position?: number \| undefined) => number | Returns the position of the first occurrence of a substring. |
| **lastIndexOf** | (searchString: string, position?: number \| undefined) => number | Returns the last occurrence of a substring in the string. |
| **localeCompare** | (that: string) => number | Determines whether two strings are equivalent in the current locale. |
| **match** | (regexp: string \| <a href="#regexp">RegExp</a>) => <a href="#regexpmatcharray">RegExpMatchArray</a> \| null | Matches a string with a regular expression, and returns an array containing the results of that search. |
| **replace** | (searchValue: string \| <a href="#regexp">RegExp</a>, replaceValue: string) => string | Replaces text in a string, using a regular expression or search string. |
| **replace** | (searchValue: string \| <a href="#regexp">RegExp</a>, replacer: (substring: string, ...args: any[]) => string) => string | Replaces text in a string, using a regular expression or search string. |
| **search** | (regexp: string \| <a href="#regexp">RegExp</a>) => number | Finds the first substring match in a regular expression search. |
| **slice** | (start?: number \| undefined, end?: number \| undefined) => string | Returns a section of a string. |
| **split** | (separator: string \| <a href="#regexp">RegExp</a>, limit?: number \| undefined) => string[] | Split a string into substrings using the specified separator and return them as an array. |
| **substring** | (start: number, end?: number \| undefined) => string | Returns the substring at the specified location within a <a href="#string">String</a> object. |
| **toLowerCase** | () => string | Converts all the alphabetic characters in a string to lowercase. |
| **toLocaleLowerCase** | (locales?: string \| string[] \| undefined) => string | Converts all alphabetic characters to lowercase, taking into account the host environment's current locale. |
| **toUpperCase** | () => string | Converts all the alphabetic characters in a string to uppercase. |
| **toLocaleUpperCase** | (locales?: string \| string[] \| undefined) => string | Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale. |
| **trim** | () => string | Removes the leading and trailing white space and line terminator characters from a string. |
| **substr** | (from: number, length?: number \| undefined) => string | Gets a substring beginning at the specified location and having the specified length. |
| **valueOf** | () => string | Returns the primitive value of the specified object. |
#### RegExpMatchArray
| Prop | Type |
| ----------- | ------------------- |
| **`index`** | <code>number</code> |
| **`input`** | <code>string</code> |
#### RegExp
| Prop | Type | Description |
| ---------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`source`** | <code>string</code> | Returns a copy of the text of the regular expression pattern. Read-only. The regExp argument is a Regular expression object. It can be a variable name or a literal. |
| **`global`** | <code>boolean</code> | Returns a Boolean value indicating the state of the global flag (g) used with a regular expression. Default is false. Read-only. |
| **`ignoreCase`** | <code>boolean</code> | Returns a Boolean value indicating the state of the ignoreCase flag (i) used with a regular expression. Default is false. Read-only. |
| **`multiline`** | <code>boolean</code> | Returns a Boolean value indicating the state of the multiline flag (m) used with a regular expression. Default is false. Read-only. |
| **`lastIndex`** | <code>number</code> | |
| Method | Signature | Description |
| ----------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **exec** | (string: string) => <a href="#regexpexecarray">RegExpExecArray</a> \| null | Executes a search on a string using a regular expression pattern, and returns an array containing the results of that search. |
| **test** | (string: string) => boolean | Returns a Boolean value that indicates whether or not a pattern exists in a searched string. |
| **compile** | () => this | |
#### RegExpExecArray
| Prop | Type |
| ----------- | ------------------- |
| **`index`** | <code>number</code> |
| **`input`** | <code>string</code> |
### Type Aliases
#### firmwareUpdateCallback
<code>(msg: <a href="#string">String</a> | null, err?: any): void</code>
#### CallbackID
<code>string</code>
</docgen-api>