feat: Adding support for Bananasome Rocket X7

Author: blackspherefollower

buttplug/buttplug-device-config/build-config/buttplug-device-config-v3.json

@@ -18199,6 +18199,63 @@
           }
         }
       ]
+    },
+    "bananasome": {
+      "defaults": {
+        "name": "Bananasome Rocket X7",
+        "features": [
+          {
+            "feature-type": "Oscillate",
+            "actuator": {
+              "step-range": [
+                0,
+                255
+              ],
+              "messages": [
+                "ScalarCmd"
+              ]
+            }
+          },
+          {
+            "feature-type": "Vibrate",
+            "actuator": {
+              "step-range": [
+                0,
+                255
+              ],
+              "messages": [
+                "ScalarCmd"
+              ]
+            }
+          },
+          {
+            "feature-type": "Vibrate",
+            "actuator": {
+              "step-range": [
+                0,
+                255
+              ],
+              "messages": [
+                "ScalarCmd"
+              ]
+            }
+          }
+        ]
+      },
+      "communication": [
+        {
+          "btle": {
+            "names": [
+              "火箭X7"
+            ],
+            "services": {
+              "0000ae00-0000-1000-8000-00805f9b34fb": {
+                "tx": "0000ae01-0000-1000-8000-00805f9b34fb"
+              }
+            }
+          }
+        }
+      ]
     }
   }
 }

buttplug/buttplug-device-config/device-config-v3/buttplug-device-config-v3.yml

@@ -10435,4 +10435,36 @@ protocols:
             - LOOB
           services:
             b75c49d2-04a3-4071-a0b5-35853eb08307:
-              tx: ba5c49d2-04a3-4071-a0b5-35853eb08307
+              tx: ba5c49d2-04a3-4071-a0b5-35853eb08307
+  bananasome:
+    defaults:
+      name: Bananasome Rocket X7
+      features:
+        - feature-type: Oscillate
+          actuator:
+            step-range:
+              - 0
+              - 255
+            messages:
+              - ScalarCmd
+        - feature-type: Vibrate
+          actuator:
+            step-range:
+              - 0
+              - 255
+            messages:
+              - ScalarCmd
+        - feature-type: Vibrate
+          actuator:
+            step-range:
+              - 0
+              - 255
+            messages:
+              - ScalarCmd
+    communication:
+      - btle:
+          names:
+            - 火箭X7
+          services:
+            0000ae00-0000-1000-8000-00805f9b34fb:
+              tx: 0000ae01-0000-1000-8000-00805f9b34fb

buttplug/src/server/device/protocol/bananasome.rs

@@ -0,0 +1,61 @@
+// Buttplug Rust Source Code File - See https://buttplug.io for more info.
+//
+// Copyright 2016-2025 Nonpolynomial Labs LLC. All rights reserved.
+//
+// Licensed under the BSD 3-Clause license. See LICENSE file in the project root
+// for full license information.
+
+use crate::{
+  core::{
+    errors::ButtplugDeviceError,
+    message::{
+      ActuatorType,
+      ActuatorType::{Oscillate, Vibrate},
+      Endpoint,
+    },
+  },
+  server::device::{
+    hardware::{HardwareCommand, HardwareWriteCmd},
+    protocol::{generic_protocol_setup, ProtocolHandler},
+  },
+};
+
+generic_protocol_setup!(Bananasome, "bananasome");
+
+#[derive(Default)]
+pub struct Bananasome {}
+
+impl ProtocolHandler for Bananasome {
+  fn keepalive_strategy(&self) -> super::ProtocolKeepaliveStrategy {
+    super::ProtocolKeepaliveStrategy::RepeatLastPacketStrategy
+  }
+
+  fn needs_full_command_set(&self) -> bool {
+    true
+  }
+  fn handle_scalar_cmd(
+    &self,
+    commands: &[Option<(ActuatorType, u32)>],
+  ) -> Result<Vec<HardwareCommand>, ButtplugDeviceError> {
+    Ok(vec![HardwareWriteCmd::new(
+      Endpoint::Tx,
+      vec![
+        0xa0,
+        0x03,
+        commands[0].unwrap_or((Oscillate, 0)).1 as u8,
+        if commands.len() > 1 {
+          commands[1].unwrap_or((Vibrate, 0)).1
+        } else {
+          0
+        } as u8,
+        if commands.len() > 2 {
+          commands[2].unwrap_or((Vibrate, 0)).1
+        } else {
+          0
+        } as u8,
+      ],
+      false,
+    )
+    .into()])
+  }
+}

buttplug/src/server/device/protocol/mod.rs

@@ -18,6 +18,7 @@ pub mod adrienlastic;
 pub mod amorelie_joy;
 pub mod aneros;
 pub mod ankni;
+pub mod bananasome;
 pub mod buttplug_passthru;
 pub mod cachito;
 pub mod cowgirl;
@@ -234,6 +235,10 @@ pub fn get_default_protocol_map() -> HashMap<String, Arc<dyn ProtocolIdentifierF
     amorelie_joy::setup::AmorelieJoyIdentifierFactory::default(),
   );
   add_to_protocol_map(&mut map, aneros::setup::AnerosIdentifierFactory::default());
+  add_to_protocol_map(
+    &mut map,
+    bananasome::setup::BananasomeIdentifierFactory::default(),
+  );
   add_to_protocol_map(
     &mut map,
     buttplug_passthru::setup::ButtplugPassthruIdentifierFactory::default(),

buttplug/tests/test_device_protocols.rs

@@ -123,6 +123,7 @@ async fn load_test_case(test_file: &str) -> DeviceTestCase {
 #[test_case("test_fleshy_thrust_protocol.yaml" ; "Fleshy Thrust Sync Protocol")]
 #[test_case("test_nexus_revo.yaml" ; "Nexus Revo Protocol")]
 #[test_case("test_luvmazer_protocol.yaml" ; "Luvmazer Protocol")]
+#[test_case("test_bananasome_protocol.yaml" ; "Bananasome Protocol")]
 #[tokio::test]
 async fn test_device_protocols_embedded_v3(test_file: &str) {
   //tracing_subscriber::fmt::init();
@@ -236,6 +237,7 @@ async fn test_device_protocols_embedded_v3(test_file: &str) {
 #[test_case("test_fleshy_thrust_protocol.yaml" ; "Fleshy Thrust Sync Protocol")]
 #[test_case("test_nexus_revo.yaml" ; "Nexus Revo Protocol")]
 #[test_case("test_luvmazer_protocol.yaml" ; "Luvmazer Protocol")]
+#[test_case("test_bananasome_protocol.yaml" ; "Bananasome Protocol")]
 #[tokio::test]
 async fn test_device_protocols_json_v3(test_file: &str) {
   //tracing_subscriber::fmt::init();

buttplug/tests/util/device_test/device_test_case/test_bananasome_protocol.yaml

@@ -0,0 +1,62 @@
+devices:
+  - identifier: 
+      name: "火箭X7"
+    expected_name: "Bananasome Rocket X7"
+device_commands:
+  - !Messages
+      device_index: 0
+      messages:
+        - !Vibrate
+          - Index: 0
+            Speed: 0.5
+  - !Commands
+      device_index: 0
+      commands:
+        - !Write
+            endpoint: tx
+            data: [0xa0, 0x03, 0x00, 0x80, 0x00]
+            write_with_response: false
+  - !Messages
+      device_index: 0
+      messages:
+        - !Vibrate
+          - Index: 1
+            Speed: 0.5
+  - !Commands
+      device_index: 0
+      commands:
+        - !Write
+            endpoint: tx
+            data: [0xa0, 0x03, 0x00, 0x80, 0x80]
+            write_with_response: false
+  - !Messages
+      device_index: 0
+      messages:
+        - !Scalar
+          - Index: 0
+            Scalar: 0.75
+            ActuatorType: Oscillate
+          - Index: 1
+            Scalar: 0.75
+            ActuatorType: Vibrate
+          - Index: 2
+            Scalar: 0.25
+            ActuatorType: Vibrate
+  - !Commands
+      device_index: 0
+      commands:
+        - !Write
+            endpoint: tx
+            data: [0xa0, 0x03, 0xc0, 0xc0, 0x40]
+            write_with_response: false
+  - !Messages
+      device_index: 0
+      messages:
+        - !Stop
+  - !Commands
+      device_index: 0
+      commands:
+        - !Write
+            endpoint: tx
+            data: [0xa0, 0x03, 0x00, 0x00, 0x00]
+            write_with_response: false