ESC configuration APP (AMC Manager v1.1.0)

circle-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).

Download and run the application

  • Downloadarrow-up-right 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

chevron-rightStatus areahashtag

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 ttyx - 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

chevron-rightSetting areahashtag

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

chevron-rightSharing areahashtag

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

chevron-rightPWM Inputhashtag

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

chevron-rightMotion Parametershashtag

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

chevron-rightData and errorshashtag

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

chevron-rightMotor selectionhashtag
  • 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

chevron-rightIdentified motor listhashtag

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)

chevron-rightAdd motorhashtag

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

1

Prepare identification

  • Fill motor params

  • Identify motor

2

Warning - Attention

The identification process must be under constant surveillance during its entire process.

3

Warning - No load motor

The motor must be unloaded during process identification. Remove propellers, shaft, ...

4

Warning - Steps of identification

Details of individual identification steps

5

Confirmation of readiness

Confirm previous warnings

  • Motor without load

  • Full concentration

  • Knowledge of all identification steps

Start identification

6

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

7

No movement step

Accelerates the motor from zero to constant speed

Behavior

  • Stopped motor

  • Production of high frequency noise

Error

  • Stopped motor

8

Acceleration step

Accelerates the motor from zero to constant speed

Behavior

  • Spinning motor

  • Motor speed increase

9

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

10

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

11

Finish step

Identification is complete

Behavior

  • Stopped motor

  • Completed identification

Error

  • Spinning motor

12

Save motor

  • Fill motor name

  • Save the motor list and set as the actual motor type

13

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


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

chevron-rightTelemetryhashtag

Displays telemetry data from the device.

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

chevron-rightControlhashtag

Motor control over the control range <-100%, 100%>

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 linkarrow-up-right

Update connected device

The firmware on the connected device is being updated

1

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

2

Select the firmware file

File with extension .bin

3

Start update

Press the Update button

4

Updating

Auto-connecting step

  • Device is restarted

  • Auto reconnect

Writing firmware step

  • Write new Firmware to the ESC flash

5

Successful update

Start the device with new firmware


Update via bootloader

The device in bootloader mode is used for updating

1

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

2

Connected to Alink

Connect device via Alink (Serial link)

3

Select the firmware file

File with extension .bin

4

Start update

Press the Update button

5

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

6

Updating

Writing firmware step

  • Write new Firmware to ESC flash

7

Successful update

Start device with new firmware

Last updated