2021 - Lishui Controller Programming

Technical Overview: Lishui Controller Programming Programming Lishui (LSDZS) e-bike controllers involves either using the manufacturer's proprietary tools for parameter updates or flashing third-party open-source firmware for Field Oriented Control (FOC) and deeper customization. 1. Official Programming Methods

Lishui provides specialized hardware and software for basic updates and configuration of their controllers.

Software Tools: The LSH File Update Tools are used to download .lsh firmware files into the controller.

Hardware Requirements: Programming typically requires a Lishui USB Programmer. Newer versions (post-Sept 2015) can power the controller via the USB port, while older versions require the controller to be powered by the bike battery during the flash.

Parameter Tuning: Using the official programmer, users can uncheck the "Keep Current Settings" box to modify limits such as maximum current and cutoff voltage. 2. Open-Source and Third-Party Firmware

For advanced users seeking to bypass factory restrictions or improve motor smoothness, several community projects exist. I have a Lishui Controller .lsh firmware file lets mod it

To program a Lishui controller, you typically use a dedicated USB programmer and the official LSH_File_Update_Tools software. This allows you to flash firmware files (with a .lsh extension) or adjust critical parameters like current and voltage limits. 🛠️ Hardware Requirements

Lishui USB Programmer: A specialized stick that connects your PC to the controller's display port.

Connection Cable: Typically a 5-pin extension or adapter cable.

Computer: Running Windows to host the Lishui programming software. 💻 Software Setup

Install Drivers: Run the device driver installer provided by Lishui before plugging in the USB stick.

Verify Connection: Open the programming software; the "Ports" area should show a COM number (e.g., COM3) if the driver is correctly installed.

Load Firmware: Click "Local File" to select your .lsh firmware file.

Tip: Uncheck "Keep Current Settings" if you want to manually adjust max current or undervoltage limits before flashing. ⚡ The Programming Process

Power Source: Newer USB programmers (post-2015) often use "USB boost power" and don't require the e-bike battery during flashing. Older versions require you to switch on the battery power after hitting the program button. Flash Action: Press Program (F5) to begin the upload.

Completion: Once finished, power cycle the controller (turn the display off and on) to save and activate the new settings permanently. 🔓 Advanced Customization

Open Source Firmware: For deep customization (like Sine Wave/FOC control), some users flash EBiCS/EBiCS_Firmware from GitHub using an STLink V2 instead of the standard USB tool.

Hidden Menus: On some Lishui-compatible LCDs, holding "+" and "-" simultaneously enters a parameter menu (often P08 for speed limits). If you'd like to dive deeper, let me know: What is your specific controller model? (e.g., LSW1250)

Are you trying to increase speed, change PAS levels, or fix a bug? Do you have the USB programming stick?

Lishui Controller LSH Programmer User's Manual Hardware List

Lishui controllers are typically "OEM-locked," meaning they are programmed at the factory for specific bike models and aren't as easily customizable as KT (Kunteng) controllers. However, you can modify them using specialized hardware, manufacturer tools, or community-developed open-source firmware. 🛠️ Programming Methods 1. Official Lishui Programming Tool

This is the standard "manufacturer" way to update firmware or change basic limits.

Hardware Needed: You require a specific Lishui USB Stick FPS2 and matching adapter cables.

Software: The Lishui Controller LSH Programmer allows you to upload .lsh firmware files and adjust max current or undervoltage limits.

Limitation: These tools are difficult for individual consumers to find and are mostly sold to retailers or manufacturers. 2. Open Source Firmware (OSF)

The CloneYCRS project on GitHub is the most popular way to "unlock" these controllers.

What it does: Replaces the factory software with Field Oriented Control (FOC) firmware that is fully customizable.

Features: Includes a user-friendly GUI to adjust throttle response, torque simulation, and sensor settings.

Hardware: You typically need an ST-Link V2 programmer to flash the firmware directly to the controller's internal chip. 3. Display-Based "Hidden" Menus

For minor adjustments like speed limits or wheel size, you can sometimes use the LCD display.

Access: On many models, holding the Up and Down arrows simultaneously enters the settings mode.

Parameters: Settings are often unlabelled (e.g., #1 to #20). For example, setting #18 often adjusts the speed reading/limit between 50% and 150%. ⚠️ Key Challenges

Potting Material: Many Lishui controllers are filled with a thick "glue" or wax-like potting to protect against water, which can make accessing the internal pins for a programmer nearly impossible.

Hardware Variants: Different models use different processors (like the STM32 series). You must verify your specific chip before trying to flash custom firmware to avoid "bricking" the unit.

Baud Rate: If using a PC tool, the default baud rate is typically 38400. If you'd like to proceed, let me know: Your controller model number (e.g., LSW1207)

What specific change you want to make (e.g., increase speed, change PAS levels) lishui controller programming

If you are comfortable with soldering or using an ST-Link device

I can then provide a more specific step-by-step guide for your setup.

Deuin/CloneYCRS: Free FOC firmware for Lishui E-Bike-Controllers

Lishui controllers (LS), manufactured by the Nanjing Lishui Electronics Research Institute, are widely used in e-bikes for their smooth Field-Oriented Control (FOC) performance. Programming these units allows riders to fine-tune torque delivery, adjust current limits, and even install custom open-source firmware. Essential Programming Tools

To interface with a Lishui controller, you need specific hardware to bridge the gap between your computer and the controller’s display or programming port:

USB-to-Serial Adapter: A standard FT232RL-based adapter is the industry standard for stable communication.

Programming Cable: Depending on your controller model, you may need a Julet 5-pin or 4-pin waterproof connector cable that breaks out into RX, TX, GND, and VCC.

ST-Link V2 (Optional): Required for flashing deep firmware or unbricking controllers that do not have a bootloader accessible via the display port. The Official Programming Process

Official programming is typically done using the Lishui LSH_File_Update_Tools. This utility allows you to upload .lsh firmware files provided by manufacturers or tech teams.

Driver Setup: Install the appropriate USB serial drivers. If the software shows a COM port number, the connection is successful.

Connection: Connect the adapter to the controller's display port. Most modern controllers can be "self-powered" by the USB port, but older versions require the e-bike battery to be connected and switched on during the process.

Loading Firmware: Use the "Local File" button to load your .lsh file.

Adjusting Basic Settings: By unchecking the "Keep Current Settings" box, users can often manually adjust the maximum current and undervoltage cutoff limits before flashing.

Flashing: Press Program (F5) and wait for the "Write successful" confirmation. Third-Party & Open-Source Options

For advanced users, the official software can be restrictive. Several community-driven alternatives exist:

EggRider V2 Display: A popular aftermarket display that allows you to configure Lishui settings directly from a smartphone app via Bluetooth.

EBiCS Open Source Firmware: A community project on GitHub that provides free FOC firmware for Lishui controllers, offering features like regenerative braking and customized torque sensing.

XPD (Extended Parameter Designer): Older software used for some sine wave controllers to adjust ramp times and PAS (Pedal Assist) sensitivity. I have a Lishui Controller .lsh firmware file lets mod it

Lishui controllers are a staple in the e-bike industry, known for their versatility and smooth Field-Oriented Control (FOC). Whether you're looking to tweak speed limits, adjust pedal assist (PAS) sensitivity, or completely overhaul the system with open-source firmware, understanding Lishui controller programming is the key to unlocking your bike's full potential. Programming Methods: From Basic to Advanced

There are three primary ways to modify a Lishui controller, ranging from simple display settings to deep firmware flashing. 1. Display-Based Parameter Tuning

For most riders, "programming" happens via the e-bike’s LCD display (e.g., SW900, EN06, or KingMeter). This method allows you to change behavior without extra hardware.

Access: Usually involves holding the "Up" and "Down" buttons simultaneously for a few seconds. Key Parameters: P03/P08: Voltage and Speed limits. P05/P09: PAS levels and magnet counts. P13: Maximum amperage (current) for the controller. 2. Official Lishui Programming Software

If display settings aren't enough, you can use Lishui’s official LSH_File_Update_Tools. This requires a dedicated USB-to-serial programming cable (often called a "USB Stick FPS2") that connects to the 5-pin display port on the controller.

The .LSH File: Official firmware updates come in .lsh format.

Secret Menus: Users have discovered that clicking the "Clear Info" button multiple times in the official tool can unlock a "File Conversion" menu for advanced configurations. 3. Open Source Firmware (EBiCS)

For enthusiasts who want total control—like adding torque sensor support or regenerative braking—the EBiCS (Lishui Open Source Firmware) project is the gold standard.

Hardware Required: An ST-Link V2 programmer is needed to flash the STM32 chip inside the controller directly.

Key Advantage: You can bypass manufacturer restrictions, customize throttle curves, and even optimize for specific motors using a user-friendly GUI. Step-by-Step: Programming via USB Tool I have a Lishui Controller .lsh firmware file lets mod it

Lishui controllers are widely used in e-bikes and can be programmed using official tools or open-source alternatives. Programming typically involves adjusting hardware parameters or flashing new firmware to modify performance characteristics like speed limits and current levels Endless Sphere DIY EV Forum Official Programming Methods Official programming is generally done using the Lishui Controller Programmer software and a dedicated USB-to-serial adapter. opensourceebikefirmware.bitbucket.io Software & Hardware Lishui Programmer : The official Program Downloader is used to upload firmware files provided by the manufacturer or tech teams. USB Programmer

: A standard USB-to-TTL adapter or a specific Lishui programmer is used to connect the computer to the controller's display port. Bluetooth App

: Some modern Lishui controllers support programming via a smartphone app (iOS/Android), allowing users to adjust settings like current and language through a user-friendly interface. Key Programming Steps

Install the necessary USB drivers for your programming device.

Connect the programmer to the controller's display connector (ensure the battery is disconnected initially unless using a newer USB boost-powered programmer). Load the desired file into the software.

Execute the "Program" command. Some versions require turning on battery power mid-process to initiate the flash. www.pedelecs.co.uk Open Source Firmware (OSF)

Many enthusiasts use open-source projects to bypass factory restrictions, such as speed locks or rigid throttle mapping. Endless Sphere DIY EV Forum EBiCS Firmware : A popular open-source project on Programming languages : Lishui controllers can be programmed

specifically for Lishui FOC (Field Oriented Control) controllers. It allows for highly customized motor control and removes standard speed limits. Alternative Tools : A specialized display that can directly modify Lishui settings

(LSW settings) without a PC, including current limits and assist levels.

: For advanced firmware modifications or if the controller is read/write protected, a hardware programmer like an ST-Link V2 may be required to flash the microcontroller directly. Endless Sphere DIY EV Forum Key Settings Often Modified Current Limit

: Adjusts the maximum power output (measured in Amps) the controller will pull from the battery. Voltage Cutoff

: Sets the low-voltage limit to protect the battery from over-discharging. Assistance Levels

: Defines how much motor power is provided at various pedal-assist stages. Speed Limit

: Lishui controllers often come with a factory limit that can be adjusted or removed via the firmware update tools. Endless Sphere DIY EV Forum wiring guide for the USB adapter or instructions on how to set up the EBiCS open-source firmware Lishui Controller Program Downloader Instruction

Programming a Lishui e-bike controller involves using proprietary or open-source software to modify motor performance, battery management, and rider assistance settings. The process typically requires a specialized USB programming device Bluetooth adapter to interface with the controller’s hardware. www.pedelecs.co.uk Core Programming Methods LSH File Downloader : The official tool from Lishui Electronics used to flash firmware files (with the extension). It includes a "secret" menu for File Conversion

(converting hex to .LSH) by clicking the "Clear Info" button multiple times. Bluetooth App Programming

: Some newer controllers or those equipped with a Bluetooth adapter can be configured via a smartphone app (iOS/Android), allowing users to adjust settings through a simplified interface. Open-Source Firmware (EBiCS) : For advanced users, projects like EBiCS_Firmware on GitHub

provide free Field Oriented Control (FOC) firmware that enables extensive customization, such as adding regenerative braking or torque sensor support. Key Programmable Features

Programming allows you to fine-tune the following parameters: Motor Performance

Current limits, speed limits, torque simulation, and startup acceleration. Battery Management

Voltage cutoff bases (e.g., 31.5V for 36V batteries) and under-voltage protection. Pedal Assist (PAS)

PAS type (left/right mounting), number of magnets, and assist pulse delay. Riding Strategy

Selection between "Normal" or "Current Simulation" modes to change how power is delivered. Hardware Requirements Program Downloader

Unlocking the Potential of Lishui Controller Programming: A Comprehensive Guide

Lishui controller programming is a rapidly evolving field that has gained significant attention in recent years. As the demand for efficient and reliable control systems continues to grow, understanding the intricacies of Lishui controller programming has become essential for engineers, developers, and enthusiasts alike. In this article, we will delve into the world of Lishui controller programming, exploring its fundamental concepts, applications, and future prospects.

What is Lishui Controller Programming?

Lishui controller programming refers to the process of designing, developing, and implementing software for Lishui controllers, which are electronic devices used to regulate and monitor various industrial processes. These controllers are widely used in a range of applications, including robotics, automation, and process control systems.

Key Concepts and Principles

To grasp the basics of Lishui controller programming, it's essential to understand the following key concepts:

• Programming languages: Lishui controllers can be programmed using various languages, such as C, C++, and ladder logic.
• Controller architecture: Lishui controllers typically consist of a microcontroller, memory, and input/output (I/O) interfaces.
• Programming tools: Specialized software tools, such as Lishui's proprietary programming environment, are used to develop and debug Lishui controller programs.

Applications of Lishui Controller Programming

Lishui controller programming has a wide range of applications across various industries, including:

• Industrial automation: Lishui controllers are used to control and monitor industrial processes, such as manufacturing, processing, and packaging.
• Robotics: Lishui controllers are used in robotics to control robot movements, interactions, and tasks.
• Process control systems: Lishui controllers are used to regulate and monitor process control systems, such as temperature, pressure, and flow control.

Benefits and Advantages

Lishui controller programming offers several benefits and advantages, including:

• Improved efficiency: Lishui controllers can optimize industrial processes, reducing energy consumption and increasing productivity.
• Enhanced reliability: Lishui controllers can detect and respond to faults, minimizing downtime and improving overall system reliability.
• Flexibility and customization: Lishui controller programming allows for customization and flexibility, enabling developers to tailor control systems to specific applications.

Future Prospects and Trends

The field of Lishui controller programming is rapidly evolving, with several trends and future prospects emerging:

• Internet of Things (IoT) integration: Lishui controllers are being integrated with IoT technologies, enabling remote monitoring and control.
• Artificial intelligence (AI) and machine learning (ML): AI and ML techniques are being applied to Lishui controller programming, enabling predictive maintenance and optimized control.
• Cybersecurity: As Lishui controllers become increasingly connected, cybersecurity is becoming a growing concern, with developers focusing on secure programming practices.

Conclusion

Lishui controller programming is a fascinating field that offers a wide range of opportunities for engineers, developers, and enthusiasts. By understanding the fundamental concepts, applications, and future prospects of Lishui controller programming, individuals can unlock the potential of these control systems and contribute to the development of innovative solutions. Whether you're a seasoned professional or just starting out, the world of Lishui controller programming is an exciting and rewarding field to explore.

To program a Lishui e-bike controller , the best "piece" or resource depends on whether you want to stick with official tools or dive into open-source customization. 1. Official Lishui Programming Tool

The standard way to update or adjust a Lishui controller is using the official LSH_File_Update_Tools.

Purpose: Primarily for flashing .lsh firmware files provided by manufacturers or Lishui’s tech team.

Key Feature: By unchecking the "Keep Current Settings" box, you can modify basic parameters like maximum current and undervoltage limits directly.

Secret Menu: Clicking the "Clear Info" button multiple times within the tool reveals a hidden "File Conversion" menu for converting hex files to .lsh format. Inputs: Start_PB (momentary)

Hardware Required: A USB-to-TTL programmer or a specialized Lishui USB programming device. 2. Open-Source Firmware (EBiCS)

For advanced users who want full control (e.g., adding Field Oriented Control or torque-sensing), the EBiCS Firmware on GitHub is the gold standard.

Hardware: Requires an ST-Link V2 programmer instead of a standard USB-TTL cable to flash the STM32-based controllers.

Customization: Offers a user-friendly GUI for setting up battery levels, speed limits, and PAS (Pedal Assist) behavior. 3. Display-Based Programming

If you just need to tweak performance without a computer, many Lishui controllers allow advanced setting access through the display: EggRider: The EggRider V2 Go to product viewer dialog for this item.

display provides a mobile app interface to adjust Lishui-specific settings like wheel size, speed limits, and PAS gain.

Manual Codes: Some models use a passcode (often 1919) in the display menu to enter advanced settings and increase the Amp output.

For a visual walkthrough of the official software installation and flashing process: Lishui Controller Program Downloader Instruction Nanjing Lishui Controller YouTube• Sep 21, 2023 I have a Lishui Controller .lsh firmware file lets mod it

IF InputRaw AND NOT InputStable THEN
  Timer(IN := TRUE, PT := T#100ms);
  IF Timer.Q THEN
    InputStable := TRUE;
  END_IF;
ELSIF NOT InputRaw THEN
  Timer(IN := FALSE);
  InputStable := FALSE;
END_IF;