Repository navigation
Releases
v5.2.0
One file. Download binmodem.exe and run it. There is nothing to install, and no Visual C++ redistributable is needed because the C runtime is linked in.
binmodem.exe a modem on a real line
binmodem.exe --devices what audio this machine has
binmodem.exe --telnet a board over a socket
binmodem.exe --capture replay the golden capture
docs/usage.md has the setup.
What's new in 5.2.0
- V.ARC compresses. A V.ARC call had no compression at all:
+DSand+DS44are about V.42, and V.ARC has its own retransmission in place of V.42. Its stream is now compressed with the best method both ends have, each direction for itself, and the window says which and what it has been worth. - LZ, a compressor of its own, in LZMA's manner: matches against the last 256 kilobytes, and everything coded by a range coder with probabilities learnt as it goes. Text goes in under a third and tables of records in about a seventh; what will not compress costs a fiftieth more. It is not LZMA's format and reads no
.lzmaor.xzfile. - V.44 and V.42bis as well, with their largest dictionaries, for whichever of
+DS44and+DSis on. AT+VARCZ=<n>: 0 for none, 1 for V.44 and V.42bis only, 2 (as it comes) for LZ as well.- The two ends agree while the call runs, with a frame an older build ignores, so a call to one of those is carried as it was. An end holds back what is written for one round trip while the far end learns where the compressed stream begins.
What's new in 5.1.0
- V.ARC/G.711. V.ARC on a SIP call in G.711, which until now quietly became an ordinary V.90 call. Between two BinModems on a direct call the 8-bit codewords arrive as they were sent, so they are the data, in both directions alike: 60 928 bit/s each way in A-law and 56 832 in mu-law, where V.90 on the same call is 56 000 down and 31 200 up. Any of the three V.ARC modes becomes it on such a call. If something on the way recodes the call, or the far end is not V.ARC, it carries on as an ordinary call after four seconds. mu-law is the slower because it has two codewords for nought that arrive as one.
- The direct modes stop spending a fifth of the line on check octets. V.ARC/L16 and V.ARC/G.711 carried forty-eight check octets a codeword, enough to rebuild a lost packet, whether or not any packet was being lost: the code rate sat at 0.80. After five seconds with nothing missing they now ask for none, and go back to the full count the moment a packet is lost. V.ARC/L16 at 48 kHz: 744 186 bit/s where it was 601 302.
- Code rates of 0.99 and 1.0 for every mode. Two check octets a codeword, and none. The receiver asks for them when the line has more in hand than its grid can use. On two virtual cables V.ARC/DMT took 0.99 and went from 404 534 to 432 941 bit/s, and V.ARC/QAM from 348 000 to 353 500. With no check octets a frame that arrives wrong is sent again, and one that does counts against the code as a failed codeword would.
- EasySip through a router, by UPnP. A tick box on the EasySip row: the router is asked for its outside address and to forward this end's two ports, the far end is told that address, and the transcript says what to give the other end. The ports close when the line does. Not used for a far end on this network. Tested as far as the router, which listed the port while it was open and not after; no call across the internet has been made with it.
What's new in 5.0.1
- V.ARC/QAM and V.ARC/PCM hold their rate. In 5.0.0 the signal to noise on a good line swung by ten to fifteen decibels every few seconds, and the two ends kept renegotiating the grid to follow it. The timing loop never settled and the equaliser was too slow to keep up with it; both are fixed. On two virtual cables the reading now moves by under half a decibel and the rate, once reached, stays.
- V.ARC/L16 shows its symbols. The diagram was empty on a linear SIP call. A sample is sixteen bits at once, and its two octets are now the two axes.
- The window says what a SIP call is carried in, in the line at the top:
L16/48000,PCMA. - EasySip chooses its coding. The fastest linear coding both ends have, any one of the eight linear codings, or G.711 in either law, which is what the ordinary modes (V.34, V.90 and the rest) are for. V.ARC/QAM and V.ARC/PCM also run on an EasySip call at 48 kHz: 270 and 305 kbit/s between two windows on one machine.
- Fixed: V.90 and V.92 on a linear SIP call at anything but 8 kHz. The digital end sent one level to a sample as it does into G.711, which at 16 kHz filled half of every packet: "gaps sent" by the hundred and a far end stuck in phase 2. It is now carried as a waveform there, as on a sound card: 56 000 down and 31 200 up between two windows on EasySip at 16 kHz stereo.
- Fixed: V.90 and V.92 on an A-law SIP call. The digital end built its levels for mu-law and said mu-law in INFO0d whatever the call was in, so on A-law every level was moved to the nearest the line had and the call came up at its lowest rate, 28 000. It is now told the call's law: 56 000 down on A-law, the same as on mu-law.
- Fixed: with the Setup row showing, an EasySip line opened from the command line was reopened with an empty address.
- Not fixed: a gap of a few milliseconds in the sound still costs V.ARC/QAM and V.ARC/PCM several seconds while the two ends renegotiate.
What's new in 5.0.0
V.ARC: a mode of our own, for a sound card and not a telephone line
No Recommendation covers this one. Both ends have to be BinModem, and both have to be this release. docs/design/v-arc.md is the design and every measurement.
- V.ARC in the mode box, or
AT+MS=VARC, then Dial and Answer as for any call. Hundreds of carriers 47 Hz apart, each given the bits its own stretch of the line will bear, from none to 24. The window opens the sound card at its own rate on both channels and the waterfall follows it out to half that rate. - Through a lead from a Realtek line output to its line input at 192 kHz: 1.4 Mbit/s, no octet wrong. A call is one signal, the same on both channels and both added together on the way in.
- V.ARC/QAM and V.ARC/PCM are one carrier and baseband levels, at a third and two-thirds of the card's sample rate in baud, so they fill its band whatever it is: 64 000 and 128 000 baud at 192 kHz, where the lead carries 1.14 Mbit/s and 972 kbit/s. Four points to sixteen million; 2PCM to 65 536PCM, of which a real line has borne 2048.
AT+VARC=<baud>,<code>,<bits>, and "by hand" in the modulation window, set the baud, the code and the grid a single-carrier call is asked for, for whoever wants to choose them.- It starts on a line it knows nothing about. The starting signal is 48 four-point symbols, each sent on every carrier in turn and added together by the receiver, so any 2.3 kHz of the band that works is enough; every carrier's noise is measured against the result and the table loads only where the line is. In simulation it starts on 300 to 3400 Hz, and on the whole band with a carrier 3 dB above its noise.
- A call starts with a handshake any line will carry: 200 bit/s in two tones a direction, in the middle of the voice band. Each end says what rates it hears and sends at, how many channels, which modulation it was asked for and whether it was told the line is two-wire, and both work out the same answer. A fast card and a slow one meet at the slow one's rate; ends told two-wire that cannot be run a wire each way and say why. The "distant" panel shows what the far end said.
- An end that cannot hear the other says so, and is sent to slower. A line can carry the modulation one way and not the other. The end that reads nothing says so in the handshake's tones, and the far end runs the modulation at half the speed, then a quarter, then an eighth, until it is read. Each direction for itself.
- Codes from 0.93 down to 0.25, chosen by the receiver with the bits. A line at 8 dB that carried nothing carries a bit a symbol.
- It has been through the air: one direction out of a monitor's loudspeakers into a webcam's microphone. The multicarrier mode carried 20 kbit/s that way and V.ARC/QAM 10 kbit/s at half speed, with nothing wrong.
- Two sound devices at two rates are a line each way. An input at 192 kHz and an output at 48 kHz run each direction at its own.
- Each end tells the other what it hears: level, peaks, samples at full scale, and Es/N0. A sender told it is reaching the far converter's stops turns itself down. The window has a Far end line for it.
- V.ARC two-wire (
AT+MS=VARC2W) is the same mode on one pair of wires, both ends sending into it, with this end's echo taken out. A canceller finds the echo and fits a filter to it; then the receiver, once it has read a symbol, takes the far end's part of it away and fits a second filter to what is left. Each end first has the line to itself for two seconds, the caller and then the answerer, so each learns its echo with nobody talking over it. Two ends sharing one virtual cable connect at 327 kbit/s, reach 384, and go on improving past 75 dB, a million octets and none wrong. It wants one sound card, input and output at one rate.VARCQ2WandVARCP2Ware the single-carrier modes the same way, by the first canceller alone: 139 kbit/s for QAM. - An ordinary call finds it, through V.8 bis.
AT+VARCBIS=1, or "list ...
v5.1.0
One file. Download binmodem.exe and run it. There is nothing to install, and no Visual C++ redistributable is needed because the C runtime is linked in.
binmodem.exe a modem on a real line
binmodem.exe --devices what audio this machine has
binmodem.exe --telnet a board over a socket
binmodem.exe --capture replay the golden capture
docs/usage.md has the setup.
What's new in 5.1.0
- V.ARC/G.711. V.ARC on a SIP call in G.711, which until now quietly became an ordinary V.90 call. Between two BinModems on a direct call the 8-bit codewords arrive as they were sent, so they are the data, in both directions alike: 60 928 bit/s each way in A-law and 56 832 in mu-law, where V.90 on the same call is 56 000 down and 31 200 up. Any of the three V.ARC modes becomes it on such a call. If something on the way recodes the call, or the far end is not V.ARC, it carries on as an ordinary call after four seconds. mu-law is the slower because it has two codewords for nought that arrive as one.
- The direct modes stop spending a fifth of the line on check octets. V.ARC/L16 and V.ARC/G.711 carried forty-eight check octets a codeword, enough to rebuild a lost packet, whether or not any packet was being lost: the code rate sat at 0.80. After five seconds with nothing missing they now ask for none, and go back to the full count the moment a packet is lost. V.ARC/L16 at 48 kHz: 744 186 bit/s where it was 601 302.
- Code rates of 0.99 and 1.0 for every mode. Two check octets a codeword, and none. The receiver asks for them when the line has more in hand than its grid can use. On two virtual cables V.ARC/DMT took 0.99 and went from 404 534 to 432 941 bit/s, and V.ARC/QAM from 348 000 to 353 500. With no check octets a frame that arrives wrong is sent again, and one that does counts against the code as a failed codeword would.
- EasySip through a router, by UPnP. A tick box on the EasySip row: the router is asked for its outside address and to forward this end's two ports, the far end is told that address, and the transcript says what to give the other end. The ports close when the line does. Not used for a far end on this network. Tested as far as the router, which listed the port while it was open and not after; no call across the internet has been made with it.
What's new in 5.0.1
- V.ARC/QAM and V.ARC/PCM hold their rate. In 5.0.0 the signal to noise on a good line swung by ten to fifteen decibels every few seconds, and the two ends kept renegotiating the grid to follow it. The timing loop never settled and the equaliser was too slow to keep up with it; both are fixed. On two virtual cables the reading now moves by under half a decibel and the rate, once reached, stays.
- V.ARC/L16 shows its symbols. The diagram was empty on a linear SIP call. A sample is sixteen bits at once, and its two octets are now the two axes.
- The window says what a SIP call is carried in, in the line at the top:
L16/48000,PCMA. - EasySip chooses its coding. The fastest linear coding both ends have, any one of the eight linear codings, or G.711 in either law, which is what the ordinary modes (V.34, V.90 and the rest) are for. V.ARC/QAM and V.ARC/PCM also run on an EasySip call at 48 kHz: 270 and 305 kbit/s between two windows on one machine.
- Fixed: V.90 and V.92 on a linear SIP call at anything but 8 kHz. The digital end sent one level to a sample as it does into G.711, which at 16 kHz filled half of every packet: "gaps sent" by the hundred and a far end stuck in phase 2. It is now carried as a waveform there, as on a sound card: 56 000 down and 31 200 up between two windows on EasySip at 16 kHz stereo.
- Fixed: V.90 and V.92 on an A-law SIP call. The digital end built its levels for mu-law and said mu-law in INFO0d whatever the call was in, so on A-law every level was moved to the nearest the line had and the call came up at its lowest rate, 28 000. It is now told the call's law: 56 000 down on A-law, the same as on mu-law.
- Fixed: with the Setup row showing, an EasySip line opened from the command line was reopened with an empty address.
- Not fixed: a gap of a few milliseconds in the sound still costs V.ARC/QAM and V.ARC/PCM several seconds while the two ends renegotiate.
What's new in 5.0.0
V.ARC: a mode of our own, for a sound card and not a telephone line
No Recommendation covers this one. Both ends have to be BinModem, and both have to be this release. docs/design/v-arc.md is the design and every measurement.
- V.ARC in the mode box, or
AT+MS=VARC, then Dial and Answer as for any call. Hundreds of carriers 47 Hz apart, each given the bits its own stretch of the line will bear, from none to 24. The window opens the sound card at its own rate on both channels and the waterfall follows it out to half that rate. - Through a lead from a Realtek line output to its line input at 192 kHz: 1.4 Mbit/s, no octet wrong. A call is one signal, the same on both channels and both added together on the way in.
- V.ARC/QAM and V.ARC/PCM are one carrier and baseband levels, at a third and two-thirds of the card's sample rate in baud, so they fill its band whatever it is: 64 000 and 128 000 baud at 192 kHz, where the lead carries 1.14 Mbit/s and 972 kbit/s. Four points to sixteen million; 2PCM to 65 536PCM, of which a real line has borne 2048.
AT+VARC=<baud>,<code>,<bits>, and "by hand" in the modulation window, set the baud, the code and the grid a single-carrier call is asked for, for whoever wants to choose them.- It starts on a line it knows nothing about. The starting signal is 48 four-point symbols, each sent on every carrier in turn and added together by the receiver, so any 2.3 kHz of the band that works is enough; every carrier's noise is measured against the result and the table loads only where the line is. In simulation it starts on 300 to 3400 Hz, and on the whole band with a carrier 3 dB above its noise.
- A call starts with a handshake any line will carry: 200 bit/s in two tones a direction, in the middle of the voice band. Each end says what rates it hears and sends at, how many channels, which modulation it was asked for and whether it was told the line is two-wire, and both work out the same answer. A fast card and a slow one meet at the slow one's rate; ends told two-wire that cannot be run a wire each way and say why. The "distant" panel shows what the far end said.
- An end that cannot hear the other says so, and is sent to slower. A line can carry the modulation one way and not the other. The end that reads nothing says so in the handshake's tones, and the far end runs the modulation at half the speed, then a quarter, then an eighth, until it is read. Each direction for itself.
- Codes from 0.93 down to 0.25, chosen by the receiver with the bits. A line at 8 dB that carried nothing carries a bit a symbol.
- It has been through the air: one direction out of a monitor's loudspeakers into a webcam's microphone. The multicarrier mode carried 20 kbit/s that way and V.ARC/QAM 10 kbit/s at half speed, with nothing wrong.
- Two sound devices at two rates are a line each way. An input at 192 kHz and an output at 48 kHz run each direction at its own.
- Each end tells the other what it hears: level, peaks, samples at full scale, and Es/N0. A sender told it is reaching the far converter's stops turns itself down. The window has a Far end line for it.
- V.ARC two-wire (
AT+MS=VARC2W) is the same mode on one pair of wires, both ends sending into it, with this end's echo taken out. A canceller finds the echo and fits a filter to it; then the receiver, once it has read a symbol, takes the far end's part of it away and fits a second filter to what is left. Each end first has the line to itself for two seconds, the caller and then the answerer, so each learns its echo with nobody talking over it. Two ends sharing one virtual cable connect at 327 kbit/s, reach 384, and go on improving past 75 dB, a million octets and none wrong. It wants one sound card, input and output at one rate.VARCQ2WandVARCP2Ware the single-carrier modes the same way, by the first canceller alone: 139 kbit/s for QAM. - An ordinary call finds it, through V.8 bis.
AT+VARCBIS=1, or "list V.ARC" under the V.8 bis switch, puts V.ARC in the non-standard field of the V.8 bis capabilities. Two BinModems that both list it choose it there and go to V.ARC's handshake in place of V.8; with a far end that does not, or is not BinModem, the call is what it would have been. Between two windows on two virtual cables, each set to V.92: 404 kbit/s, and 164 kbit/s with noise added at -55 dBFS. The country and provider codes in the block are made up, not registered. - Over SIP, the call carries sixteen-bit samples exactly, the samples are the data, and the rate is the sample rate: 601 kbit/s at 48 kHz, 200 kbit/s at 16 kHz.
SIP: linear PCM at every rate, and EasySip














