update readme and examples

Author: BeanRepo

src/arduino/app_bricks/wave_generator/README.md

@@ -195,11 +195,17 @@ Change the waveform type.
 **Parameters:**
 - `wave_type`: One of "sine", "square", "sawtooth", "triangle"
 
-#### `set_volume(volume: float)`
-Set master volume level.
+#### `set_volume(volume: int)`
+Set hardware speaker volume level.
 
 **Parameters:**
-- `volume`: Master volume in range [0.0, 1.0]
+- `volume`: Hardware volume level (0-100)
+
+#### `get_volume() -> int`
+Get current hardware speaker volume level.
+
+**Returns:**
+- Current hardware volume level (0-100)
 
 #### `set_envelope_params(attack=None, release=None, glide=None)`
 Update envelope parameters.
@@ -213,7 +219,7 @@ Update envelope parameters.
 Get current generator state.
 
 **Returns:**
-- Dictionary with keys: `frequency`, `amplitude`, `wave_type`, `master_volume`, `phase`
+- Dictionary with keys: `frequency`, `amplitude`, `wave_type`, `volume`, `phase`
 
 ## Waveform Types
 
@@ -287,7 +293,7 @@ Time to smoothly transition from current frequency to target frequency.
 ### No Sound Output
 - Check USB speaker is connected and powered
 - Verify amplitude is > 0: `wave_gen.set_amplitude(0.5)`
-- Check master volume: `wave_gen.set_volume(0.8)`
+- Check hardware volume: `wave_gen.set_volume(80)`
 
 ### Choppy or Clicking Audio
 - Increase glide time: `wave_gen.set_envelope_params(glide=0.05)`

src/arduino/app_bricks/wave_generator/examples/01_basic_tone.py

@@ -25,7 +25,7 @@
 # Set initial frequency and amplitude
 wave_gen.set_frequency(440.0)  # A4 note (440 Hz)
 wave_gen.set_amplitude(0.7)  # 70% amplitude
-wave_gen.set_volume(0.8)  # 80% master volume
+wave_gen.set_volume(80)  # 80% hardware volume
 
 print("Playing 440Hz sine wave (A4 note)")
 print("Press Ctrl+C to stop")

src/arduino/app_bricks/wave_generator/examples/04_musical_scale.py

@@ -33,7 +33,7 @@
 )
 
 App.start_brick(wave_gen)
-wave_gen.set_volume(0.7)
+wave_gen.set_volume(70)
 
 
 def play_scale():

src/arduino/app_bricks/wave_generator/examples/05_envelope_control.py

@@ -17,7 +17,7 @@
 App.start_brick(wave_gen)
 
 wave_gen.set_frequency(440.0)
-wave_gen.set_volume(0.8)
+wave_gen.set_volume(80)
 
 
 def envelope_demo():