Imaginous / Cowboy_Untamed

An Android app to lift the speed limit of your Cowboy Bike.
182 stars 55 forks source link

LEGAL NOTICE

!!! USE THIS APPLICATION AT YOUR OWN RISK

!!! I do not accept any liability.

!!! Unlocking your bike will make your bike illegal in most countries, atleast in the European Union.

!!! It will void your warranty according to point 8.7 in Cowboys warranty agreement:

Any alteration or transformation of the product, including using a third-party application to modify or adjust motor controller settings, even on a single occasion, will result in the complete voidance of the product warranty, not only for issues caused by the third-party app but for any other issues that may arise during the warranty period.

!!! Note: 20230420 - Cowboy has officially denied warranty after use of Untamed (or Unleashed/Cowbooster).

Cowboy Untamed

An Android app to remove the speed limit of your Cowboy V1+, V2, V3, V4, V4ST bike, make it faster and other tweaks to make the bike even better.
You can also use presets to make it slower and conserve battery.
Use your wear OS watch (Galaxy watch 4 & 5 for example) to control your Cowboy through Untamed.

Untamed is partially working with the latest C4/C4ST "Adaptive Power" firmware. Field weakening seems to give issues. Removing the speed limit does work.

Other cool Cowboy stuff: Click here for my Cowboy hardware customizations.

IOS information: This app will not become available for IOS, but you can use the IOS manual hack or use Cowboy Unleashed made by a fellow Cowboy and programmer.

Klik hier voor een beknopte Nederlandse uitleg.

Warning: Adaptive Power 2.0 (v4.21.0)

It seems Adaptive Power 2.0 resets / overwrites the motor controller settings. Upgrading to this firmware may render the hack unusable.
Untamed is not compatible with the latest firmware. Setting Untamed speed limit removal settings will result in powerloss after a complete stop. Remove the Untamed settings to restore normal functionality.

Download

Latest release 2023-04-01
Direct download Android: Cowboy Untamed V3.63
Latest release: Untamed phone app
Latest release: Untamed watch app - Click here for more info
Version information: Version overview

Short PDF summary: UnlockYourCOWBOY.pdf Provided by fellow Cowboy Metin

Donate

If you like the app or the IOS instructions you're free to make a small donation.
You can do this securely via:

You're free to choose any amount you like.

Get a free bike rack and stand on your new Cowboy bike

If you don't have a Cowbow bike yet... use this refferal link for a free bike rack and stand on your new bike.
Sometimes the link just brings you to the Cowboy main page. If this happens use the "browse in private" mode of your browser. Other option is to erase your cookies.

Join #Untamed

Join the #Untamed group in the official Cowboy app.
Click here to join

Introduction

Main Features:

Quick Launch Presets in V3.xx:

Screenshot main app Screenshot expert page Screenshot quick launch presets Screenshot shortcuts main app Screenshot shortcuts presets app

This app is created as a hobby project. I love electronics and programming and just could not resist if I could get more out of my Cowboy V1+ bike.

This is where I started finding out how the Cowboy bikes work. Which electronics they use and how the electronics communicate internally and with the outside world. I posted on Reddit and it got more attention then I had anticipated.

So use this app to remove the speed limit and enjoy your Cowboy even more!

Special thanks go to Runereader for making his Bronco code open source. This is my first Android app, pure hobby, so it is "as is".

Installation

You must allow installation from unknown sources to install the Cowboy Untamed APK file.

Now you should be able to download and install the APK file.

For security reasons I recommend to disable this option after installing.

Note: Since some users buy a second hand Android phone just to use this app, make sure you have Android version 7.1.1 or higher.

Usage

This app can disable the speed limit of your Cowboy V1/2/3 bike. For V1+ owners, you can now enable the 'Auto Unlock' function normally only available on V2 and V3 bikes. When you only disable the speed limit you will be able to get up to 29km/h. At this point the motor magnetic field flux will start working against you. You can overcome this effect by using field weakening. A drawback of field weakening is the fact that it costs extra current, so your battery will be depleted faster.

I recommend a field weakening value of 15%. More then 20% would be inefficient and might cause damage to the motor. ASI advices a maximum of 25%, therefore the app is limited to 25%.

For those who do not want to write the settings "persistantly" to their motor controller, use the "Quick Launch Presets" instead.
If you use your bike regularly for, let's say, commuting I would recommend the procedure below for a set and forget approach. This way you only have to use the original Cowboy App after making the changes you want.

My current favorite V1+ settings:

For me the sweetspot between excercise and still going fast came up with the following settings:

Restoring default settings

Use the same method as above, but entering the values you have written down on first use. Alternative method using my hardcoded defaults, unlock following the above mentioned procedure.

Quick Launch Presets

With this new feature (and second app icon) you can setup three presets (Slow, Normal, Fast) and quickly unlock your bike with one of these presets. Just long press the Cowboy Untamed Presets app icon and select one of the three presets. Clicking the Cowboy Untamed Presets app icon will unlock the bike with the last used preset. These presets are not stored in flash and will be reset after locking your bike.
A major drawback is that you always have to load the preset manually for each ride.

For more information about the configuration read: Configuring Presets.
Note: do not use the FLASH button in the main app while a preset is active. This will store the preset settings in flash memory.

Dashboard

With this function you can switch between Normal and Untamed mode with the push of a button. Also you can adjust the field weakening value on the go.
But the best feature is the option to set the maximum power output of the motor on the fly. You can see this as a way to set the level of support of the bike.
You'll find the dashboard in the main menu (version 3.50 and up).

Screenshot dashboard

Watch app

With the introduction of V3.60 of Untamed you can also sideload my new watch app onto your Wear OS device. I use a Samsung Galaxy Watch 5. For more information go to: How to install and configure the watch app.

Auto Unlock (V1+)

I can confirm Auto Unlock is atleast working up to firmware V4.8.17 (V1+).
Note: after locking the bike has a grace period of a few minutes before enabling Auto Unlock after it's locked. Also your phone must been out of reach of the bike. For testing you can temporarely disable bleutooth.

The way to get it working:

Screenshot Cowboy App Auto Unlock Auto Unlock Bike

Known general Cowboy issues

There are some PCB and motor controller related issues that many Cowboys experience. Here are some workarounds in which Cowboy Untamed can help.

Broken torque sensor

You can use Untamed to check if your torque sensor might be faulty.

If everything went well you should end up with two voltages. For my C1+ I read a Torque Voltage Offset of 0.80 volts. This is a defined value by Cowboy for my bike.
If I compare it with the Throttle Voltage of 0.79 volts on my C1+ I can conclude my sensor is fine.
The difference between the two voltages must be in range of +/- 0.02 volts. In my case between 0.78-0.82 volts.

Expected voltages:

If there is a larger voltage difference or the Throttle Voltage is way off, like 0 or sky high. There is a likely chance the torque sensor is broken.

Important note: It seems on some C3 bikes the throttle offset has been programmed with the wrong value. If you read a throttle voltage of 0.50-0.55 your sensor is probably okay.
On the C2 and C3 check the cable connector on the right side of the bike running to the back wheel. Try replugging it. It might be bad contacts.
On the C1+, C4 and C4ST you can't access the cables (without removing parts). But it is less likely to be a loose connection on these bikes.

Screenshot address 182 Screenshot address 270

The bike judders at start

If your bike judders you may alter the 'Hall Interpolation Transitions' field of the motor controller. This field 128. Default this has a value of 1 (note: on some bikes this has been altered by Cowboy already). This means the timing of the motor will be measured after 1 full rotation of the wheel. So the motor 'understands' when to kick in. If this is not measured correctly the motor kicks in at the wrong moment and will judder. By increasing this value more rotations will be used and the value will be more accurate, so no judder.

You can alter this value on the Expert Settings page. Enter addres 128 and read the current value. Note the RAW value somewhere, this way you can always revert to this value. Enter the desired RAW value, 8 and 15 are often used. Press write. You can now test your bike. If it functions well return to the main page of Cowboy Untamed and press the Flash button to make the change 'permanent'.

Note of warning: if you are using the 'Bronco' app there is a setting called 'Initial Torque'. This might sounds like you get more torque at startup. But infact is only chanching the 'Hall Interpolation Transitions' register.

V1+ Headlight bug

A bug on the V1+ is a non working headlight, the taillight still works.
Can it be fixed? With the Cowboy Untamed app you can reset your PCB. This will not reset any settings but only reboot the communications PCB. 9 out of 10 times the headlight bug will be fixed (for a while). There is no fix from Cowboy yet.
Connect to your bike with the Cowboy Untamed app. Go to the Expert Settings and press the Reset PCB button. This will reboot the bike, shown by "running lights" on the main tube LEDs.
Note: It seems firmware V4.8.17 makes the headlight more reliable on the V1+.

No or quirky bluetooth connection

With the Cowboy Untamed app you can reset your PCB. This will not reset any settings but only reboot the communications PCB. This might fix connection or communication problems.
Connect to your bike with the Cowboy Untamed app. Select Reset PCB (Fix headlight bug) from the menu. This will reboot the bike, shown by "running lights" on the main tube LEDs.

The future

I think there is a quite solid base now for the future. Offcourse removing the speed limit was my main goal. Second I wanted to make shortcuts which I could use via Tasker.
I have discussed with other bikers and some of us would like to be able to set the support level. When you want to ride along with a non e-biker the support should be a lot less. The idea is to make speed dependant support. Let's say 0-10km/h you get the current support, 11-22km/h low to no support, 23->km/h regular untamed support. The levels can be set by the user. You can activate them via a long press shortcut.

These are ideas. I'm now ready to start exploring how to. I believe it can be done, but I want to do some serious testing with my own bike before I release it into the wild.

2021-05-29: Finally some nice weather. I did some testing this morning. At his point I made the following discoveries:

2021-06-03: i did some more research and testing. I found a second setting which is interesting. I can adjust the maximum voltage range of the torque sensor. By raising this you have to peddle harder (get less assistance). This setting can be handy to put in a bit more effort yourself and spare battery power.

2021-06-08: A pre-release version of the Quick launch Presets.

The following whishes have popped up from users:

User wishlist

Cowboy 4(ST)

2021-12-21: Good news, Cowboy untamed still works for the Cowboy 4(ST).
A fellow Cowboy was brave enough ;) to test it. It all seems to work fine. It seems they are using an ASI BAC500 controller. This one is compatible with my app.
2021-10-30: Today I found some registers in the new Cowboy app pointing at a C4 feature. Turning the phone charger on/off. This could mean that the main controller uses the same protocol.
Not yet sure about the motor controller, which is the most important part.

FAQ