# ESC configuration APP (AMC Manager v1.1.0)
{% hint style="info" %}
AMC Manager is an application for setting up, managing and testing the ESC. The application is built on the Qt platform, and communication with the ESC takes place via a serial port. AMC Manager runs on the host PC (Win/Linux).
{% endhint %}
#### Download and run the application
* [Download](https://github.com/airvolute/DroneCore.Suite/tree/main/DroneCore.Suite/DroneCore.Power/Applications/AMC_manager) the up-to-date application version according to your host PC operating system
* Unpack archive
* Run application
* For Linux Host, open the terminal in the unpacked folder and execute `./AMC_Manager`
* For Windows PC, open the unpacked folder and run AMC\_Manager.exe
## Application manual
***
## Control Panel
Status area
.png?alt=media)
**Connection status**
* *Disconnected* - device is not connected to the app
* *Connected* - device is in service mode (motor identification is possible)
* *Running* - device is in operating mode
* *Flashing* - device is being updated
**Serial port status**
* *Name*
* for Windows - `COM` port
* for Linux - `tty` port
* *Select port* - no connection to serial port
* Manual selector
* Auto select with Alink
* *Connecting* - establishing communication with the serial port
* \*`COM`\***x** or `tty`**x** - connected to COM port (with number '**x**')
**Device status**
* *No device* - no device is connected
* *Device* **x** - connected device with address '**x**'
* *Non-init device* - unconnected device in bootloader mode
**FW version**
* **x**.**y**.**z** - '**x**' - major version, '**y**' - mid version, '**z**' - minor version
* *Boot* - bootloader mode
Setting area
Tabs with settings, control and update are located in this area.
**ESC Params**
* Configuration of ESC parameters
**Motor Params**
* Configuration of motor parameters and motor identification
**Control**
* Testing the ESC and the motor through the app
**Firmware**
* ESC firmware update
Sharing area
This area is used to import and export the overall ESC settings to/from the motor. This area is **disabled** when the device is **disconnected**.
**Import params**
* Saving the image of the parameters of the ESC and motor to a file
**Export params**
* Upload the settings image with the parameters of the ESC and motor to the ESC from a file
## Operational Panel
### ESC Params
PWM Input
Setting the parameters of the input signal.
***
**Pwm Type**
* The effect of the signal on the one-way or two-way rotation of the motor
* Value: Unipolar or bipolar
* Predefined value = **Unipolar**
~~**Low Level**~~ *(not supported)*
~~**Center Level**~~ *(not supported)*
~~**High Level**~~ *(not supported)*
**Dead Zone**
* The initial part of the signal where the motor does not run
* Value = <5; 20>, Step = 1 %
* Predefined value = **5**
***
**Control Type**
* Desired quantity for control
* Value = Speed
* Predefined value = **Speed**
**Max Speed**
* Maximum motor revolutions for the upper input signal
* Value = <10; 40950>, Step = 10 RPM
***
**Analog Control** *(not supported)*
**Digital control** *(not supported)*
***
**Graph**
* Showing the speed range in relation to the standard control range
Motion Parameters
Setting parameters for adjusting the movement and dynamics of ESC
**Reverse Direction**
* Changing the direction of motor movement
* Predefined value = **False**
**Device Address**
* Address of the ESC device
* Value = <0;3> or fixed (Determined by HW configuration)
**Time to leave**
* The time during which, in the event of a signal failure, it holds the last setpoint
* Value = <150; 2000>, Step = 50 ms
* Predefined value = **150**
**Controller Kp**
* Setting the proportional component of the controller
* Value = <0.0; 65.353>, Step = 0.001
* Predefined value = **1.0**
**Controller Kff**
* Setting the feed-forward component of the controller
* Value = <0.0; 65.353>, Step = 0.001
* Predefined value = **1.5**
Data and errors
Basic information from the ESC and handling errors of ESC
**Get Errors**
Read the structure of errors and warnings from the device
* **All Errors**
* Every error and warning since the last cleaning, regardless of the power cycle
* Contains:
* Errors with the hexadecimal code
* List of individual errors
* Warnings with the hexadecimal code
* List of individual warnings
* **Previous Errors**
* Every error and warning from the previous power cycle
* Contains:
* Errors with the hexadecimal code
* List of individual errors
* Warnings with the hexadecimal code
* List of individual warnings
* **Last Errors**
* Every error and warning in the current power cycle
* Contains:
* Errors with the hexadecimal code
* List of individual errors
* Warnings with the hexadecimal code
* List of individual warnings
**Clear Errors**
Clear only the category All Errors from the device
**Get Data**
Information about currents and temperatures from the last run
* Max Temp ESC - maximum temperature of ESC
* Max temp Motor - maximum temperature of the motor
* Avg current - average current during the run
* Max current - maximum current during the run
**Get Resist**
Information about total resistance and phase resistance
* Phase A - phase A resistance
* Phase B - phase B resistance
* Phase C - phase A resistance
* Global - total resistance
### Motor Params
Motor selection
* Motor control on the ESC is conditioned by motor identification
* Identification **must be** performed for each **motor type**
* Identified params can be applied to all motors of the same type
**New** **motor**
New **type** of motor
* Motor must be identified - Add motor
New **piece** of motor
* Unknown motor type (*new type of motor*)
* Motor must be identified - Add motor
* Known motor type (*motor type has already been identified*)
* Individual motors of the same type may have minimal differences in parameters
* Normal use - Neglecting minimal params differences
* Select from motor list - Motor list
* Special use - Elimination of minimal params differences
* Motor identification - Add motor
**Used** **motor**
Used locally (*this computer*)
* Select from motor list - Motor list
Get from another place or restore
* Load from file to motor list - Import motors
Share for other place or backup
* Save to file from motor list - Export motors
Identified motor list
Contains a list of user-identified motors and the management of this list.
**Actual motor type**
* Selected name from the list
* Sets the selected motor from the list to ESC as the actual motor
* Non-existent motor is named `Unknown motor xx`
**Motor hours**
* Number of operating hours since the last motor change
**Motor list**
* List of identified and imported motors with creation time
* Motor name is local and user-defined
* Click on the header to sort the list
**Set motor**
* Setting a new actual engine from the list
**Rename motor**
* Rename the selected motor in the list
**Remove motor**
* Remove the selected motor from the list
**Info Motor**
* Information on motor identification parameters
**Import Motors**
* Imports motors from the file into the local database
* Merging options
* *Overwrite* - Delete all motors in the list and use the new ones
* *Append* - Add new ones to the list and use new ones in case of a name conflict
* File extension `.ms` (motor specification)
**Export Motors**
* Exporting motor from the local database to a file
* Options
* *All* - Exports all motors from the list
* *Selected* - Exports only a single selected motor (No selection = Disabled option)
* Contains: Motor Name, Creation Time and Motor Parameters
* File extension `.ms` (motor specification)
Add motor
Setting motor parameters to identify and enable this process
**Max current**
* Maximum continuous current in A according to the motor datasheet
**Kv**
* Motor velocity constant in rpm/V according to the motor datasheet
**LiPo cells**
* Motor operating voltage expressed in LiPo cells (Full cell voltage = 4.2V)
* Example - Battery type: **6S** => LiPo cells: **6**
**Pole pairs**
The number of pole pairs in the permanent magnet in the motor
* Example - **12P14N** => (use N number)/2 => Pole pairs: **7**
* Example - **10 poles** => poles/2 => Pole pairs: **5**
* Example - **11 pole pairs** => Pole pairs: **11**
**Identify motor**
* **Start** of the motor identification process with the **parameters defined above**
### Identification process
{% stepper %}
{% step %}
**Prepare identification**
* Fill motor params
* Identify motor
{% endstep %}
{% step %}
**Warning - Attention**
The identification process must be under constant surveillance during its entire process.
{% endstep %}
{% step %}
**Warning - No load motor**
The motor must be unloaded during process identification. Remove propellers, shaft, ...
{% endstep %}
{% step %}
**Warning - Steps of identification**
Details of individual identification steps
{% endstep %}
{% step %}
**Confirmation of readiness**
Confirm previous warnings
* Motor without load
* Full concentration
* Knowledge of all identification steps
Start identification
{% endstep %}
{% step %}
**Identification interface**
**Current step** - Name of current identification step
**Help** - Identification interruption in case of an error
**Warning label** (*default hidden*) - Detection of a possible problem during identification - Please interrupt identification
**Progress bar** - Progress in the current step
**Right behaviour** - Expected action in the current step
**Errors** - Errors that may occur in the current step
**Next step** - Information about the next step
**Cancel** - Identification interruption
{% endstep %}
{% step %}
**No movement step**
Accelerates the motor from zero to constant speed
**Behavior**
* Stopped motor
* Production of high frequency noise
**Error**
* Stopped motor
{% endstep %}
{% step %}
**Acceleration step**
Accelerates the motor from zero to constant speed
**Behavior**
* Spinning motor
* Motor speed increase
{% endstep %}
{% step %}
**Variable speed step**
Performs measurements while the motor is running, causing speed fluctuations
**Behavior**
* Spinning motor
* Change in motor speed (increase and decrease), but not zero
**Error**
* Stopped motor
{% endstep %}
{% step %}
**Deceleration step**
Decelerates the motor from constant speed to zero
**Behavior**
* Spinning motor
* Motor speed decrease
* Too short a stage
* May not display
**Errors**
* Stopped motor on start
* Spinning motor on end
{% endstep %}
{% step %}
**Finish step**
Identification is complete
**Behavior**
* Stopped motor
* Completed identification
**Error**
* Spinning motor
{% endstep %}
{% step %}
**Save motor**
* Fill motor name
* Save the motor list and set as the actual motor type
{% endstep %}
{% step %}
**Error (in case of error)**
**Interrupt identification - no warning label**
Interruption without cause
* Cancel and update params
* Repeat identification with the same params
Step Acceleration - without increasing speed
* Probably bad params: Pole pairs or Kv
* Cancel and update params
Step Variable speed - motor stops spinning
* Probably bad params: Low value of Max current
* Cancel and update params
**Interrupt identification - with a warning label**
Perform adjustment of internal params by self-diagnostics
* Correction of identification
Step Acceleration - without increasing speed
* Probably bad params: Pole pairs or Kv
* Cancel and update params
Step Variable speed - motor stops spinning
* Probably bad params: Low value of Max current
* Cancel and update params
{% endstep %}
{% endstepper %}
***
### Control
Control is used to verify the ESC control with the motor through the application.
* Permitting conditions
* PWM Input in `Analog control`
* Allow the device to switch to status `Running`
Telemetry
Displays telemetry data from the device.
.png?alt=media)
**Telemetry quantities**
* Speed - Mechanical motor speed
* Vs - Motor voltage
* Vdc - Supply ESC voltage
* Power - Motor power
* Torque - Motor torque
* Is - Motor current
* Pwm - Pwm duty of control signal
* Rs - Global resistance
* Flux - Motor magnetic flux
* Temp - ESC temperature
**Graph**
* Displays two quantities simultaneously
* The quantity is plotted continuously, but it can be stopped
Control
Motor control over the control range <-100%, 100%>
.png?alt=media)
**Enable control**
* Allows you to start motor control
**Controller**
* Start point 0%
* Boundary points - -100%, 100%
* Increment - 1%
**Dead band**
* Dead zone in the range around the starting point
* Very low speeds can make the motor standstill
## Firmware
Firmware update or upload via bootloader
Check this link for up-to-date firmware version for the ESC: [Download link](https://github.com/airvolute/DroneCore.Suite/tree/main/DroneCore.Suite/DroneCore.Power/ESC_Firmware)
### Update connected device
The firmware on the connected device is being updated
{% stepper %}
{% step %}
**Check device status**
**Connected**
* Suitable condition for continuing the update
**Running**
* Perform a power cycle on the device
* Connect to the app
**Disconnected**
* With firmware
* Power on the device
* Connect to the app
* No firmware
* Use Update via bootloader
{% endstep %}
{% step %}
**Select the firmware file**
File with extension `.bin`
{% endstep %}
{% step %}
**Start update**
Press the `Update` button
{% endstep %}
{% step %}
**Updating**
Auto-connecting step
* Device is restarted
* Auto reconnect
Writing firmware step
* Write new Firmware to the ESC flash
%20\(1\)%20\(1\).png?alt=media)
{% endstep %}
{% step %}
**Successful update**
Start the device with new firmware
{% endstep %}
{% endstepper %}
***
### **Update via bootloader**
The device in bootloader mode is used for updating
{% stepper %}
{% step %}
**Check device state**
* Device must be powered off
* *Device controlled via esc\_configuration\_app in Jetson, the power off is achieved by the next (or first) step in the application*
{% endstep %}
{% step %}
**Connected to Alink**
Connect device via Alink (Serial link)
{% endstep %}
{% step %}
**Select the firmware file**
File with extension `.bin`
{% endstep %}
{% step %}
**Start update**
Press the `Update` button
{% endstep %}
{% step %}
**Power on the device**
* Power on the device within 10 seconds
* *Device controlled via esc\_configuration\_app in Jetson, the power on is achieved by the next step in the application*
* Elapsed time is displayed by a progress bar
{% endstep %}
{% step %}
**Updating**
Writing firmware step
* Write new Firmware to ESC flash
.png?alt=media)
{% endstep %}
{% step %}
**Successful update**
Start device with new firmware
{% endstep %}
{% endstepper %}
---
# Agent Instructions: 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:
```
GET https://docs.airvolute.com/autopilots/dronecore-1/getting-started/motor-connection/amc_manager-1.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
%20(1)%20(1).png?alt=media)
%20(1).png?alt=media)
.png?alt=media)
%20(1).png?alt=media)
.png?alt=media)
.png?alt=media)
%20(1).png?alt=media)
%20(1).png?alt=media)
%20(1).png?alt=media)
%20(1).png?alt=media)
%20(1).png?alt=media)
%20(1).png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
%20(1).png?alt=media)