# 🎉 SoftCSA for Enigma2 - Preview Test Started!

## What is SoftCSA?

SoftCSA provides Enigma2 with native software descrambling capability for channels using **Algorithm 3 (CSA-ALT)** encryption. These channels cannot be descrambled by the receiver's hardware descrambling unit and previously required the **StreamRelay workaround** via OSCam.

SoftCSA integrates descrambling directly into Enigma2 – the encrypted transport stream is received, descrambled in software, and seamlessly passed to the decoders. The result: faster channel switching, better performance, and full feature support.

---

## What Does SoftCSA Offer?

### ✅ Advantages over StreamRelay

| Feature | StreamRelay | SoftCSA |
|---------|-------------|---------|
| Channel Switching | Delayed (HTTP overhead) | Fast (direct) |
| Timeshift | Limited | Fully functional |
| Recordings | Complicated | Like normal channels |
| Multi-Tuner | Consumes capacity | No additional overhead |
| Audio Track Selection | Problematic | Works normally |
| EPG/Subtitles | Partially broken | Complete |
| FCC | Not possible | Supported |

### 🔧 Technical Highlights

- **Transparent Integration**: For the user, a SoftCSA channel behaves like any other channel
- **Automatic Detection**: OSCam reports the algorithm, Enigma2 activates SoftCSA as needed
- **Hardware Decoder**: The box's AV decoder continues to be used – only descrambling is done in software
- **Cross-Platform**: Tested on Broadcom, HiSilicon, and AMLogic chipsets
- **System Information**: SoftCSA status is displayed in Enigma2 system information
- **Skin Integration**: Optionally, a "SoftCSA" indicator can be displayed in the infobar

---

## FAQ – Frequently Asked Questions

### What exactly is this?

SoftCSA is a software descrambling implementation directly in Enigma2. For channels with CSA-ALT encryption (Algorithm 3), Enigma2 handles the descrambling itself instead of taking the detour via OSCam StreamRelay.

### Why does this make sense?

- **No StreamRelay Overhead**: No more double HTTP connection
- **Direct Descrambling** of the AV stream in the Enigma2 process
- **Better Performance** for channel switching and timeshift
- **Fewer Interruptions** and more stable playback
- **Full Recording Functionality** – recordings are also playable on PC
- **FCC Support** – Fast Channel Change works

### What do I need?

1. **Compatible Box** – Your box must be listed here:
   → https://images.mynonpublic.com/openatv/build_status_devel76.html

2. **Current OpenATV 7.6 Image** (from 15.12.2025) with Preview Feed enabled:
   ```bash
   wget -O - -q https://feeds2.mynonpublic.com/devel-feed | bash
   ```

3. **OSCam-Master** from Secret Feed (latest version with `WITH_EXTENDED_CW`):
   ```bash
   opkg install oscam-master
   ```

4. **libdvbcsa Library** (automatically installed with oscam-master):
   ```bash
   opkg install libdvbcsa1
   ```

### What settings need to be configured?

#### 1. Disable StreamRelay for affected channels

- Select channel in channel list → "Play channel without StreamRelay"
- **Or:** Rename/delete the file `/etc/enigma2/whitelist_streamrelay`

#### 2. Adjust OSCam configuration

In the `[dvbapi]` section of `oscam.conf`:
```
pmt_mode = 6
extended_cw_api = 1
```

Alternatively via OSCam WebIF under Config → DVBApi.

#### 3. Verification

When the following entry appears in the OSCam log, everything is configured correctly:
```
2025/12/17 21:09:34 c (dvbapi) Client connected: 'Enigma2' (protocol version = 3)
```

The `protocol version = 3` shows that Enigma2 is connected with Extended CW Support.

### How do I know if SoftCSA is active/available?

- **System Information**: Under Menu → Information → System Information, it shows whether SoftCSA is enabled in the image
- **OSCam Log**: Software descrambling is logged for SoftCSA channels
- **Skin Infobar**: Optionally, a "SoftCSA" indicator can be displayed (see skin customization below)

### Do recordings and timeshift work?

**Yes!** This was one of the main development goals:
- Recordings are stored correctly descrambled
- Timeshift works like with normal channels
- Recordings are also playable in VLC and other players on PC
- **FCC (Fast Channel Change)** is also supported

### Which boxes are supported?

The implementation has been tested on the following chipsets:
- **Broadcom** BCM7252S, BCM7278, BCM73625 (VU+, Mut@nt, etc.)
- **HiSilicon** Hi3798MV200 (Octagon, AB-COM Pulse, etc.)
- **AMLogic** (DreamOne, DreamTwo)

The complete list of supported boxes can be found in the BuildStatus link above.

### Skin Integration: SoftCSA Display

If you want to display an icon in your infobar when SoftCSA is active, you can use the following skin code:

```xml
<widget alphatest="blend" pixmap="icons/ico_softcsa.png" position="1800,1004" render="Pixmap" size="56,35" source="session.CurrentService" zPosition="3">
    <convert type="ServiceInfo">IsSoftCSA</convert>
    <convert type="ConditionalShowHide"/>
</widget>
```

The icon must be present in the skin directory under `icons/ico_softcsa.png`. Position and size can be adjusted to match your skin.

---

## Known Limitations / Notes

- **Only SoftCSA (CSA-ALT)**: Other encryption types continue to be handled as usual
- **OSCam Required**: Key provision still occurs via OSCam – only the descrambling itself runs in Enigma2
- **Preview Status**: This is a test build – feedback is explicitly welcome!

---

## Problems? Feedback?

Please test extensively and report:
- Which box / which chipset
- Which channel / which bouquet position
- What exactly doesn't work
- Debug logs if possible (with Enigma2 debug enabled)

We welcome every tester and all feedback!

---

**Have fun testing!** 🛰️📺